plutonium 0.49.1 → 0.50.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5016bbce0d2ef39825a923b820797c304a848396853f334d94757f22a90a99e9
-  data.tar.gz: aa95cd0b1d994c093dd0e51587d5c95c3b0a527b0ca5a8f771be1a6f21fd9daa
+  metadata.gz: 8f93a96f45defbcd651a0c13ce62ca190dfb8fb83b7d0bca50d450f28c8ee6c0
+  data.tar.gz: ac996ab0486ae36f7cfda6f6a25d625c71560f4841e828c443f1cd906cd1af2f
 SHA512:
-  metadata.gz: 6aeedc9109ad0ac05e2343981de71497ba08be96017e5af800bde70eb5035a96a027477ec2280ad78a1e9449c530e2c67290663efc28a2cc41f97c492056e1e9
-  data.tar.gz: 5b697b2d753c9f80443210c2169f2abe42642f0d36bb1f0aa909965da6317cc1e4c90406560d9bf0156457e5a01b9a009b38250c0aed134b09328d50cb47484f
+  metadata.gz: 8f06360e34c7b43c797877a2555bbae11222f870e2bf82e4ec0a1ce8c0a4baf0a078cff1b65baf6159f8095345068cd1216fdcdf4d152354d46069a4d0480ad6
+  data.tar.gz: 663af09cc688359ef9fb41c3b4a76aa3061c9dc68b701586f03e6b09bce7b2d853b0afed60202d3b5ffa497e7b6c413b7e3c86207ac6bed9e26e1c4969400e76

data/.claude/skills/plutonium-definition/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: plutonium-definition
-description: Use BEFORE editing a resource definition — adding fields, inputs, displays, columns, search, filters, scopes, custom actions, or bulk actions.
+description: Use BEFORE editing a resource definition — adding fields, inputs, displays, columns, metadata, index views (table/grid), search, filters, scopes, custom actions, modal/slideover behavior, or bulk actions.
 ---
 
 # Plutonium Resource Definitions
@@ -582,9 +582,19 @@ class PostDefinition < ResourceDefinition
   # true = always show
   # false = always hide
   submit_and_continue false
+
+  # How `:new` / `:edit` render. Default is :slideover.
+  #   :slideover — slide-in panel from the right (default)
+  #   :centered  — centered dialog
+  #   false      — full standalone pages (no modal)
+  modal :centered
 end
 ```
 
+The `modal` setting only affects the framework-provided `:new` / `:edit`
+actions. Custom actions render in their own dialog, controlled by the
+per-action `modal:` option (`:centered` default, or `:slideover`).
+
 ## Page Customization
 
 ```ruby
@@ -617,6 +627,74 @@ class PostDefinition < ResourceDefinition
 end
 ```
 
+## Metadata Panel (Show Page)
+
+The `metadata` DSL declares a list of fields rendered in the show page's
+right-side aside as label/value rows. The main details card and the
+metadata aside share the same field-rendering machinery, so labels and
+formatting come from your existing `field` / `display` declarations.
+
+```ruby
+class PostDefinition < ResourceDefinition
+  metadata :author, :state, :created_at, :updated_at
+end
+```
+
+Behavior:
+
+- **Opt-in.** No `metadata` call → the show page renders full-width with
+  no aside.
+- **Policy-aware.** Metadata fields are intersected with the policy's
+  permitted attributes. Fields the user can't see disappear from the
+  panel; the panel auto-hides when nothing is permitted.
+- **Deduplicated.** Fields listed in `metadata` are removed from the main
+  details card so the same value never appears twice.
+- **Responsive.** Side-by-side at `lg+`, stacked single-column below.
+
+Use it for chrome that's not the focus of the record — timestamps,
+ownership, system flags — keeping the main card focused on the record's
+substance.
+
+## Index Views (Table & Grid)
+
+Resources can opt into a card-based **Grid** view alongside the default
+**Table** view. Users can switch between the two and the choice is
+persisted per-resource via cookie.
+
+```ruby
+class UserDefinition < ResourceDefinition
+  views :table, :grid       # enable both; user can switch
+  default_view :grid        # initial view if no cookie
+
+  grid_fields(
+    image:     :avatar,     # ActiveStorage attachment, Shrine, or URL
+    header:    :name,       # falls back to record.to_label
+    subheader: :email,
+    body:      :bio,
+    meta:      [:role, :status],   # rendered as small pills
+    footer:    :last_seen_at       # falls back to :created_at
+  )
+
+  grid_layout :media        # :compact (default) or :media
+  grid_columns 3            # pin to 3 cols on lg+; default is 1/2/3/4 responsive
+end
+```
+
+DSL surface:
+
+| Method | Purpose |
+|--------|---------|
+| `views :table, :grid` | Which views are available. Default `[:table]`. |
+| `default_view :grid` | Initial view when no cookie. Falls back to first view in `views`. |
+| `grid_fields(...)` | Maps card slots to fields. **Implicitly enables `:grid`** if not already in `views`. |
+| `grid_layout :media` | `:compact` (image left of content) or `:media` (full-width image on top). |
+| `grid_columns 3` | Override responsive column count on lg+. |
+
+Grid slots are all optional — `:image`, `:header`, `:subheader`, `:body`,
+`:meta`, `:footer`. `:meta` accepts an array; the rest are single
+fields. Slots that point at fields not permitted by the user's policy
+collapse silently.
+
 ## Context in Blocks
 
 Inside `condition` procs and `input` blocks:
@@ -941,9 +1019,16 @@ action :name,
   # Behavior
   confirmation: "Are you sure?",
   turbo_frame: "_top",
-  route_options: {action: :foo}
+  route_options: {action: :foo},
+  modal: :slideover                # :centered (default) or :slideover —
+                                    # how the action's interaction form renders
 ```
 
