plutonium 0.55.0 → 0.56.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. checksums.yaml +4 -4
  2. data/.claude/skills/plutonium/SKILL.md +1 -1
  3. data/.claude/skills/plutonium-app/SKILL.md +1 -1
  4. data/.claude/skills/plutonium-auth/SKILL.md +1 -1
  5. data/.claude/skills/plutonium-resource/SKILL.md +56 -3
  6. data/.claude/skills/plutonium-ui/SKILL.md +15 -2
  7. data/CHANGELOG.md +44 -0
  8. data/CONTRIBUTING.md +1 -1
  9. data/README.md +38 -16
  10. data/app/assets/plutonium.css +1 -1
  11. data/app/assets/plutonium.js +94 -26
  12. data/app/assets/plutonium.js.map +2 -2
  13. data/app/assets/plutonium.min.js +9 -9
  14. data/app/assets/plutonium.min.js.map +3 -3
  15. data/config/initializers/rabl.rb +16 -0
  16. data/docs/.vitepress/config.ts +1 -0
  17. data/docs/getting-started/installation.md +2 -2
  18. data/docs/getting-started/tutorial/02-first-resource.md +1 -1
  19. data/docs/getting-started/tutorial/03-authentication.md +3 -3
  20. data/docs/guides/adding-resources.md +1 -1
  21. data/docs/guides/authentication.md +1 -1
  22. data/docs/guides/creating-packages.md +1 -1
  23. data/docs/guides/multi-tenancy.md +1 -1
  24. data/docs/guides/nested-resources.md +1 -1
  25. data/docs/guides/user-invites.md +1 -1
  26. data/docs/guides/user-profile.md +1 -1
  27. data/docs/public/templates/lite.rb +10 -0
  28. data/docs/reference/app/generators.md +3 -3
  29. data/docs/reference/app/index.md +1 -1
  30. data/docs/reference/app/portals.md +1 -1
  31. data/docs/reference/auth/profile.md +1 -1
  32. data/docs/reference/generators/lite.md +65 -0
  33. data/docs/reference/resource/actions.md +55 -0
  34. data/docs/reference/resource/definition.md +18 -2
  35. data/docs/reference/resource/index.md +1 -1
  36. data/docs/reference/tenancy/invites.md +1 -1
  37. data/docs/reference/ui/assets.md +14 -0
  38. data/docs/reference/ui/displays.md +27 -1
  39. data/docs/reference/ui/forms.md +2 -1
  40. data/docs/reference/ui/layouts.md +33 -0
  41. data/docs/superpowers/plans/2026-06-04-sqlite-tune-maintenance-generators.md +857 -0
  42. data/docs/superpowers/plans/2026-06-04-sqlite-tune-maintenance-generators.md.tasks.json +45 -0
  43. data/docs/superpowers/specs/2026-06-04-sqlite-tune-maintenance-generators-design.md +238 -0
  44. data/gemfiles/rails_7.gemfile.lock +1 -1
  45. data/gemfiles/rails_8.0.gemfile.lock +1 -1
  46. data/gemfiles/rails_8.1.gemfile.lock +1 -1
  47. data/lib/generators/pu/core/typespec/typespec_generator.rb +1 -1
  48. data/lib/generators/pu/core/update/update_generator.rb +4 -1
  49. data/lib/generators/pu/lib/plutonium_generators/concerns/configures_recurring.rb +89 -0
  50. data/lib/generators/pu/lite/maintenance/maintenance_generator.rb +45 -0
  51. data/lib/generators/pu/lite/maintenance/templates/app/jobs/sqlite_maintenance_job.rb.tt +60 -0
  52. data/lib/generators/pu/lite/rails_pulse/rails_pulse_generator.rb +4 -51
  53. data/lib/generators/pu/lite/rails_pulse/templates/config/initializers/rails_pulse.rb.tt +1 -1
  54. data/lib/generators/pu/lite/tune/tune_generator.rb +105 -0
  55. data/lib/generators/pu/saas/welcome_generator.rb +1 -1
  56. data/lib/plutonium/action/base.rb +19 -2
  57. data/lib/plutonium/action/condition_context.rb +33 -0
  58. data/lib/plutonium/models/has_cents.rb +10 -0
  59. data/lib/plutonium/resource/controllers/interactive_actions.rb +19 -2
  60. data/lib/plutonium/routing/mapper_extensions.rb +5 -0
  61. data/lib/plutonium/ui/display/base.rb +9 -0
  62. data/lib/plutonium/ui/display/components/badge.rb +83 -0
  63. data/lib/plutonium/ui/display/components/boolean.rb +28 -6
  64. data/lib/plutonium/ui/display/components/currency.rb +50 -0
  65. data/lib/plutonium/ui/display/options/inferred_types.rb +13 -0
  66. data/lib/plutonium/ui/display/theme.rb +5 -0
  67. data/lib/plutonium/ui/form/base.rb +5 -0
  68. data/lib/plutonium/ui/form/components/toggle.rb +14 -0
  69. data/lib/plutonium/ui/form/concerns/renders_nested_resource_fields.rb +14 -25
  70. data/lib/plutonium/ui/form/concerns/renders_repeater_row_controls.rb +67 -0
  71. data/lib/plutonium/ui/form/concerns/renders_structured_inputs.rb +5 -38
  72. data/lib/plutonium/ui/form/interaction.rb +7 -2
  73. data/lib/plutonium/ui/form/options/inferred_types.rb +2 -0
  74. data/lib/plutonium/ui/form/resource.rb +1 -0
  75. data/lib/plutonium/ui/form/theme.rb +12 -0
  76. data/lib/plutonium/ui/grid/card.rb +61 -23
  77. data/lib/plutonium/ui/layout/icon_rail.rb +29 -9
  78. data/lib/plutonium/ui/page/index.rb +1 -1
  79. data/lib/plutonium/ui/page/show.rb +1 -1
  80. data/lib/plutonium/ui/sidebar_menu.rb +29 -0
  81. data/lib/plutonium/ui/table/resource.rb +2 -2
  82. data/lib/plutonium/version.rb +1 -1
  83. data/package.json +1 -1
  84. data/plutonium.gemspec +5 -4
  85. data/src/css/components.css +126 -0
  86. data/src/js/controllers/dirty_form_guard_controller.js +55 -4
  87. data/src/js/controllers/nested_resource_form_fields_controller.js +35 -12
  88. data/src/js/controllers/resource_drop_down_controller.js +49 -14
  89. metadata +20 -6
