avo 4.1.10 → 4.1.12

data/app/components/avo/field_wrapper_component.rb

@@ -122,12 +122,13 @@ class Avo::FieldWrapperComponent < Avo::BaseComponent
   end
 
   def stacked?
-    # Override on the declaration level
-    return @stacked unless @stacked.nil?
-
-    # Fetch it from the field
+    # The field declaration is the user's explicit intent, so it wins over the
+    # layout default a parent component passes in (sidebars, preview, etc.).
     return @field.stacked unless @field.stacked.nil?
 
+    # Fallback to what the rendering component asked for
+    return @stacked unless @stacked.nil?
+
     # Fallback to defaults
     Avo.configuration.field_wrapper_layout == :stacked
   end

data/app/javascript/js/controllers/filter_controller.js

@@ -81,12 +81,10 @@ export default class extends Controller {
         return obj
       }, {})
 
-    let encodedFilters
-
-    // Encode the filters and their values
-    if (filtered && Object.keys(filtered).length > 0) {
-      encodedFilters = this.encode(filtered)
-    }
+    // Encode the filters and their values. The empty set is encoded too, so
+    // the backend can tell "the user cleared the filters" apart from "the URL
+    // carries no filters" and overwrite the session-persisted value.
+    const encodedFilters = this.encode(filtered)
 
     this.navigateToURLWithFilters(encodedFilters)
   }

data/app/views/avo/base/_boolean_filter.html.erb

@@ -5,7 +5,7 @@
   data-boolean-filter-keep-filters-panel-open-value="<%= @resource.keep_filters_panel_open %>">
   <div class="flex items-center">
     <% if filter.options.empty? %>
-      <div class="filters-section__empty-state"><%= filter.class.empty_message %></div>
+      <div class="filters-section__empty-state"><%= filter.class.get_empty_message %></div>
     <% else %>
       <div class="filters-boolean-options">
         <% filter.options.each do |value, label| %>

data/lib/avo/fields/base_field.rb

@@ -117,7 +117,7 @@ module Avo
 
         @width = args[:width] || 100
 
-        if width_option.present? && width_option != 100
+        if @stacked.nil? && width_option.present? && width_option != 100
           @stacked = true
         end
 

data/lib/avo/skills/avo-fields/SKILL.md