+**`Action#with(...)`** — actions are frozen value objects. To derive a
+variant (typically inside `customize_actions`) call
+`existing_action.with(turbo_frame: nil)` for a new copy with the
+overrides applied.
+
 ### Creating an Interaction
 
 #### Basic Structure

data/.claude/skills/plutonium-installation/SKILL.md

@@ -211,6 +211,10 @@ rails generate pu:res:conn Post --dest=admin_portal
 Plutonium.configure do |config|
   config.load_defaults 1.0
 
+  # Page chrome. Default :modern (topbar + icon rail). Set :classic
+  # only when upgrading and you want to keep the legacy header + sidebar.
+  # config.shell = :classic
+
   # Custom assets (optional)
   # config.assets.stylesheet = "custom_stylesheet"
   # config.assets.script = "custom_script"
@@ -311,6 +315,8 @@ For models that already exist in your app:
 | `pu:res:scaffold NAME` | Create resource (model, policy, definition, controller) |
 | `pu:res:conn NAME` | Connect resource to portal |
 | `pu:eject:layout` | Eject layout files for customization |
+| `pu:eject:shell` | Eject the topbar/sidebar partials so you can customize chrome per-portal |
+| `pu:core:update` | Update the plutonium gem + npm package |
 | `pu:skills:sync` | Sync Claude Code skills to project |
 
 ## Related Skills

data/.claude/skills/plutonium-views/SKILL.md

@@ -425,6 +425,65 @@ class PostDefinition < ResourceDefinition
 end
 ```
 
+## Page Chrome (Shell)
+
+`Plutonium.configuration.shell` controls the layout shipped above the
+resource pages. Default is **`:modern`** (topbar + icon rail) — only
+override to **`:classic`** (legacy header + sidebar) if you're upgrading
+from a pre-`:modern` version and want to preserve the old chrome:
+
+```ruby
+Plutonium.configure do |config|
+  config.shell = :classic
+end
+```
+
+To customize the shipped chrome per-portal, eject the templates:
+
+```bash
+rails generate pu:eject:shell --dest=admin_portal
+```
+
+This copies `_resource_header.html.erb` and `_resource_sidebar.html.erb`
+into the portal's `app/views/plutonium/`. The eject is independent of
+`shell` — you can run it on either.
+
+## Modal & Slideover Forms
+
+The framework's `:new` / `:edit` actions render inline inside a modal.
+Choose the chrome per-resource via the `modal` DSL on the definition:
+
+```ruby
+class PostDefinition < ResourceDefinition
+  modal :slideover    # default — slide-in panel from the right
+  # modal :centered   # centered dialog
+  # modal false       # full standalone page (no modal)
+end
+```
+
+Custom interactive actions render in their own dialog with their own
+`modal:` option (`:centered` default, or `:slideover`).
+
+### Detecting render context in components
+
+Custom pages / forms can branch on render context:
+
+| Helper | True when |
+|--------|-----------|
+| `in_frame?` | Request is targeting a turbo-frame |
+| `in_modal?` | Request is rendering inside a modal/slideover |
+
+Use them to pin action strips, omit nav chrome, or swap layouts.
+
+## Tabs & URL Hash
+
+Show pages with associations render the **Details** tab first followed
+by one tab per permitted association. The active tab is reflected in
+the URL hash (`#products`, `#refund-requests`) so the page deep-links and
+the active state survives reloads / back navigation.
+
+Tab rows scroll horizontally on narrow viewports — they don't wrap.
+
 ## Layout Customization
 
 ### Eject Layout

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [0.50.0] - 2026-05-11
+
+### 🚀 Features
+
+- *(ui)* UI layout overhaul: modern shell, slideovers, filters, Grid view (#52)
+- *(css)* Style WebKit autofill on .pu-input variants
+
+### 🐛 Bug Fixes
+
+- *(ui/form)* Suppress label and chrome for hidden fields
+- *(generators/rails_pulse)* Inject recurring tasks under env blocks
+- *(bulk_actions)* Selection cells survive table re-renders
 ## [0.49.1] - 2026-05-06
 
 ### 🚀 Features