data/src/js/controllers/nested_resource_form_fields_controller.js CHANGED
@@ -1,7 +1,12 @@
1
1
  import { Controller } from "@hotwired/stimulus"
2
2
 
3
3
  // Connects to data-controller="nested-resource-form-fields"
4
- // Copied from https://github.com/stimulus-components/stimulus-rails-nested-form/blob/master/src/index.ts
4
+ // Adapted from https://github.com/stimulus-components/stimulus-rails-nested-form
5
+ //
6
+ // Persisted rows soft-delete: the row collapses to a "Removed — Restore" bar,
7
+ // its `_destroy` flag flips to "1", and it drops out of the row count so the
8
+ // add button can come back. Restoring reverses all three. Unpersisted rows are
9
+ // removed from the DOM outright — there is nothing to restore server-side.
5
10
  export default class extends Controller {
6
11
  static targets = ["target", "template", "addButton"]
7
12
 
@@ -23,9 +28,7 @@ export default class extends Controller {
23
28
  const content = this.templateTarget.innerHTML.replace(/NEW_RECORD/g, new Date().getTime().toString())
24
29
  this.targetTarget.insertAdjacentHTML("beforebegin", content)
25
30
 
26
- const event = new CustomEvent("nested-resource-form-fields:add", { bubbles: true })
27
- this.element.dispatchEvent(event)
28
-
31
+ this.dispatch("add")
29
32
  this.updateState()
30
33
  }
31
34
 
@@ -36,19 +39,37 @@ export default class extends Controller {
36
39
  if (wrapper.dataset.newRecord !== undefined) {
37
40
  wrapper.remove()
38
41
  } else {
39
- wrapper.style.display = "none"
40
- wrapper.classList.remove(...wrapper.classList)
41
-
42
- const input = wrapper.querySelector("input[name*='_destroy']")
43
- input.value = "1"
42
+ this.toggleRemoved(wrapper, true)
44
43
  }
45
44
 
46
- const event = new CustomEvent("nested-resource-form-fields:remove", { bubbles: true })
47
- this.element.dispatchEvent(event)
45
+ this.dispatch("remove")
46
+ this.updateState()
47
+ }
48
+
49
+ restore(e) {
50
+ e.preventDefault()
51
+
52
+ const wrapper = e.target.closest(this.wrapperSelectorValue)
53
+ this.toggleRemoved(wrapper, false)
48
54
 
55
+ this.dispatch("restore")
49
56
  this.updateState()
50
57
  }
51
58
 
59
+ // Collapse a persisted row to its "Removed" bar (or expand it back), keeping
60
+ // the `_destroy` flag and the removed-state marker in sync.
61
+ toggleRemoved(wrapper, removed) {
62
+ wrapper.toggleAttribute("data-removed", removed)
63
+
64
+ const content = wrapper.querySelector(":scope > [data-nested-content]")
65
+ const removedBar = wrapper.querySelector(":scope > [data-nested-removed]")
66
+ if (content) content.hidden = removed
67
+ if (removedBar) removedBar.hidden = !removed
68
+
69
+ const destroyInput = wrapper.querySelector("input[name*='_destroy']")
70
+ if (destroyInput) destroyInput.value = removed ? "1" : "0"
71
+ }
72
+
52
73
  updateState() {
53
74
  if (!this.hasAddButtonTarget || this.limitValue == 0) return
54
75
 
@@ -58,7 +79,9 @@ export default class extends Controller {
58
79
  this.addButtonTarget.style.display = "initial"
59
80
  }
60
81
 
82
+ // Removed rows keep their wrapper (so they can be restored) but are excluded
83
+ // from the count so the limit reflects rows that will actually be saved.
61
84
  get childCount() {
62
- return this.element.querySelectorAll(this.wrapperSelectorValue).length
85
+ return this.element.querySelectorAll(`${this.wrapperSelectorValue}:not([data-removed])`).length
63
86
  }
64
87
  }
data/src/js/controllers/resource_drop_down_controller.js CHANGED
@@ -27,9 +27,16 @@ export default class extends Controller {
27
27
 
28
28
  init() {
29
29
  if (this.triggerTarget && this.menuTarget && !this.initialized) {
30
+ // Capture a direct reference to the menu node. While open we teleport
31
+ // it to <body> (see show/hide), which moves it out of this controller's
32
+ // scope — so `this.menuTarget` would throw. Remember its home so we can
33
+ // put it back on hide/disconnect.
34
+ this.menu = this.menuTarget
35
+ this.menuHome = { parent: this.menu.parentNode, next: this.menu.nextSibling }
36
+
30
37
  // Initialize popper instance
31
38
  // Use 'fixed' strategy to escape overflow containers (e.g., table rows)
32
- this.popperInstance = createPopper(this.triggerTarget, this.menuTarget, {
39
+ this.popperInstance = createPopper(this.triggerTarget, this.menu, {
33
40
  strategy: 'fixed',
34
41
  placement: this.options.placement,
35
42
  modifiers: [
@@ -72,20 +79,46 @@ export default class extends Controller {
72
79
  // Remove hover event listeners
73
80
  if (this.options.triggerType === 'hover') {
74
81
  this.triggerTarget.removeEventListener('mouseenter', this.hoverShowTriggerHandler)
75
- this.menuTarget.removeEventListener('mouseenter', this.hoverShowMenuHandler)
82
+ this.menu.removeEventListener('mouseenter', this.hoverShowMenuHandler)
76
83
  this.triggerTarget.removeEventListener('mouseleave', this.hoverHideHandler)
77
- this.menuTarget.removeEventListener('mouseleave', this.hoverHideHandler)
84
+ this.menu.removeEventListener('mouseleave', this.hoverHideHandler)
78
85
  }
79
86
 
80
87
  // Remove click outside listener
81
88
  this.removeClickOutsideListener()
82
89
 
90
+ // Put the menu back where it belongs before we tear down, so a teleported
91
+ // menu isn't orphaned in <body> after the controller goes away. If its
92
+ // home is gone (e.g. turbo swapped the surrounding content), drop it.
93
+ this.restoreMenu()
94
+ if (this.menu.parentNode === document.body) {
95
+ this.menu.remove()
96
+ }
97
+
83
98
  // Destroy popper instance
84
99
  this.popperInstance.destroy()
85
100
  this.initialized = false
86
101
  }
87
102
  }
88
103
 
104
+ // Move the menu to <body> so no ancestor's overflow + containing-block
105
+ // (transform/filter/will-change) can clip it. popper's 'fixed' strategy
106
+ // positions relative to the viewport, but painting is still clipped by a
107
+ // transformed, overflow-hidden ancestor (e.g. grid cards) — teleporting
108
+ // sidesteps that entirely.
109
+ teleportMenu() {
110
+ if (this.menu.parentNode !== document.body) {
111
+ document.body.appendChild(this.menu)
112
+ }
113
+ }
114
+
115
+ restoreMenu() {
116
+ const home = this.menuHome
117
+ if (home && home.parent && home.parent.isConnected && this.menu.parentNode !== home.parent) {
118
+ home.parent.insertBefore(this.menu, home.next)
119
+ }
120
+ }
121
+
89
122
  setupEventListeners() {
90
123
  // Bind handlers to preserve context
91
124
  this.clickHandler = this.toggle.bind(this)
@@ -103,7 +136,7 @@ export default class extends Controller {
103
136
  }
104
137
  this.hoverHideHandler = () => {
105
138
  setTimeout(() => {
106
- if (!this.menuTarget.matches(':hover')) {
139
+ if (!this.menu.matches(':hover')) {
107
140
  this.hide()
108
141
  }
109
142
  }, this.options.delay)
@@ -114,9 +147,9 @@ export default class extends Controller {
114
147
  this.triggerTarget.addEventListener('click', this.clickHandler)
115
148
  } else if (this.options.triggerType === 'hover') {
116
149
  this.triggerTarget.addEventListener('mouseenter', this.hoverShowTriggerHandler)
117
- this.menuTarget.addEventListener('mouseenter', this.hoverShowMenuHandler)
150
+ this.menu.addEventListener('mouseenter', this.hoverShowMenuHandler)
118
151
  this.triggerTarget.addEventListener('mouseleave', this.hoverHideHandler)
119
- this.menuTarget.addEventListener('mouseleave', this.hoverHideHandler)
152
+ this.menu.addEventListener('mouseleave', this.hoverHideHandler)
120
153
  }
121
154
  }
122
155
 
@@ -140,8 +173,8 @@ export default class extends Controller {
140
173
  const isFloatingUI = clickedEl.closest('.flatpickr-calendar, .ss-main, .ss-content')
141
174
 
142
175
  if (
143
- clickedEl !== this.menuTarget &&
144
- !this.menuTarget.contains(clickedEl) &&
176
+ clickedEl !== this.menu &&
177
+ !this.menu.contains(clickedEl) &&
145
178
  !this.triggerTarget.contains(clickedEl) &&
146
179
  !isIgnored &&
147
180
  !isFloatingUI &&
@@ -169,9 +202,10 @@ export default class extends Controller {
169
202
  }
170
203
 
171
204
  show() {
172
- this.menuTarget.classList.remove('hidden')
173
- this.menuTarget.classList.add('block')
174
- this.menuTarget.removeAttribute('aria-hidden')
205
+ this.teleportMenu()
206
+ this.menu.classList.remove('hidden')
207
+ this.menu.classList.add('block')
208
+ this.menu.removeAttribute('aria-hidden')
175
209
 
176
210
  // Enable popper event listeners
177
211
  this.popperInstance.setOptions((options) => ({
@@ -188,9 +222,9 @@ export default class extends Controller {
188
222
  }
189
223
 
190
224
  hide() {
191
- this.menuTarget.classList.remove('block')
192
- this.menuTarget.classList.add('hidden')
193
- this.menuTarget.setAttribute('aria-hidden', 'true')
225
+ this.menu.classList.remove('block')
226
+ this.menu.classList.add('hidden')
227
+ this.menu.setAttribute('aria-hidden', 'true')
194
228
 
195
229
  // Disable popper event listeners
196
230
  this.popperInstance.setOptions((options) => ({
@@ -202,6 +236,7 @@ export default class extends Controller {
202
236
  }))
203
237
 
204
238
  this.removeClickOutsideListener()
239
+ this.restoreMenu()
205
240
  this.visible = false
206
241
  }
207
242
  }
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: plutonium
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.55.0
4
+ version: 0.56.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Stefan Froelich
8
8
  bindir: exe
9
9
  cert_chain: []
10
- date: 2026-06-03 00:00:00.000000000 Z
10
+ date: 2026-06-05 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: zeitwerk
@@ -637,6 +637,7 @@ files:
637
637
  - docs/reference/behavior/interactions.md
638
638
  - docs/reference/behavior/policies.md
639
639
  - docs/reference/configuration.md
640
+ - docs/reference/generators/lite.md
640
641
  - docs/reference/index.md
641
642
  - docs/reference/resource/actions.md
642
643
  - docs/reference/resource/definition.md
@@ -667,6 +668,8 @@ files:
667
668
  - docs/superpowers/plans/2026-05-15-public-pages-overhaul.md.tasks.json
668
669
  - docs/superpowers/plans/2026-06-02-structured-inputs.md
669
670
  - docs/superpowers/plans/2026-06-02-structured-inputs.md.tasks.json
671
+ - docs/superpowers/plans/2026-06-04-sqlite-tune-maintenance-generators.md
672
+ - docs/superpowers/plans/2026-06-04-sqlite-tune-maintenance-generators.md.tasks.json
670
673
  - docs/superpowers/specs/2026-04-08-plutonium-skills-overhaul-design.md
671
674
  - docs/superpowers/specs/2026-04-14-plutonium-testing-design.md
672
675
  - docs/superpowers/specs/2026-05-07-ui-layout-overhaul-design.md
@@ -676,6 +679,7 @@ files:
676
679
  - docs/superpowers/specs/2026-05-15-public-pages-overhaul-design.md
677
680
  - docs/superpowers/specs/2026-05-29-avatar-component-design.md
678
681
  - docs/superpowers/specs/2026-06-01-structured-inputs-design.md
682
+ - docs/superpowers/specs/2026-06-04-sqlite-tune-maintenance-generators-design.md
679
683
  - esbuild.config.js
680
684
  - exe/pug
681
685
  - gemfiles/rails_7.gemfile
@@ -778,6 +782,7 @@ files:
778
782
  - lib/generators/pu/lib/plutonium_generators/cli.rb
779
783
  - lib/generators/pu/lib/plutonium_generators/concerns/actions.rb
780
784
  - lib/generators/pu/lib/plutonium_generators/concerns/config.rb
785
+ - lib/generators/pu/lib/plutonium_generators/concerns/configures_recurring.rb
781
786
  - lib/generators/pu/lib/plutonium_generators/concerns/configures_sqlite.rb
782
787
  - lib/generators/pu/lib/plutonium_generators/concerns/logger.rb
783
788
  - lib/generators/pu/lib/plutonium_generators/concerns/mounts_engines.rb
@@ -790,6 +795,8 @@ files:
790
795
  - lib/generators/pu/lib/plutonium_generators/model_generator_base.rb
791
796
  - lib/generators/pu/lib/plutonium_generators/non_interactive_prompt.rb
792
797
  - lib/generators/pu/lite/litestream/litestream_generator.rb
798
+ - lib/generators/pu/lite/maintenance/maintenance_generator.rb
799
+ - lib/generators/pu/lite/maintenance/templates/app/jobs/sqlite_maintenance_job.rb.tt
793
800
  - lib/generators/pu/lite/rails_pulse/rails_pulse_generator.rb
794
801
  - lib/generators/pu/lite/rails_pulse/templates/config/initializers/rails_pulse.rb.tt
795
802
  - lib/generators/pu/lite/setup/setup_generator.rb
@@ -797,6 +804,7 @@ files:
797
804
  - lib/generators/pu/lite/solid_cache/solid_cache_generator.rb
798
805
  - lib/generators/pu/lite/solid_errors/solid_errors_generator.rb
799
806
  - lib/generators/pu/lite/solid_queue/solid_queue_generator.rb
807
+ - lib/generators/pu/lite/tune/tune_generator.rb
800
808
  - lib/generators/pu/pkg/package/package_generator.rb
801
809
  - lib/generators/pu/pkg/package/templates/.keep
802
810
  - lib/generators/pu/pkg/package/templates/app/controllers/resource_controller.rb.tt
@@ -948,6 +956,7 @@ files:
948
956
  - lib/plutonium.rb
949
957
  - lib/plutonium/action/README.md
950
958
  - lib/plutonium/action/base.rb
959
+ - lib/plutonium/action/condition_context.rb
951
960
  - lib/plutonium/action/interactive.rb
952
961
  - lib/plutonium/action/route_options.rb
953
962
  - lib/plutonium/action/simple.rb
@@ -1084,8 +1093,10 @@ files:
1084
1093
  - lib/plutonium/ui/display/base.rb
1085
1094
  - lib/plutonium/ui/display/components/association.rb
1086
1095
  - lib/plutonium/ui/display/components/attachment.rb
1096
+ - lib/plutonium/ui/display/components/badge.rb
1087
1097
  - lib/plutonium/ui/display/components/boolean.rb
1088
1098
  - lib/plutonium/ui/display/components/color.rb
1099
+ - lib/plutonium/ui/display/components/currency.rb
1089
1100
  - lib/plutonium/ui/display/components/markdown.rb
1090
1101
  - lib/plutonium/ui/display/components/phlexi_render.rb
1091
1102
  - lib/plutonium/ui/display/options/inferred_types.rb
@@ -1105,8 +1116,10 @@ files:
1105
1116
  - lib/plutonium/ui/form/components/secure_association.rb
1106
1117
  - lib/plutonium/ui/form/components/secure_polymorphic_association.rb
1107
1118
  - lib/plutonium/ui/form/components/sticky_footer.rb
1119
+ - lib/plutonium/ui/form/components/toggle.rb
1108
1120
  - lib/plutonium/ui/form/components/uppy.rb
1109
1121
  - lib/plutonium/ui/form/concerns/renders_nested_resource_fields.rb
1122
+ - lib/plutonium/ui/form/concerns/renders_repeater_row_controls.rb
1110
1123
  - lib/plutonium/ui/form/concerns/renders_structured_inputs.rb
1111
1124
  - lib/plutonium/ui/form/concerns/repeater_field_styles.rb
1112
1125
  - lib/plutonium/ui/form/concerns/typeahead_attributes.rb
@@ -1239,17 +1252,18 @@ metadata:
1239
1252
  homepage_uri: https://radioactive-labs.github.io/plutonium-core/
1240
1253
  source_code_uri: https://github.com/radioactive-labs/plutonium-core
1241
1254
  post_install_message: |
1242
- ⚠️ Plutonium 0.55.0 — breaking change
1255
+ ℹ️ Plutonium — breaking change introduced in 0.49.0
1243
1256
 
1244
- Entity-scoped URL helpers and path params have been renamed from
1257
+ Entity-scoped URL helpers and path params were renamed in 0.49.0 from
1245
1258
  `<entity>_scope_*` to `<entity>_scoped_*`.
1246
1259
 
1247
1260
  Examples:
1248
1261
  organization_scope_widgets_path → organization_scoped_widgets_path
1249
1262
  params[:organization_scope] → params[:organization_scoped]
1250
1263
 
1251
- If you reference these helpers or params directly (e.g. in tests, custom
1252
- redirects, or hand-written links), update them to the new names.
1264
+ If you are upgrading from 0.48.0 or earlier and reference these helpers or
1265
+ params directly (e.g. in tests, custom redirects, or hand-written links),
1266
+ update them to the new names.
1253
1267
 
1254
1268
  Apps that only use `resource_url_for` are unaffected.
1255
1269
  rdoc_options: []