layered-resource-rails 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd456a360f63f94c4c38e833251b2d4b22a20c7df76b2b78612d9baf55135e9c
-  data.tar.gz: 783f255e36a42959f5565862cf2354d5a57cb1ec5e2d98fbf281477613446c43
+  metadata.gz: 4560cdb00f90fd031ddb92e6a472e8b72e375c929864a36f013206f59abfa21a
+  data.tar.gz: b9b93f938d7448c751e9a78b66ff9f23ea174f72e6feec1c67752309bf3f8acb
 SHA512:
-  metadata.gz: e29f1a82da384c20cf1d2b99793fedd5079d129a3767cd0c18ba81a55b41b4cf7621c9d0528d992239dc75480607ec0702bb6c70f2562660bb5a063d4faa33d6
-  data.tar.gz: 6b144d42bb808d4ef5cab32ed5119ec6a976046e4dd82b9d3fac221c2aacfd2015985f0428f1011493a2bd46289e75876b44bce62e1c69b2f22cb42f0c2e1ff7
+  metadata.gz: 2e49ac83a4e70bcb16a51eee140652eb9331c856bd5664bad52955474cbb523ee2d78faf7146ef80aa66b78f2ae6e312ac9d733a099deb34dea4b0b2ccb6be76
+  data.tar.gz: 34c074eb474d6aa7aac0c0e9bc24f2feb334023ec6787fc11ea6d7a2c357147a72c258348244051fb60aeff0965b7be1cec0b4693994e52371b0ed96d06334f8

data/.claude/skills/layered-resource-rails/SKILL.md

@@ -309,7 +309,7 @@ When enabled:
 
 - `scope(controller)` defaults to the controller's `policy_scope(model)` helper, so apps that override `pundit_user` (e.g. `current_account`) get the same identity used by `authorize`.
 - The controller calls `authorize(@record)` after loading a member record (show/edit/update/destroy and any custom member action).