@@ -143,7 +143,7 @@ Every field accepts these common options (full list + types at the field-options
 - **`copyable:`** — clipboard icon on Show/Index. Copies the **displayed** (formatted) value.
 - **`link_to_record:`** — make the Index cell a link to the record. Only on `:id`, `:text`, `:gravatar`, and `belongs_to`.
 - **`for_attribute:`** — back the field with a different attribute than its id (lets you show one column two ways).
-- **`width:`** / **`stacked:`** — column width (`25/33/50/66/75/100`; any value <100 auto-stacks) and label-above-value layout.
+- **`width:`** / **`stacked:`** — column width (`25/33/50/66/75/100`; any value <100 auto-stacks) and label-above-value layout. `stacked:` on the field wins everywhere, so `stacked: false` opts out of the auto-stacking and of sidebars/preview stacking too.
 - **`html:`** — attach `style`/`classes`/`data` to the field's wrapper/label/input per view (e.g. right-align a number: `html: {index: {wrapper: {classes: "text-right"}}}`). See the html page.
 
 ### Computed (block) fields

data/lib/avo/skills/bin/docs_drift.rb

@@ -0,0 +1,91 @@
+#!/usr/bin/env ruby
+# Which docs pages changed since the last indexing run, and which shipped skills
+# cite them. The docs repo already hashes every page for us — its git history
+# *is* the lock file, so `docs-index.json` only has to remember one commit.
+#
+# Audits the skills that ship in this gem (the directories beside this bin/).
+# Add-on gems carry their own skills and are out of this script's scope.
+#
+#   ruby lib/avo/skills/bin/docs_drift.rb               # report; finds the docs checkout itself
+#   ruby lib/avo/skills/bin/docs_drift.rb path/to/docs  # or point it at one ($AVO_DOCS_PATH works too)
+#   ruby lib/avo/skills/bin/docs_drift.rb --update      # mark the checkout's HEAD as indexed
+require "json"
+
+skills_root = File.expand_path("..", __dir__)
+repo_root = File.expand_path("../../..", skills_root)
+marker_path = "#{skills_root}/docs-index.json"
+marker = JSON.parse(File.read(marker_path))
+
+update = ARGV.delete("--update")
+
+def git(dir, *args) = `git -C '#{dir}' #{args.join(" ")}`.strip
+
+# A docs checkout is any clone of the marker's repo that has the docs path in it.
+# Look next to and above this checkout so the script works from whatever layout a
+# machine or CI runner happens to use.
+def find_docs(repo_root, marker)
+  search = ["#{repo_root}/..", "#{repo_root}/../..", "#{repo_root}/../../.."]
+  candidates = search.flat_map { |base| Dir.glob("#{base}/*") }.uniq.sort
+  candidates.find do |dir|
+    next false if dir == repo_root || !Dir.exist?("#{dir}/.git") || !Dir.exist?("#{dir}/#{marker["docs_path"]}")
+
+    git(dir, "remote", "get-url", "origin").include?(marker["repo"])
+  end
+end
+
+docs = ARGV[0] || ENV["AVO_DOCS_PATH"] || find_docs(repo_root, marker)
+
+if docs.nil? || !Dir.exist?("#{docs}/.git")
+  abort "No #{marker["repo"]} checkout found near #{repo_root} — pass its path as an argument or set AVO_DOCS_PATH."
+end
+
+docs = File.expand_path(docs)
+
+head = git(docs, "rev-parse", "HEAD")
+head_date = git(docs, "log", "-1", "--format=%cs", "HEAD")
+
+if update
+  File.write(marker_path, JSON.pretty_generate(marker.merge("commit" => head, "date" => head_date)) + "\n")
+  puts "Indexed at #{head[0, 12]} (#{head_date})."
+  exit
+end
+
+unless git(docs, "cat-file", "-t", marker["commit"]) == "commit"
+  abort "#{docs} doesn't have commit #{marker["commit"]} — `git fetch` it first."
+end
+
+if head == marker["commit"]
+  puts "Up to date with #{head[0, 12]} (#{head_date})."
+  exit
+end
+
+# --no-renames: a renamed page is a delete + an add, which is exactly how a skill
+# citing the old URL has to treat it.
+changed = git(docs, "diff", "--name-status", "--no-renames", "#{marker["commit"]}..HEAD", "--", marker["docs_path"])
+  .lines.map { |line| line.split("\t") }
+  .map { |status, path| [status[0], File.basename(path.strip)] }
+  .reject { |_, page| page == "docs-map.md" }
+  .uniq
+
+# The Docs lines in each SKILL.md are the provenance record. Skills cite pages
+# both with and without the .md extension; normalize to the diff's basename form.
+version = Regexp.escape(File.basename(marker["docs_path"]))
+citations = Dir.glob("#{skills_root}/*/SKILL.md").each_with_object(Hash.new { |h, k| h[k] = [] }) do |path, acc|
+  skill = File.basename(File.dirname(path))
+  File.read(path).scan(%r{docs\.avohq\.io/#{version}/([A-Za-z0-9_/-]+)}).flatten.uniq.each do |page|
+    acc["#{File.basename(page)}.md"] << skill
+  end
+end
+
+puts "#{changed.size} pages changed between #{marker["commit"][0, 12]} (#{marker["date"]}) and #{head[0, 12]} (#{head_date}):", ""
+
+stale = []
+changed.sort_by(&:last).each do |status, page|
+  skills = citations[page]
+  stale.concat(skills)
+  puts "  #{status} #{page.ljust(34)} #{skills.empty? ? "— not cited by any skill" : skills.join(", ")}"
+end
+
+puts "", "Skills to review: #{stale.uniq.sort.join(", ")}" if stale.any?
+puts "", "Commits: git -C #{docs} log --oneline #{marker["commit"][0, 12]}..HEAD -- #{marker["docs_path"]}"
+puts "Then:    ruby lib/avo/skills/bin/docs_drift.rb --update"

data/lib/avo/skills/docs-index.json

@@ -0,0 +1,7 @@
+{
+  "repo": "avo-hq/docs.avohq.io",
+  "docs_path": "docs/4.0",
+  "commit": "3350dbef7b2da94b410d6a678f9551e16901411e",
+  "date": "2026-07-28",
+  "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."
+}

data/lib/avo/version.rb

@@ -1,3 +1,3 @@
 module Avo
-  VERSION = "4.1.10" unless const_defined?(:VERSION)
+  VERSION = "4.1.12" unless const_defined?(:VERSION)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: avo
 version: !ruby/object:Gem::Version
-  version: 4.1.10
+  version: 4.1.12
 platform: ruby
 authors:
 - Adrian Marin
@@ -1123,6 +1123,8 @@ files:
 - lib/avo/skills/avo-troubleshoot/SKILL.md
 - lib/avo/skills/avo-update/SKILL.md
 - lib/avo/skills/bin/avo-skills-resolve
+- lib/avo/skills/bin/docs_drift.rb
+- lib/avo/skills/docs-index.json
 - lib/avo/skills/index.md
 - lib/avo/skills/package-map.md
 - lib/avo/table_row_options.rb