plutonium 0.54.0 → 0.56.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65714d92f3f0d6759f5b0fbc0818be12387892214b09959de80d589f859a6a56
-  data.tar.gz: 2190fd85c3ac535df868581baace2be6565c709263c1059eeccc37bb9ba6c396
+  metadata.gz: fdb3a70cfc50828cc986040543d72e8e576497deffb3304aac601b113c507370
+  data.tar.gz: 7901dd81e5a9f11519224695071e1fe76c3121e8d311d1b1d6d7445fb2179667
 SHA512:
-  metadata.gz: 5ec925506a147113242a8888e96797d56cfb76972e771792752a296b6036ca5adffc8698ad9b967056b043f3c9df86a422d014cea6ec699cac73c692408ee962
-  data.tar.gz: e8c29ac3f6d9e83b00dba5817e209c1e7d276730b599660dbd4fe5fe4a14684695fb069b0ff5b226b9f0b7a3cc96a7d74bb02edb1cbcf0c23fe345c7d56ace13
+  metadata.gz: 3d89dc0f91a27bb0e0e1ac5503cb11059d35309767fa006c200216819e0c123d6d2a558a03ac162964527b992fabc974184d5f357f3b0389405f2c63a13bdfed
+  data.tar.gz: 584146030273aeac56b898049f4f9e6a05f364c1b334bdca4ef2e044288548f1277c4d419cf7051504d36e0fd32ffbe48a4540c03f7b80f08405f43b4a0313ab

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

@@ -656,6 +656,28 @@ attribute :date, :datetime
 
 The presence of `:resource` / `:resources` / neither determines the action type — see [[plutonium-resource]] › Action Types.
 
+### Structured / repeating input
+
+To collect a structured object or a repeating list of field-groups, use
+`structured_input` (it declares the backing attribute for you):
+
+```ruby
+structured_input :address do |f|          # single → execute sees { street:, city: }
+  f.input :street
+  f.input :city
+end
+
+structured_input :contacts, repeat: 3 do |f|  # repeater → [ { label:, phone: }, ... ]
+  f.input :label
+  f.input :phone
+end
+```
+
+⚠️ **`nested_input` and `accepts_nested_attributes_for` are NOT available on
+interactions** (they were model-backed). Use `structured_input` instead — it's
+classless and collects plain hashes/arrays. See [[plutonium-resource]] ›
+Structured Inputs for options (`repeat:`, `using:`, `fields:`).
+
 ## Inputs
 
 Same DSL as definition `input` (load [[plutonium-resource]] for the full list of `as:` types, options, dynamic blocks, etc.):

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

@@ -484,7 +484,7 @@ end
 | Text | `:string`, `:text`, `:email`, `:url`, `:tel`, `:password` |
 | Rich Text | `:markdown` (EasyMDE) |
 | Numeric | `:number`, `:integer`, `:decimal`, `:range` |
-| Boolean | `:boolean` |
+| Boolean | `:toggle` / `:switch` (switch — **default** for boolean columns), `:boolean` (plain checkbox) |
 | Date/Time | `:date`, `:time`, `:datetime` |
 | Selection | `:select`, `:slim_select`, `:radio_buttons`, `:check_boxes` |
 | Files | `:file`, `:uppy`, `:attachment` |
@@ -493,7 +493,26 @@ end
 
 ### Display Types (show / index)
 
-`:string`, `:text`, `:email`, `:url`, `:phone`, `:markdown`, `:number`, `:integer`, `:decimal`, `:boolean`, `:date`, `:time`, `:datetime`, `:association`, `:attachment`
+`:string`, `:text`, `:email`, `:url`, `:phone`, `:markdown`, `:number`, `:integer`, `:decimal`, `:boolean`, `:badge`, `:currency`, `:color`, `:date`, `:time`, `:datetime`, `:association`, `:attachment`
+
+#### Auto-inferred display formatting
+
+These render automatically — declare an `as:` only to override or pass options:
+
+| Column | Renders as | Notes |
+|--------|-----------|-------|
+| `boolean` | Yes/No pill (`:boolean`) | green "Yes" / neutral "No". Override labels: `true_label:`, `false_label:` |
+| `enum` | colored status badge (`:badge`) | known statuses (active, pending, failed…) auto-colored; unknown values get a stable decorative color |
+| `has_cents` decimal | currency (`:currency`) | delimited, 2 decimals, **no symbol** unless you add `unit:` |
+
+```ruby
+display :status, as: :badge, colors: {archived: :neutral, vip: :accent}  # override per-value color
+display :price,  as: :currency, unit: "£"                                # literal symbol
+display :price,  as: :currency, unit: :currency_symbol                   # Symbol → read off the record (per-row)
+display :active, as: :boolean,  true_label: "Live", false_label: "Off"
+```
+
+Badge color keys: `:neutral`, `:primary`, `:secondary`, `:success`, `:danger`, `:warning`, `:info`, `:accent`.
 
 ## Field Options
 
