avo 4.4.1 → 4.4.3

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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: a73813ac6780ee6f2be7897e9e43d7001547efa7551c02e596e2e0c03904db9f
4
- data.tar.gz: f901904f867de73dd1a4ceecc1e30e49385be0fe68f67dfcff2a56a894d871b1
3
+ metadata.gz: 4db5afb9a352fe2f25dd355093e0fb16f466c205d4ab10f4c59a30951021c6aa
4
+ data.tar.gz: aad220bc34950f2d5c53d9e7af37b6d98d4b4e26168e33df781bdae46d6e95e2
5
5
  SHA512:
6
- metadata.gz: 643168d1b6a9e4d8c6ea875428403a2ecfb06b7fc724ad9284e6d7ba2cfc6924f5411b9fcb3f45e9e1a031c41a1e3a49e3d696b89064ae058d76f57eec1d161c
7
- data.tar.gz: 81b2974b0f4285531b469bef2bd383ab08f2045c6611b5d6c5b5ade3488864a4ee9a12945b0929878d9a83a497aeab0933da7ff1be4d9818d34f103bed134231
6
+ metadata.gz: 803ebc0900b8ce4ea49f94d0ef3f058075494894576c06975354d22024deba6485d4d3ff516711471af1231c28336085c80d88cb267fa0a77a20f6e41fcdaeaf
7
+ data.tar.gz: 351edeedeb2ead0adf9c2b653d1c80f60b54367c11a06334df2f64f352d3edf86397b62a4a8c119b6b6f8c79f049efa7d8719c75ac72d52678badbf2faa5c2c2
data/Gemfile.lock CHANGED
@@ -1,7 +1,7 @@
1
1
  PATH
2
2
  remote: .
3
3
  specs:
4
- avo (4.4.1)
4
+ avo (4.4.3)
5
5
  actionview (>= 6.1)
6
6
  active_link_to
7
7
  activerecord (>= 6.1)
@@ -12605,23 +12605,44 @@ tag.tagify__tag {
12605
12605
  border-block-end: 2px solid var(--sidebar-link-active-background);
12606
12606
  }
12607
12607
  .sidebar-profile {
12608
- display: flex;
12609
- align-items: center;
12610
- gap: calc(var(--spacing) * 4);
12611
- padding-inline: calc(var(--spacing) * 4);
12612
- padding-block: calc(var(--spacing) * 2);
12613
- &:where(:dir(rtl), [dir="rtl"], [dir="rtl"] *) {
12614
- flex-direction: row-reverse;
12615
- }
12608
+ position: relative;
12609
+ padding-inline: calc(var(--spacing) * 2);
12610
+ padding-block: var(--spacing);
12616
12611
  color: var(--sidebar-content);
12617
12612
  }