-- The `New`/`Edit`/`Delete` actions in the default views (inline buttons on show, a per-row actions popover menu on index, in a column pinned to the right edge via `l_ui_table`'s `floating_actions:`) hide for users whose policy denies the action - the views call a `resource_can?(action, record = nil)` helper that ANDs the route-exposure flag with `policy(record).<action>?`.
+- The `New`/`Edit`/`Delete` actions in the default views (inline buttons on show, a per-row actions popover menu on index, in a column pinned to the right edge via `l_ui_table`'s `floating_actions:`) hide for users whose policy denies the action - the views call a `resource_can?(action, record = nil)` helper that ANDs the route-exposure flag with `policy(record).<action>?`. A resource's own `_row_actions` partial replaces the index menu's checks, so it must call `resource_can?` itself (see Row actions).
 
 `owned_by` composes with `use_pundit`: Pundit's `Policy::Scope#resolve` wins for the read filter; `owned_by` still drives owner assignment on create. Stack both when needed.
 
@@ -344,6 +344,17 @@ end
 
 Drop a partial at `app/views/layered/<resource>/_introduction.html.erb` to render content above the search area on that resource's index page. The partial is rendered when present and skipped otherwise — no DSL, no configuration. It uses the same per-resource view path as ejected templates and column overrides.
 
+## Row actions
+
+Each index row's popover menu holds whatever the `_row_actions` partial renders for that record. The default renders `Edit`/`Delete`, gated by `resource_can?(action, record)`. For a menu that varies per record or per user (a role-dependent "Members"/"Settings"/"Leave", say), drop `app/views/layered/<resource>/_row_actions.html.erb` - **don't eject the whole index for this**; the override keeps search, filters, sort and pagination.
+
+- Locals: `record`. Full view context: `current_user`, host path helpers, `layered_member_path`, `resource_can?`.
+- Render items only (the index wraps them in the popover): class `l-ui-popover__menu-item` (`--danger` for destructive), `<hr class="l-ui-popover__menu-divider">` between groups, `data: { turbo_frame: "_top" }` on each. Use `button_to ..., method: :delete` for non-GET actions.
+- Empty output for a row means no menu on that row.
+- The override replaces the default's gating - wrap any kept Edit/Delete in `resource_can?` so `only:` and Pundit still apply.
+- The index renders every row's menu before the table and adds the actions column only when at least one row has one - so an index-only route gets a column only if its partial renders items, and an ejected copy of the default adds no empty column.
+- The partial is keyed by the route's resource name, so every route for that name (e.g. `/team_posts` and `/browse/team_posts`) shares it.
+
 ## Ejection
 
 Take over presentation or controller logic without giving up the rest:

data/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file. This project follows [Semantic Versioning](https://semver.org/).
 
+## [0.6.0] - 2026-11-11
+
+### Added
+
+- A resource can supply its own index row actions with a `_row_actions` partial at `app/views/layered/<resource>/_row_actions.html.erb`, rendered once per row with `record` as a local. It replaces the default `Edit`/`Delete` menu for that resource, keeping the index's search, filters, sorting and pagination, so menus that vary per record or per user no longer mean ejecting the whole index. A row whose partial renders nothing gets no menu, and the actions column appears only when at least one row on the page has one, so an index-only route can have row actions too. The default menu is now this partial too, and `rails g layered:resource:views` copies it
+
+### Changed
+
+- The index leaves out the actions column when no row on the page has a menu, such as a page where the policy denies every row. It used to show an empty column whenever edit or destroy was routed
+
+### Fixed
+
+- A partial the default views render by bare name, such as `_search` or `_filters`, is now picked up from `app/views/layered/<resource>/` when overridden there. The lookup context could be built before the resource was known, so its prefixes left out the per-resource directory and the gem's own partial always won
+
 ## [0.5.0] - 2026-11-11
 
 ### Fixed

data/README.md

@@ -133,7 +133,7 @@ That's it. You now have a full CRUD interface with search and pagination for `Po
 
 The index table's primary column (`primary: true`, or the first column) links to each record's edit page - or, for read-only resources without an edit action, to its show page.
 
-Row actions (`Edit`/`Delete`) live in a popover menu in the table's last column. That column is pinned to the right-hand edge of the table's scroll container, so the actions menu stays reachable when a wide table scrolls horizontally.
+Row actions (`Edit`/`Delete`, or [your own](#row-actions)) live in a popover menu in the table's last column. That column is pinned to the right-hand edge of the table's scroll container, so the actions menu stays reachable when a wide table scrolls horizontally.
 
 Each action also sets `@page_title` for use by the layout's `<title>` tag - `"Posts"` on index, `"New Post"` on new, the record's primary column value on show, and `"Edit <record label>"` on edit. Override after `super` in a custom action if you need something different.
 
@@ -291,7 +291,8 @@ When enabled:
   `Edit`/`Delete` items in the index row's actions popover, and the
   `Edit`/`Delete` buttons on the show page check
   `policy(record).new?/update?/destroy?` so users only see actions they
-  can perform.
+  can perform. A resource's own [`_row_actions`](#row-actions) partial
+  replaces the row menu's checks, so it calls `resource_can?` itself.
 
 > **`verify_authorized` / `verify_policy_scoped`**: if your
 > `ApplicationController` runs Pundit's `after_action :verify_authorized`
@@ -684,6 +685,34 @@ To render an introduction above the search area on a resource's index page, drop
 
 The partial sits inside the resource's view directory, so it follows the same per-resource override path as ejected views and column partials.
 
+## Row actions
+
+Each index row's actions menu holds whatever the `_row_actions` partial renders for that record. The gem's default renders `Edit` and `Delete`, each shown only when `resource_can?` allows it for the record. To give a resource its own menu, drop a partial at `app/views/layered/<resource>/_row_actions.html.erb`. It replaces the default for that resource only, and the index keeps its search, filters, sorting and pagination.
+
+The partial renders once per row with `record` as a local, in the normal view context, so `current_user`, your app's path helpers, `layered_member_path` and `resource_can?` are all available. Render the menu items only; the index wraps them in the popover. A row whose partial renders nothing gets no menu.
+
+```erb
+<%# app/views/layered/accounts/_row_actions.html.erb %>
+<% role = record.role_for(current_user) %>
+<% if role.in?(%w[owner admin]) %>
+  <%= link_to "Members", account_members_path(record),
+        class: "l-ui-popover__menu-item", data: { turbo_frame: "_top" } %>
+<% end %>
+<% if role == "owner" %>
+  <%= link_to "Settings", edit_account_path(record),
+        class: "l-ui-popover__menu-item", data: { turbo_frame: "_top" } %>
+<% end %>
+<hr class="l-ui-popover__menu-divider">
+<%= button_to "Leave", leave_account_path(record), method: :delete,
+      class: "l-ui-popover__menu-item l-ui-popover__menu-item--danger",
+      data: { turbo_confirm: "Leave this account?", turbo_frame: "_top" } %>
+```
+
+- **Item classes.** Give links and buttons `l-ui-popover__menu-item`, add `l-ui-popover__menu-item--danger` for destructive ones, and separate groups with `<hr class="l-ui-popover__menu-divider">`. Add `data: { turbo_frame: "_top" }` so the action leaves the index's Turbo frame.
+- **Gating is yours.** Your partial replaces the default's `resource_can?` checks. Call `resource_can?(:edit, record)` / `resource_can?(:destroy, record)` around any built-in actions you keep, so they still respect the route's `only:` and your Pundit policy. Actions on your own routes are authorised by their own controllers, as usual.
+- **When the column shows.** The actions column appears only when at least one row on the page has a menu. So an index-only route using the default gets none, while a resource whose own partial renders items gets the column on any route.
+- **Ejected views.** `rails g layered:resource:views` copies the default `_row_actions.html.erb` along with the other templates; edit it in place.
+
 ## Record pickers
 
 A field naming a `belongs_to`'s **foreign key** is a record picker, so it renders as a single-select [combobox](https://github.com/layered-ai-public/layered-ui-rails) - a type-ahead input whose selection becomes a removable token - over the associated records, rather than as the number the column happens to hold:

data/app/controllers/layered/resource/controller.rb

@@ -189,6 +189,12 @@ module Layered
         @columns = @resource.columns
         @layered_route_key = route_key
         @layered_resource_name = @_route_entry[:resource_name].presence || route_key
+        # The lookup context may already exist (an earlier before_action can
+        # build it), holding prefixes from before the resource name was
+        # known. Partials rendered by bare name - `render "row_actions"` -
+        # search those prefixes, so refresh them or a per-resource override
+        # in app/views/layered/<name>/ is never found.
+        lookup_context.prefixes = _prefixes
         @fields = @resource.resolved_fields
         @crud_enabled = @fields.any?
 

data/app/views/layered/resource/resources/_row_actions.html.erb

@@ -0,0 +1,19 @@
+<%# The items in an index row's actions menu, rendered once per record with
+    `record` as a local. The index wraps whatever this outputs in the row's
+    popover, and leaves the row without a menu when it outputs nothing.
+    Override per resource at app/views/layered/<resource>/_row_actions.html.erb. %>
+<% can_edit = resource_can?(:edit, record) %>
+<% if can_edit %>
+  <%= link_to "Edit", layered_member_path(record, action: :edit),
+        class: "l-ui-popover__menu-item",
+        data: { turbo_frame: "_top" } %>
+<% end %>
+<% if resource_can?(:destroy, record) %>
+  <% if can_edit %>
+    <hr class="l-ui-popover__menu-divider">
+  <% end %>
+  <%= button_to "Delete", layered_member_path(record),
+        method: :delete,
+        class: "l-ui-popover__menu-item l-ui-popover__menu-item--danger",
+        data: { turbo_confirm: "Are you sure?", turbo_frame: "_top" } %>
+<% end %>

data/app/views/layered/resource/resources/index.html.erb

@@ -39,22 +39,19 @@
     <%= render "filters", turbo_frame_name: turbo_frame_name %>
   <% end %>
 
-  <% actions_proc = if @resource_can_edit || @resource_can_destroy
+  <%# Each row's menu holds whatever the _row_actions partial renders for it:
+      Edit and Delete by default, or a resource's own override. Rendering
+      them up front means the actions column only appears when at least one
+      row on the page has a menu - not on an index-only route, nor on a page
+      where the policy denies every row. %>
+  <% row_menus = @records.each_with_object({}.compare_by_identity) do |record, menus|
+       items = render("row_actions", record: record)
+       menus[record] = items if items.present?
+     end %>
+  <% actions_proc = if row_menus.any?
     ->(record) do
-      items = []
-      if resource_can?(:edit, record)
-        items << link_to("Edit", layered_member_path(record, action: :edit),
-                  class: "l-ui-popover__menu-item",
-                  data: { turbo_frame: "_top" })
-      end
-      if resource_can?(:destroy, record)
-        items << tag.hr(class: "l-ui-popover__menu-divider") if items.any?
-        items << button_to("Delete", layered_member_path(record),
-                    method: :delete,
-                    class: "l-ui-popover__menu-item l-ui-popover__menu-item--danger",
-                    data: { turbo_confirm: "Are you sure?", turbo_frame: "_top" })
-      end
-      next if items.empty?
+      items = row_menus[record]
+      next unless items
 
       l_ui_popover(align: :end) do |p|
         p.trigger(class: "l-ui-button l-ui-button--outline l-ui-button--icon l-ui-button--small",
@@ -62,7 +59,7 @@
           image_tag("layered_ui/icon_more.svg", alt: "",
             class: "l-ui-icon l-ui-icon--sm", aria: { hidden: true })
         end
-        tag.div(safe_join(items), class: "l-ui-popover__menu")
+        tag.div(items, class: "l-ui-popover__menu")
       end
     end
   end %>

data/lib/generators/layered/resource/views/views_generator.rb

@@ -16,7 +16,8 @@ module Layered
         desc "Copy the gem's view templates into app/views/layered/<name>/ for full customisation."
 
         VIEWS = %w[index.html.erb show.html.erb new.html.erb edit.html.erb
-                   _search.html.erb _filters.html.erb _filter_control.html.erb].freeze
+                   _search.html.erb _filters.html.erb _filter_control.html.erb
+                   _row_actions.html.erb].freeze
 
         def copy_views
           VIEWS.each do |view|

data/lib/layered/resource/version.rb

@@ -1,5 +1,5 @@
 module Layered
   module Resource
-    VERSION = "0.5.0"
+    VERSION = "0.6.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: layered-resource-rails
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - layered.ai
@@ -297,6 +297,7 @@ files:
 - app/views/layered/resource/columns/_text.html.erb
 - app/views/layered/resource/resources/_filter_control.html.erb
 - app/views/layered/resource/resources/_filters.html.erb
+- app/views/layered/resource/resources/_row_actions.html.erb
 - app/views/layered/resource/resources/_search.html.erb
 - app/views/layered/resource/resources/edit.html.erb
 - app/views/layered/resource/resources/index.html.erb