@@ -684,6 +703,61 @@ end
 - For custom class names, use `class_name:` in the model and `using:` in the definition.
 - `update_only: true` hides the Add button.
 
+## Structured Inputs
+
+`structured_input` collects a **classless** group of fields — a single hash, or
+(with `repeat:`) an array of hashes. No association or model class is involved.
+On resources the value is stored in a **JSON/jsonb column**; use it when you
+want structured data in a JSON column rather than a real association (which is
+`nested_input`'s job).
+
+```ruby
+class Spec < ResourceRecord
+  # t.json :payload   /   t.json :rows  (jsonb in production)
+end
+
+class SpecDefinition < ResourceDefinition
+  structured_input :payload do |f|       # single → { title:, notes: }
+    f.input :title
+    f.input :notes
+  end
+
+  structured_input :rows, repeat: 5 do |f|  # repeater → [ { key:, value: }, ... ] (max 5)
+    f.input :key
+    f.input :value
+  end
+end
+
+class SpecPolicy < ResourcePolicy
+  # NOTE: unlike nested_input, you DO permit the column name here.
+  # (update inherits permitted_attributes_for_create automatically.)
+  def permitted_attributes_for_create = [:payload, :rows]
+end
+```
+
+`execute`/the record sees `payload => { "title" => …, "notes" => … }` and
+`rows => [ { "key" => …, "value" => … }, … ]` (string keys from the JSON column;
+blank rows are dropped, `_destroy` stripped).
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `repeat` | Presence ⇒ array (repeater). `Integer` = max rows; `true` = default cap (10); absent = single hash |
+| `using` | A fields definition class instead of a block |
+| `fields` | Subset of fields from the referenced definition |
+
+### Gotchas
+
+- The column must be `json`/`jsonb` (or otherwise hold a hash/array). No model macro is needed — the value assigns directly.
+- **Unlike `nested_input`, you DO permit the column name** in `permitted_attributes_for_*` (it's a regular attribute on a JSON column).
+- `repeat: 1` is "array, max one row" — **not** the single form. Presence of `repeat:` always means an array.
+- Rows are positional plain hashes — **no ids, no per-row class, no type coercion**.
+- **No automatic validation.** Classless ⇒ nothing to attach `validates` to. `required:` and a select's `choices:` are **client-side only**, not enforced on the server. To enforce, add a model `validate` (resource) or a `validate` on the interaction (ActiveModel, checked before `execute`).
+- **`as: :select` drops unknown values.** If a stored value isn't in `choices:`, the `<select>` renders blank and **saving overwrites it with `nil`** (standard `<select>` behaviour). Keep `choices:` a stable superset or use free text when values can drift.
+- Inside repeater rows, prefer **native** field types (string, number, text, native `select`, checkbox). JS-enhanced inputs (slim-select, flatpickr, easymde, uppy, intl-tel) transform the DOM and may not survive the repeater's clone-by-innerHTML — verify before relying on them.
+- Same DSL works on **interactions** (see [[plutonium-behavior]] › Interactions) — there it backs an ActiveModel attribute reaching `execute`.
+
 ## File Uploads
 
 ```ruby

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

@@ -252,6 +252,7 @@ render field(:title).wrapped(class: "col-span-full") { |f| f.input_tag }
 | `input_tag` | text (auto-detected type) |
 | `string_tag`, `text_tag`, `number_tag`, `email_tag`, `password_tag`, `url_tag`, `tel_tag`, `hidden_tag` | standard HTML inputs |
 | `checkbox_tag`, `select_tag`, `radio_button_tag` | standard |
+| `toggle_tag` / `switch_tag` | switch-styled boolean (`as: :toggle` / `:switch`) — default for boolean columns; `as: :boolean` for a plain checkbox |
 
 ### Plutonium-enhanced tags
 
@@ -302,7 +303,8 @@ end
 These all live in the definition layer:
 
 - **Pre-submit / dynamic forms** — see [[plutonium-resource]] › Dynamic Forms.
-- **Nested inputs** (`nested_input :variants`) — see [[plutonium-resource]] › Nested Inputs.
+- **Nested inputs** (`nested_input :variants`) — association-backed inline forms; see [[plutonium-resource]] › Nested Inputs.
+- **Structured inputs** (`structured_input :payload`, `structured_input :rows, repeat: 5`) — classless hash / array-of-hashes into a JSON column (resources) or an attribute (interactions); reuses the repeater chrome. See [[plutonium-resource]] › Structured Inputs.
 - **Interaction forms** — interactions define their own `attribute` / `input` and inherit `Plutonium::UI::Form::Interaction`; see [[plutonium-behavior]] › Interactions.
 
 ---
@@ -512,6 +514,16 @@ rails generate pu:eject:layout
 
 These copy `_resource_header.html.erb`, `_resource_sidebar.html.erb`, and `layouts/resource.html.erb` into the portal so you can edit them directly.
 
+## Navigation menu items
+
+The sidebar/icon-rail menu is built with `Phlexi::Menu::Builder` in `_resource_sidebar.html.erb`. Extra options on `item` are spread onto the rendered `<a>`, so an item can opt into `target` / `rel` / `data:` / `aria:`:
+
+```ruby
+m.item "Inbox", url: inbox_path, icon: Icon, target: "_blank", rel: "noopener", data: {turbo_frame: "_top"}
+```
+
+Applies to both shells (icon-rail leaf, parent flyout trigger, and flyout children; classic sidebar). Framework `class`/`data`/`aria` win on conflict — `class:` merges with the base classes, and on a parent trigger `data:`/`aria:` merge with the flyout wiring so options can't break the toggle. Phlexi's reserved `:active` key is never emitted as an attribute.
+
 ## Custom layout class (Phlex)
 
 ```ruby
@@ -732,7 +744,8 @@ Ready-to-use styled components in `src/css/components.css`. **Prefer these over
 ### Inputs, cards, panels, tables, toolbars, empty states
 
 ```
-.pu-input / -invalid / -valid          .pu-label / -required          .pu-hint / .pu-error          .pu-checkbox
+.pu-input / -invalid / -valid          .pu-label / -required          .pu-hint / .pu-error          .pu-checkbox / .pu-toggle
+.pu-badge / -neutral / -primary / -secondary / -success / -danger / -warning / -info / -accent
 .pu-card / .pu-card-body
 .pu-panel-header / -title / -description
 .pu-table-wrapper / .pu-table / -header / -header-cell / -body-row / -body-row-selected / -body-cell / .pu-selection-cell
@@ -844,7 +857,7 @@ end
 
 ### Display theme keys
 
-`fields_wrapper`, `label`, `description`, `string`, `text`, `link`, `email`, `phone`, `markdown`, `json`.
+`fields_wrapper`, `label`, `description`, `string`, `text`, `link`, `email`, `phone`, `markdown`, `json`, `boolean`, `badge`, `currency`, `color`.
 
 ## Table theme
 
@@ -913,6 +926,7 @@ end
 - **Dark mode is `selector`, not `class`.** Toggle via `document.documentElement.classList.toggle('dark')`.
 - **Tokens are CSS variables, not Tailwind keys** — `bg-[var(--pu-surface)]`, not `bg-pu-surface`.
 - **`render_actions` is mandatory in custom `form_template`** — otherwise no submit button.
+- **Dropdowns (`resource-drop-down`) teleport their menu to `<body>` while open.** popper's `fixed` strategy alone is still clipped by a transformed + `overflow:hidden` ancestor (e.g. grid cards, app shells), so the controller reparents the open menu to `<body>` and restores it on close. Don't rely on the menu being a DOM child of its trigger while open.
 
 ---
 

data/CHANGELOG.md

@@ -1,3 +1,48 @@
+## [0.56.0] - 2026-06-05
+
+### 🚀 Features
+
+- *(ui)* Auto-rendered components for boolean, enum & money fields
+- *(generators/lite)* Add pu:lite:tune and pu:lite:maintenance for SQLite tuning + maintenance
+- *(ui)* Sidebar menu items accept arbitrary link attributes
+- *(ui)* Restore deleted nested rows + shared, polished removed bar
+- *(ui)* Type-aware grid cards + overhaul KitchenSink dummy resource
+
+### 🐛 Bug Fixes
+
+- *(generators/update)* Sync skills in a fresh process; pin post-install notice to 0.49.0
+- *(ui)* Native multi-selects render at a usable height
+- *(ui)* Dropdown menu teleports to <body> to escape overflow clipping
+- *(routing)* Force :resources route_type for has_many nested routes
+- *(ui)* Record-scoped commit URL for actions with record_action: false
+- *(api)* Serialize JSON values via as_json (ISO 8601 datetimes)
+- *(generators)* Add reading role to Rails Pulse connects_to config
+- *(actions)* Bind subject during interaction param extraction
+- *(ui)* Dirty-form-guard tracks edits via first-interaction baseline
+- *(ui)* Give the JSON form input dark-mode styling
+
+### 🧪 Testing
+
+- Fix stale generator assertions and drop committed dummy schema
+- *(dummy)* Add KitchenSink resource exercising every input/display type
+
+### ⚙️ Miscellaneous Tasks
+
+- Sync appraisal gemfile.lock files to v0.55.0
+## [0.55.0] - 2026-06-03
+
+### 🚀 Features
+
+- Structured_input — classless structured & repeater inputs (resources + interactions) (#60)
+
+### 🐛 Bug Fixes
+
+- *(ui)* Keep modal backdrop static to smooth dialog dismiss
+
+### 🧪 Testing
+
+- *(dummy)* Land authenticated users on the entity-scoped org portal
+- *(dummy)* Serve the Organization resource in the org portal
 ## [0.54.0] - 2026-06-01
 
 ### 🚀 Features