12618
- .sidebar-profile__body {
12613
+ .sidebar-profile .popover-menu {
12614
+ display: flex;
12615
+ width: 100%;
12616
+ }
12617
+ .sidebar-profile__trigger {
12619
12618
  display: flex;
12620
12619
  width: 100%;
12621
12620
  min-width: 0px;
12622
- flex: 1;
12621
+ cursor: pointer;
12623
12622
  align-items: center;
12624
12623
  gap: calc(var(--spacing) * 2);
12624
+ border-radius: var(--radius-lg);
12625
+ padding-inline: calc(var(--spacing) * 2);
12626
+ padding-block: var(--spacing);
12627
+ text-align: start;
12628
+ }
12629
+ .sidebar-profile__trigger:hover, .sidebar-profile__trigger:has(+ :popover-open) {
12630
+ background-color: var(--sidebar-link-hover-background);
12631
+ }
12632
+ .sidebar-profile__trigger:focus-visible {
12633
+ background-color: var(--sidebar-focus-background);
12634
+ }
12635
+ .sidebar-profile__chevron {
12636
+ position: relative;
12637
+ display: inline-flex;
12638
+ width: calc(var(--spacing) * 4);
12639
+ height: calc(var(--spacing) * 4);
12640
+ flex-shrink: 0;
12641
+ }
12642
+ .sidebar-profile__chevron svg {
12643
+ width: calc(var(--spacing) * 4);
12644
+ height: calc(var(--spacing) * 4);
12645
+ opacity: 60%;
12625
12646
  }
12626
12647
  .sidebar-profile__avatar-wrapper {
12627
12648
  display: flex;
@@ -12667,38 +12688,31 @@ tag.tagify__tag {
12667
12688
  .sidebar-profile__info {
12668
12689
  display: flex;
12669
12690
  min-width: 0px;
12691
+ flex: 1;
12670
12692
  flex-direction: column;
12671
- &:where(:dir(rtl), [dir="rtl"], [dir="rtl"] *) {
12672
- text-align: end;
12673
- }
12674
12693
  }
12675
12694
  .sidebar-profile__title {
12676
12695
  overflow: hidden;
12696
+ text-overflow: ellipsis;
12697
+ white-space: nowrap;
12677
12698
  font-size: var(--text-sm);
12678
12699
  line-height: var(--tw-leading, var(--text-sm--line-height));
12679
12700
  --tw-leading: calc(var(--spacing) * 5);
12680
12701
  line-height: calc(var(--spacing) * 5);
12681
12702
  --tw-font-weight: var(--font-weight-medium);
12682
12703
  font-weight: var(--font-weight-medium);
12683
- text-overflow: ellipsis;
12684
12704
  color: var(--sidebar-content);
12685
12705
  }
12686
12706
  .sidebar-profile__subtitle {
12687
12707
  overflow: hidden;
12708
+ text-overflow: ellipsis;
12709
+ white-space: nowrap;
12688
12710
  font-size: var(--text-xs);
12689
12711
  line-height: var(--tw-leading, var(--text-xs--line-height));
12690
12712
  --tw-leading: calc(var(--spacing) * 4);
12691
12713
  line-height: calc(var(--spacing) * 4);
12692
- text-overflow: ellipsis;
12693
12714
  color: var(--sidebar-content-secondary);
12694
12715
  }
12695
- .sidebar-profile__actions {
12696
- display: flex;
12697
- flex-shrink: 0;
12698
- align-items: center;
12699
- justify-content: center;
12700
- gap: var(--spacing);
12701
- }
12702
12716
  .sidebar-profile__form {
12703
12717
  display: flex;
12704
12718
  width: 100%;
@@ -12708,7 +12722,8 @@ tag.tagify__tag {
12708
12722
  @media (width >= 40rem) {
12709
12723
  max-width: var(--container-sm);
12710
12724
  }
12711
- position-area: top span-right;
12725
+ position-area: block-start span-inline-end;
12726
+ min-width: anchor-size(width);
12712
12727
  transform: translateY(0.25rem);
12713
12728
  }
12714
12729
  @starting-style {
@@ -12743,44 +12758,22 @@ tag.tagify__tag {
12743
12758
  }
12744
12759
  }
12745
12760
  .sidebar-status {
12746
- display: inline-flex;
12747
- width: calc(var(--spacing) * 6);
12748
- height: calc(var(--spacing) * 6);
12749
- flex-shrink: 0;
12750
- align-items: center;
12751
- justify-content: center;
12752
- border-radius: calc(infinity * 1px);
12753
- }
12754
- .sidebar-status:focus-visible {
12755
- outline: 2px solid var(--color-accent-content);
12756
- }
12757
- .sidebar-status__indicator {
12758
- width: calc(var(--spacing) * 2.5);
12759
- height: calc(var(--spacing) * 2.5);
12761
+ position: absolute;
12762
+ inset-inline-end: calc(var(--spacing) * -0.5);
12763
+ top: calc(var(--spacing) * 0.5);
12764
+ width: calc(var(--spacing) * 1.5);
12765
+ height: calc(var(--spacing) * 1.5);
12760
12766
  border-radius: calc(infinity * 1px);
12761
12767
  }
12762
- .sidebar-status__indicator--ok {
12768
+ .sidebar-status--ok {
12763
12769
  background-color: var(--color-green-400);
12764
12770
  }
12765
- .sidebar-status__indicator--error {
12771
+ .sidebar-status--error {
12766
12772
  background-color: var(--color-orange-400);
12767
12773
  }
12768
- .sidebar-status__indicator--warning {
12774
+ .sidebar-status--warning {
12769
12775
  background-color: var(--color-amber-400);
12770
12776
  }
12771
- .sidebar-status__hint {
12772
- position: absolute;
12773
- margin-inline-start: calc(var(--spacing) * -4);
12774
- display: none;
12775
- width: 100%;
12776
- text-align: center;
12777
- font-size: var(--text-xs);
12778
- line-height: var(--tw-leading, var(--text-xs--line-height));
12779
- color: var(--sidebar-content-secondary);
12780
- }
12781
- .sidebar-status:hover .sidebar-status__hint {
12782
- display: block;
12783
- }
12784
12777
  .sidebar-flyout {
12785
12778
  width: 100%;
12786
12779
  }
@@ -381,13 +381,36 @@
381
381
  /* BEM: .sidebar-profile (block) */
382
382
  /* ================================================ */
383
383
 
384
+ /* px-2 + the trigger's px-2 keep the row's old inset while the trigger's hover background fills it. */
384
385
  .sidebar-profile {
385
- @apply flex items-center rtl:flex-row-reverse px-4 py-2 gap-4;
386
+ @apply relative px-2 py-1;
386
387
  color: var(--sidebar-content);
387
388
  }
388
389
 
389
- .sidebar-profile__body {
390
- @apply flex flex-1 items-center gap-2 w-full min-w-0;
390
+ .sidebar-profile .popover-menu {
391
+ @apply flex w-full;
392
+ }
393
+
394
+ .sidebar-profile__trigger {
395
+ @apply flex items-center gap-2 w-full min-w-0 px-2 py-1 rounded-lg text-start cursor-pointer;
396
+ }
397
+
398
+ .sidebar-profile__trigger:hover,
399
+ .sidebar-profile__trigger:has(+ :popover-open) {
400
+ background-color: var(--sidebar-link-hover-background);
401
+ }
402
+
403
+ .sidebar-profile__trigger:focus-visible {
404
+ background-color: var(--sidebar-focus-background);
405
+ }
406
+
407
+ .sidebar-profile__chevron {
408
+ @apply relative inline-flex shrink-0 size-4;
409
+ }
410
+
411
+ /* Dims the icon only, so the status badge keeps its full color. */
412
+ .sidebar-profile__chevron svg {
413
+ @apply size-4 opacity-60;
391
414
  }
392
415
 
393
416
  .sidebar-profile__avatar-wrapper {
@@ -410,30 +433,28 @@
410
433
  }
411
434
 
412
435
  .sidebar-profile__info {
413
- @apply flex flex-col min-w-0 rtl:text-end;
436
+ @apply flex flex-col flex-1 min-w-0;
414
437
  }
415
438
 
416
439
  .sidebar-profile__title {
417
- @apply font-medium text-ellipsis overflow-hidden text-sm leading-5;
440
+ @apply font-medium truncate text-sm leading-5;
418
441
  color: var(--sidebar-content);
419
442
  }
420
443
 
421
444
  .sidebar-profile__subtitle {
422
- @apply text-xs text-ellipsis overflow-hidden leading-4;
445
+ @apply text-xs truncate leading-4;
423
446
  color: var(--sidebar-content-secondary);
424
447
  }
425
448
 
426
- .sidebar-profile__actions {
427
- @apply flex items-center justify-center gap-1 shrink-0;
428
- }
429
-
430
449
  .sidebar-profile__form {
431
450
  @apply flex w-full;
432
451
  }
433
452
 
434
453
  .sidebar-profile__dropdown {
435
454
  @apply sm:max-w-sm mb-0.5;
436
- position-area: top span-right;
455
+ /* Starts at the row's start edge and is at least as wide as the row (the trigger is the anchor). */
456
+ position-area: block-start span-inline-end;
457
+ min-width: anchor-size(width);
437
458
 
438
459
  /* The profile menu opens upward, so it should rise from below and drop back
439
460
  down — the inverse of the shared `.popover-menu__panel` slide, which starts
@@ -484,40 +505,23 @@
484
505
  /* BEM: .sidebar-status (block) */
485
506
  /* ================================================ */
486
507
 
487
- /* Just the dot, between the user's name and the profile menu. */
508
+ /* Hangs past the chevron's end edge, beside the upper arrow rather than on it, so the icon stays whole. */
488
509
  .sidebar-status {
489
- @apply inline-flex items-center justify-center shrink-0 size-6 rounded-full;
490
- }
491
-
492
- .sidebar-status:focus-visible {
493
- outline: 2px solid var(--color-accent-content);
494
- }
495
-
496
- .sidebar-status__indicator {
497
- @apply rounded-full size-2.5;
510
+ @apply absolute top-0.5 -end-0.5 size-1.5 rounded-full;
498
511
  }
499
512
 
500
- .sidebar-status__indicator--ok {
513
+ .sidebar-status--ok {
501
514
  @apply bg-green-400;
502
515
  }
503
516
 
504
- .sidebar-status__indicator--error {
517
+ .sidebar-status--error {
505
518
  @apply bg-orange-400;
506
519
  }
507
520
 
508
- .sidebar-status__indicator--warning {
521
+ .sidebar-status--warning {
509
522
  @apply bg-amber-400;
510
523
  }
511
524
 
512
- .sidebar-status__hint {
513
- @apply absolute text-xs hidden text-center w-full -ms-4;
514
- color: var(--sidebar-content-secondary);
515
- }
516
-
517
- .sidebar-status:hover .sidebar-status__hint {
518
- @apply block;
519
- }
520
-
521
525
  /* ================================================ */
522
526
  /* Sidebar Flyout — ItemSwitcherComponent */
523
527
  /* BEM: .sidebar-flyout (block) */
@@ -1,33 +1,37 @@
1
1
  <%= render ui.panel(title: "Avo Status", description: "Use this page to debug your Avo instance.") do |panel| %>
2
2
  <% panel.with_body do %>
3
3
  <div class="status-page">
4
- <%= render ui.card(title: "License", padded: true) do |card| %>
5
- <% card.with_body do %>
6
- <div class="status-page__license">
7
- <%= render ui.badge(label: "Community", color: :success, icon: "tabler/outline/rosette-discount-check") %>
8
- <dl class="status-page__details">
9
- <% information_items.each do |key, value| %>
10
- <div class="status-page__detail">
11
- <dt class="status-page__detail-label"><%= key.humanize %></dt>
12
- <dd class="status-page__detail-value"><%= value.presence || tag.span("Not set", class: "status-page__detail-empty") %></dd>
13
- </div>
4
+ <% if license_card? %>
5
+ <%= license_card %>
6
+ <% else %>
7
+ <%= render ui.card(title: "License", padded: true) do |card| %>
8
+ <% card.with_body do %>
9
+ <div class="status-page__license">
10
+ <%= render ui.badge(label: "Community", color: :success, icon: "tabler/outline/rosette-discount-check") %>
11
+ <dl class="status-page__details">
12
+ <% information_items.each do |key, value| %>
13
+ <div class="status-page__detail">
14
+ <dt class="status-page__detail-label"><%= key.humanize %></dt>
15
+ <dd class="status-page__detail-value"><%= value.presence || tag.span("Not set", class: "status-page__detail-empty") %></dd>
16
+ </div>
17
+ <% end %>
18
+ </dl>
19
+ </div>
20
+ <% end %>
21
+ <% card.with_footer do %>
22
+ <div class="status-page__upgrade">
23
+ <p class="status-page__upgrade-text">
24
+ Need more? Pick your license, then open its <strong>Upgrade</strong> section.
25
+ </p>
26
+ <%= a_link "https://avohq.io/licenses", style: :primary, color: :blue, size: :sm, target: "_blank", icon: "tabler/outline/external-link" do %>
27
+ View licenses
14
28
  <% end %>
15
- </dl>
16
- </div>
17
- <% end %>
18
- <% card.with_footer do %>
19
- <div class="status-page__upgrade">
20
- <p class="status-page__upgrade-text">
21
- Need more? Pick your license, then open its <strong>Upgrade</strong> section.
22
- </p>
23
- <%= a_link "https://avohq.io/licenses", style: :primary, color: :blue, size: :sm, target: "_blank", icon: "tabler/outline/external-link" do %>
24
- View licenses
25
- <% end %>
26
- </div>
29
+ </div>
30
+ <% end %>
27
31
  <% end %>
28
32
  <% end %>
29
33
 
30
- <%= render Avo::Debug::PluginsComponent.new %>
34
+ <%= render Avo::Debug::PluginsComponent.new(row_extra: @plugin_row_extra) %>
31
35
 
32
36
  <% if Avo::IN_DEVELOPMENT %>
33
37
  <%= render ui.card(title: "Telemetry", description: "The payload sent to HQ. Shown only when AVO_IN_DEVELOPMENT=1.", class: "status-page__wide") do |card| %>
@@ -3,6 +3,10 @@
3
3
  class Avo::Debug::StatusComponent < Avo::BaseComponent
4
4
  include Avo::ApplicationHelper
5
5
 
6
+ # A host page that knows more about the license fills these, so it reuses this layout instead of drawing its own.
7
+ renders_one :license_card
8
+ prop :plugin_row_extra
9
+
6
10
  def information_items
7
11
  @information_items ||= {
8
12
  license_key: Avo.configuration.license_key,
@@ -1,66 +1,54 @@
1
1
  <div class="sidebar-profile">
2
- <div class="sidebar-profile__body">
3
- <div class="sidebar-profile__avatar-wrapper">
4
- <div class="sidebar-profile__avatar">
5
- <% if avatar.present? %>
6
- <%= image_tag helpers.main_app.url_for(avatar), class: "sidebar-profile__avatar-img" %>
7
- <% else %>
8
- <span class="sidebar-profile__avatar-initials">
9
- <%= initials %>
2
+ <%= render Avo::UI::DropdownComponent.new(popover_mode: true, classes: "sidebar-profile__dropdown") do |component| %>
3
+ <% component.with_trigger do %>
4
+ <%# The whole row opens the menu, so the menu anchors to the row and takes its width. %>
5
+ <button type="button" class="sidebar-profile__trigger" popovertarget="<%= component.popover_id %>">
6
+ <span class="sidebar-profile__avatar-wrapper">
7
+ <span class="sidebar-profile__avatar">
8
+ <% if avatar.present? %>
9
+ <%= image_tag helpers.main_app.url_for(avatar), class: "sidebar-profile__avatar-img", alt: "" %>
10
+ <% else %>
11
+ <span class="sidebar-profile__avatar-initials"><%= initials %></span>
12
+ <% end %>
10
13
  </span>
11
- <% end %>
12
- </div>
13
- </div>
14
- <div class="sidebar-profile__info">
15
- <div class="sidebar-profile__title">
16
- <%= name %>
17
- </div>
18
- <% if title.present? %>
19
- <div class="sidebar-profile__subtitle">
20
- <%= title %>
21
- </div>
22
- <% end %>
23
- </div>
24
- </div>
25
- <% if @show_status %>
26
- <%= link_to helpers.avo.status_path,
27
- class: "sidebar-status",
28
- title: "Avo Status",
29
- aria: {label: "Avo Status: #{Avo.app_status}"},
30
- data: {tippy: "tooltip"} do %>
31
- <span class="sidebar-status__indicator sidebar-status__indicator--<%= Avo.app_status %>"></span>
14
+ </span>
15
+ <span class="sidebar-profile__info">
16
+ <span class="sidebar-profile__title"><%= name %></span>
17
+ <% if title.present? %>
18
+ <span class="sidebar-profile__subtitle"><%= title %></span>
19
+ <% end %>
20
+ </span>
21
+ <span class="sidebar-profile__chevron">
22
+ <%= helpers.svg "tabler/outline/selector" %>
23
+ <% if @show_status %>
24
+ <span class="sidebar-status sidebar-status--<%= Avo.app_status %>"></span>
25
+ <span class="sr-only">Avo Status: <%= Avo.app_status %></span>
26
+ <% end %>
27
+ </span>
28
+ </button>
32
29
  <% end %>
33
- <% end %>
34
- <div class="sidebar-profile__actions">
35
- <%= render Avo::UI::DropdownComponent.new(popover_mode: true, classes: "sidebar-profile__dropdown") do |component| %>
36
- <% component.with_trigger do %>
37
- <%= render Avo::ButtonComponent.new(
38
- icon: "tabler/outline/dots",
39
- size: :md,
40
- style: :text,
41
- popovertarget: component.popover_id
42
- ) %>
30
+ <% component.with_items do %>
31
+ <% if render_custom_profile_menu? %>
32
+ <%= render custom_profile_component %>
43
33
  <% end %>
44
- <% component.with_items do %>
45
- <% if render_custom_profile_menu? %>
46
- <%= render custom_profile_component %>
47
- <% end %>
48
- <%= render "avo/partials/profile_menu_extra" %>
49
- <% if can_sign_out_user? %>
50
- <%= form_with url: helpers.main_app.send(sign_out_path),
51
- method: sign_out_method,
52
- data: {
53
- controller: :"sign-out",
54
- sign_out_confirm_value: t('avo.are_you_sure'),
55
- action: "submit->sign-out#handle",
56
- },
57
- class: 'sidebar-profile__form' do |form| %>
58
- <%= form.button turbo_confirm: t('avo.are_you_sure'), class: "sidebar-profile__sign-out" do %>
59
- <%= helpers.svg "tabler/outline/logout", class: 'sidebar-icon' %> <span class="truncate min-w-0"><%= t('avo.sign_out') %></span>
60
- <% end %>
34
+ <%= render "avo/partials/profile_menu_extra" %>
35
+ <% if @show_status %>
36
+ <%= render Avo::ProfileItemComponent.new label: "Avo Status", path: helpers.avo.status_path, icon: "tabler/outline/activity-heartbeat" %>
37
+ <% end %>
38
+ <% if can_sign_out_user? %>
39
+ <%= form_with url: helpers.main_app.send(sign_out_path),
40
+ method: sign_out_method,
41
+ data: {
42
+ controller: :"sign-out",
43
+ sign_out_confirm_value: t("avo.are_you_sure"),
44
+ action: "submit->sign-out#handle"
45
+ },
46
+ class: "sidebar-profile__form" do |form| %>
47
+ <%= form.button turbo_confirm: t("avo.are_you_sure"), class: "sidebar-profile__sign-out" do %>
48
+ <%= helpers.svg "tabler/outline/logout", class: "sidebar-icon" %> <span class="truncate min-w-0"><%= t("avo.sign_out") %></span>
61
49
  <% end %>
62
50
  <% end %>
63
51
  <% end %>
64
52
  <% end %>
65
- </div>
53
+ <% end %>
66
54
  </div>
@@ -171,7 +171,7 @@ def handle(query:, fields:, **args)
171
171
  end
172
172
  ```
173
173
 
174
- **Picking an associated record.** A `belongs_to` field needs *one* current record to resolve its association, so it only renders when the action was hydrated with a single record — from **Show**, or with exactly one row checked on **Index**. On a multi-record or standalone action there is no current record and the field can't render. Use a plain input instead:
174
+ **Picking an associated record.** A `belongs_to` field renders in the action modal wherever the action starts: **Show**, one or several rows on **Index**, or a standalone action with no record. On a single record it opens with that record's association preselected. Before `avo` 4.2.9 it rendered only with exactly one record, so older apps guard it with `visible: -> { resource.record.present? }` (drop the guard on 4.2.9+). For a value that isn't an association, use a plain input:
175
175
 
176
176
  ```ruby
177
177
  # Short list — a select with the options loaded when the form renders.
@@ -270,7 +270,8 @@ When an index spans multiple pages, checking "Select all" offers to select **eve
270
270
  URI.parse(request.referer).query.to_s.include?("hey=ya") ? :yes : :no
271
271
  }
272
272
  ```
273
- - **`belongs_to` doesn't render in a bulk or standalone action.** It needs a single current record to resolve the association, which a multi-record or standalone action doesn't have. Reach for `as: :select` (short list) or `as: :tags, mode: :select, fetch_values_from: "..."` (long, searchable) and assign the ID yourself in `handle`.
273
+ - **A `belongs_to` field arrives in `handle` under its foreign key.** `field :user, as: :belongs_to` is `fields[:user_id]`; a polymorphic one arrives as `fields[:reviewable_type]` and `fields[:reviewable_id]` (4.2.7+). Both are the submitted strings, and an action does not check the type against the field's `types`, so validate it before constantizing. On `avo` older than 4.2.9 the field doesn't render in a bulk or standalone action: use `as: :select` or `as: :tags, mode: :select, fetch_values_from: "..."` and assign the ID yourself.
274
+ - **Actions also run from association panels (4.3.3+).** A `has_many` or `has_and_belongs_to_many` panel offers the actions declared on the *associated* resource, on the rows checked in the panel. `record` is `nil` while the dropdown renders (as on Index), so `name` and `arguments` blocks must handle that; the panel's parent record reaches `visible` as `parent_resource.record` (`parent_resource` is `nil` outside a panel).
274
275
  - **`reload_records` is Index-only.** It doesn't work on association tables — use `reload` there.
275
276
  - **Notification bodies truncate at ~320 characters.** Keep `succeed`/`error` messages short; put long output in a `download` or a redirect.
276
277
  - **File downloads need `self.turbo = false`.** Otherwise Turbo intercepts the response and the download won't fire.
@@ -106,7 +106,7 @@ If the user mentions the Rails 8 scaffold (or you see `Current.user` + an `Authe
106
106
 
107
107
  Avo ships two deliberately minimal roles, resolved by calling a method on the `current_user`:
108
108
 
109
- - `is_admin?` → the user can reach the private **Avo Status** page (`/status`, under your mount path) and sees its sidebar link in production.
109
+ - `is_admin?` → the user can reach the private **Avo Status** page (`/status`, under your mount path) and sees its item in the sidebar profile menu in production.
110
110
  - `is_developer?` → same Status-page access, **plus** full backtraces on non-validation errors (e.g. an API call that blows up during save) instead of a generic "Something went wrong".
111
111
 
112
112
  Check them yourself anywhere with `Avo::Current.user_is_admin?` / `Avo::Current.user_is_developer?`. Point Avo at differently-named predicate methods via the initializer:
@@ -141,7 +141,7 @@ end
141
141
 
142
142
  ### 6. The sign-out link
143
143
 
144
- The sign-out item lives in the sidebar footer's three-dots menu. Avo shows it automatically if your app responds to `destroy_user_session_path` (the Devise default). Otherwise it's hidden until you name the path. Two knobs:
144
+ The sign-out item lives in the profile menu, opened by clicking the user's row in the sidebar footer. Avo shows it automatically if your app responds to `destroy_user_session_path` (the Devise default). Otherwise it's hidden until you name the path. Two knobs:
145
145
 
146
146
  ```ruby
147
147
  # config/initializers/avo.rb
@@ -482,7 +482,7 @@ end
482
482
  `Avo.plugin_manager` API:
483
483
 
484
484
  - `register(name, priority: 10)` — add to the plugin list (lower priority runs earlier).
485
- - `register_view_type(name, component:, icon:, active_icon:)` — a new index view type. **Pass `component:` as a string** (`"MyPlugin::ViewTypes::TimelineViewTypeComponent"`) to dodge boot load-order issues; the component inherits `Avo::ViewTypes::BaseViewTypeComponent` and must render `paginator_component`. It only gets `collection`, `records` and `pagination` slots where its template calls `render_index_slot`, passing the default markup as the block for replacements. Enabling it on a resource is **avo-index-views** (`self.view_types` / `self.default_view_type`).
485
+ - `register_view_type(name, component:, icon:, active_icon:)` — a new index view type. **Pass `component:` as a string** (`"MyPlugin::ViewTypes::TimelineViewTypeComponent"`) to dodge boot load-order issues; the component inherits `Avo::ViewTypes::BaseViewTypeComponent` and must render `paginator_component` and keep its list inside `<turbo-frame id="<%= list_frame_id %>">`. Name the list's frame with `list_frame_id` (not the `turbo_frame` prop, which is the surrounding frame passed on to the paginator) and the selection data attributes (`data-resource-name`, `data-selected-resources-name`) with `resource_name_for(@resource)`, never `@resource.model_key` (4.3.4+): inside an association panel both use the association field's id, so two panels on one page don't collide. It only gets `collection`, `records` and `pagination` slots where its template calls `render_index_slot`, passing the default markup as the block for replacements. Enabling it on a resource is **avo-index-views** (`self.view_types` / `self.default_view_type`).
486
486
  - `register_field(method_name, klass)` — ship a field *type* from a gem (the plugin-author side of **avo-custom-fields**).
487
487
  - `register_menu_item(name, &block)` — a custom menu DSL method for `config.main_menu`. Delegates to `avo-menu`; **no-op when avo-menu isn't installed**, so register unconditionally.
488
488
  - `register_configuration(name, klass)` — add a `config.<name>` namespace to `Avo::Configuration` backed by an instance of `klass`, so host apps configure the plugin from the same `config/initializers/avo.rb` they already use. **The one call that must not go in `avo_boot`** — see below.
@@ -520,6 +520,7 @@ Assets from library code go through `Avo.asset_manager` (not the app pipeline);
520
520
  - **Custom tool vs. resource tool vs. new field.** Standalone page → custom tool. Widget on a record's Show/Edit → resource tool. A new *input type* used across resources → **avo-custom-fields** (not this).
521
521
  - **Ejected files are frozen copies — you own them forever.** They stop receiving upstream updates; Avo bug/security fixes won't reach your copy. Prefer [view slots](#view-slots), CSS-variable / Tailwind-layer overrides and `--scope` (so you don't replace a component everywhere) before ejecting whole components.
522
522
  - **A slot replacement that skips its default skips the nested hooks too.** Replacing `:header` without `default_content.call` also drops the title and controls and their hooks. Replacing `:collection` the same way drops `records` and `pagination`.
523
+ - **Live search refreshes `collection`, `records` and `pagination` slots, not `toolbar` ones.** Put a summary that must follow the search and page in a collection or records slot. On an empty index core renders the shared empty state with `collection` and `records` hooks only, no `pagination`. Map view's collection hooks wrap only its optional embedded table.
523
524
  - **Index slots of a resource also fire on its has-many panels** on a parent's page. Return `nil` when `parent_record` is present if the content only belongs on the main index.
524
525
  - **`controls` hooks run twice when `buttons_on_form_footers` is on**, once in the header and once in the footer, so a fixed HTML id can be duplicated.
525
526
  - **The toolbar doesn't refresh on live search.** Put a summary that follows the search in a `collection`, `records` or `pagination` hook.
@@ -536,6 +537,7 @@ Assets from library code go through `Avo.asset_manager` (not the app pipeline);
536
537
  - **`avo-overrides.css` is served as-is — NOT compiled by Tailwind.** `@apply` and utility classes won't be generated there; it's for raw CSS and CSS-variable overrides. Put Tailwind-using CSS under `app/assets/stylesheets/avo/`.
537
538
  - **Tailwind integration silently stays off** unless `tailwindcss-ruby` is present, and — if you pull Tailwind via `tailwindcss-rails` — that gem is **>= 4.0** (on 3.x the integration is disabled even though `tailwindcss-ruby` is there). Symptom: your utility classes don't exist in the admin.
538
539
  - **New JS/CSS not loading?** You skipped the asset-pipeline entrypoint. Run `avo:js:install` (or wire `avo.custom.js` manually) — `self.stimulus_controllers` alone loads nothing.
540
+ - **`avo_boot` must not load app classes.** It runs while the app initializes, and naming a controller, component or model there loads Action Controller, Action View or Active Record early (Rails 8.2 flags it). Extend Avo's `lib/` classes (resources, fields, managers) in the hook; extend controllers, components and helpers from `Rails.autoloaders.main.on_load("Avo::BaseController") { |klass, _| klass.prepend ... }`; extend models from `ActiveSupport.on_load(:active_record)`. It also re-runs on each code reload in development.
539
541
  - **Plugin registration must be inside `ActiveSupport.on_load(:avo_boot)`** — with one exception: `register_configuration` runs **too late** there and must go in an engine initializer ordered `before: :load_config_initializers`. `register_view_type`'s `component:` should be a **string**, and `register_menu_item` is a no-op without `avo-menu`.
540
542
 
541
543
  ## Report
@@ -233,7 +233,7 @@ Make it the default with `self.default_view_type = :map`.
233
233
 
234
234
  Not a view type — a table affordance. Checking the header "Select all" checkbox and confirming "select all matching" lets an action run on **every record the current query matches**, across all pages, not just the visible page. Avo serializes (and encrypts) the whole query — filters, sorting, scopes — and reconstructs it inside the action.
235
235
 
236
- It works out of the box on the table view; nothing to enable on the resource. The action itself is where the selection is consumed — cross-link the **avo-actions** skill for writing/handling the action. If serialization fails, Avo silently disables select-all rather than crashing (see the `normalizes` gotcha below).
236
+ It works out of the box on the table view and, from `avo` 4.3.10, on the grid view (a bar above the cards with the page checkbox, "Select all matching" and Undo); nothing to enable on the resource. A resource that sets `self.record_selector` to hide checkboxes renders no bar. The action itself is where the selection is consumed — cross-link the **avo-actions** skill for writing/handling the action. If serialization fails, Avo silently disables select-all rather than crashing (see the `normalizes` gotcha below).
237
237
 
238
238
  **Coming back to the index (4.3.1+):** going Back (browser Back or the record page's **Go back** link) re-checks the rows that were selected and restores scroll. The selection is kept per browser tab and per URL (filters, sort, page), is forgotten after running an action or on reload, and a "Select all matching" choice is not kept. With `config.persistence = { driver: :session }` (4.3.11+) the selection is kept per page rather than per URL and comes back however you reach the index; turn it off with `selection: false`. System specs that expect nothing selected after **Go back** will now find rows checked.
239
239
 
@@ -254,7 +254,7 @@ class Avo::Resources::Project < Avo::BaseResource
254
254
  end
255
255
  ```
256
256
 
257
- `cards` means the resource's dashboard cards, not grid items. Blocks run once per region, not per row: use `row_options` to change rows.
257
+ `cards` means the resource's dashboard cards, not grid items. Collection, records and pagination slots refresh with live search; toolbar, cards and header ones don't. Blocks run once per region, not per row: use `row_options` to change rows.
258
258
 
259
259
  The **avo-custom-ui** skill's **View slots** section has the full reference, Show/Edit/New, block context and gotchas.
260
260
 
@@ -221,7 +221,7 @@ A license authorizes **one app, one production URL** (`Rails.env.production?`).
221
221
 
222
222
  Verify at the **status page**: `https://yourapp.com/<mount-path>/status` (e.g. `.../avo/status` or `.../admin/status`). It shows whether the license authenticated and what the checking server returned; the key is masked unless you set `config.exclude_from_status = []`. The viewing user must be an Avo admin. Deep failure diagnosis (unlicensed after deploy, timeouts, test-suite blocking the check host) is the **avo-troubleshoot** skill.
223
223
 
224
- **Trials are full licenses.** Every add-on a trial covers behaves exactly as it does on a paid license while the trial runs — nothing is gated or degraded. The **Avo Status** indicator in the sidebar footer is green when all is well, **amber** when a trial needs attention, and orange when the license is invalid. Amber is not a failure: the status page names why, and the fix is on https://avohq.io/licenses. The **avo-troubleshoot** skill lists each case and its fix. Avo caches the license response between checks, so press **Refresh license** on the status page afterwards or the app keeps showing the older billing state. Trial state needs `avo-licensing` **4.0.10+**; the amber indicator needs Avo **4.0.20+** (an older Avo renders an uncolored dot rather than breaking).
224
+ **Trials are full licenses.** Every add-on a trial covers behaves exactly as it does on a paid license while the trial runs — nothing is gated or degraded. The **Avo Status** badge on the profile menu button in the sidebar footer is green when all is well, **amber** when a trial needs attention, and orange when the license is invalid. Amber is not a failure: the status page names why, and the fix is on https://avohq.io/licenses. The **avo-troubleshoot** skill lists each case and its fix. Avo caches the license response between checks, so press **Refresh license** on the status page afterwards or the app keeps showing the older billing state. Trial state needs `avo-licensing` **4.0.10+**; the amber indicator needs Avo **4.0.20+** (an older Avo renders an uncolored dot rather than breaking).
225
225
 
226
226
  ### 7. (Optional) Append your own routes inside the engine
227
227
 
@@ -66,7 +66,7 @@ grep -n "avo" Gemfile
66
66
  bin/rails avo:update # or: bundle exec rails avo:update
67
67
  ```
68
68
 
69
- The task resolves Avo core plus every registered Avo plugin to its real gem name and runs `bundle update --conservative <those gems>` — `--conservative` so it doesn't drag unrelated shared dependencies along. Read its output: it echoes the exact `bundle update` command it ran.
69
+ The task resolves Avo core plus every registered Avo plugin to its real gem name and runs `bundle update --conservative <those gems>` — `--conservative` so it doesn't drag unrelated shared dependencies along. Read its output: it echoes the exact `bundle update` command it ran. From `avo` 4.3.10, `AVO_UPDATE_PUSH=1 bin/rails avo:update` also commits `Gemfile.lock` (message `Update Avo gems`) and pushes to the branch's upstream, for scheduled jobs and agents. It refuses to start outside a Git repo, with uncommitted changes to tracked files, or on a branch with no upstream; run it on a branch you're happy to push to, not the deploy branch.
70
70
 
71
71
  If the task isn't available (older Avo, or the app won't boot), fall back to naming the gems yourself:
72
72
 
@@ -147,7 +147,7 @@ Check the project's own instructions for how — in this order: `AGENTS.md`, `CL
147
147
  | Command | Does |
148
148
  | --- | --- |
149
149
  | `grep -E "^ {4}avo(-[a-z_]+)? \(" Gemfile.lock` | Current version of every Avo gem — run **before** updating |
150
- | `bin/rails avo:update` | `bundle update --conservative` across Avo core + every registered plugin |
150
+ | `bin/rails avo:update` | `bundle update --conservative` across Avo core + every registered plugin (`AVO_UPDATE_PUSH=1` also commits and pushes the lockfile) |
151
151
  | `git diff Gemfile.lock \| grep -E "^[-+] {4}avo"` | The actual before → after jump per gem |
152
152
  | `bundle update --conservative avo …` | Manual fallback when the rake task isn't available |
153
153
  | `bundle outdated \| grep avo` | What's available above the current Gemfile constraints |
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "repo": "avo-hq/docs.avohq.io",
3
3
  "docs_path": "docs/4.0",
4
- "commit": "c5b0263dffcea4226e7f1bf2988c36225f2890ce",
5
- "date": "2026-11-02",
4
+ "commit": "c54913692157757c342802a3b9e1d5f167798624",
5
+ "date": "2026-11-09",
6
6
  "note": "The docs commit these skills were last indexed from. Run ruby lib/avo/skills/bin/docs_drift.rb to see what changed since, and --update after a refresh."
7
7
  }
data/lib/avo/version.rb CHANGED
@@ -1,3 +1,3 @@
1
1
  module Avo
2
- VERSION = "4.4.1" unless const_defined?(:VERSION)
2
+ VERSION = "4.4.3" unless const_defined?(:VERSION)
3
3
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: avo
3
3
  version: !ruby/object:Gem::Version
4
- version: 4.4.1
4
+ version: 4.4.3
5
5
  platform: ruby
6
6
  authors:
7
7
  - Adrian Marin