plutonium 0.54.0 → 0.55.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65714d92f3f0d6759f5b0fbc0818be12387892214b09959de80d589f859a6a56
-  data.tar.gz: 2190fd85c3ac535df868581baace2be6565c709263c1059eeccc37bb9ba6c396
+  metadata.gz: ecf3e56a7d08f87ee2e77af368b4059655aeea666fcfefcf238256ae8564a9e8
+  data.tar.gz: d70895506dda46cafc6933b9a972261365cdbddaff728e6eb8ad84bb3857ce0a
 SHA512:
-  metadata.gz: 5ec925506a147113242a8888e96797d56cfb76972e771792752a296b6036ca5adffc8698ad9b967056b043f3c9df86a422d014cea6ec699cac73c692408ee962
-  data.tar.gz: e8c29ac3f6d9e83b00dba5817e209c1e7d276730b599660dbd4fe5fe4a14684695fb069b0ff5b226b9f0b7a3cc96a7d74bb02edb1cbcf0c23fe345c7d56ace13
+  metadata.gz: d8e6d17854893f67732bfb97ecc7cf744501d5469df99bfd0c3e5c9b8f39d16818c93c270e586f6cd486c4559465db33e4e3cdfb6fff0fa9dfb7d3cf027678ef
+  data.tar.gz: af4b9df9e92dd343c6db4d73d39d3cfcad6a08fc3a9ce74ad47afabfb25056c0bccc7e8a924ac3a6070e4767a7e05e69d012cff6073732c04bae425bc33dd894

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

@@ -684,6 +684,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

@@ -302,7 +302,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.
 
 ---

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [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