avo 4.2.1 → 4.2.2

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

@@ -74,8 +74,11 @@ es:
         zero: "usuarios"
         one: "usuario"
         other: "usuarios"
+        description: "Los usuarios de la aplicación"
 ```
 
+`description` fills the resource's panel description and, per the cascade, beats `self.description` on the class.
+
 Omit `self.translation_key` and Avo derives it from the class name, **namespace included** — `Avo::Resources::Galaxy::Planet` defaults to `avo.resource_translations.galaxy/planet`. So for a plain resource you often only need the YAML, no Ruby change.
 
 ### 3. Localize an action

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

@@ -119,6 +119,8 @@ class Avo::Resources::User < Avo::BaseResource
 end
 ```
 
+Avo also resolves `description` below the resource's translation key — `avo.resource_translations.user.description` supplies the User resource description. Per the cascade, the locale file **wins** and `self.description` is the fallback, so an app can keep an English default in code and translate over it — **avo-i18n**.
+
 - `self.description` is rendered as **raw HTML** — never feed it user-editable data (stored-XSS risk). A block gets `record`, `resource`, `view`, `current_user`, `params`.
 - `self.color` takes a Symbol or String from Avo's palette — `red`, `orange`, `amber`, `yellow`, `lime`, `green`, `emerald`, `teal`, `cyan`, `sky`, `blue`, `indigo`, `violet`, `purple`, `fuchsia`, `pink`, `rose`. It tints the icon **stroke only** (label and hover/active backgrounds stay neutral), adapts to light and dark themes, and an unknown name silently renders the neutral icon. The tint follows the resource to its breadcrumb initials chip and, with Advanced Search installed, to the resource group headers in global search results. A `color:` on the menu entry overrides it.
 - `self.cover`/`self.avatar` were named `cover_photo`/`profile_photo` in Avo 3. A **Symbol** `source:` renders nothing for unpersisted (new) records — use a block if you want a placeholder on `new`/`index`.
@@ -260,7 +262,7 @@ Search (`self.search`), grid/map view types, record reordering, and i18n live on
 - **Two resources, one model → wrong one wins.** Avo resolves the default alphabetically. Set `config.model_resource_mapping` and/or `use_resource:` on associations.
 - **Secondary / namespaced / oddly-named resources need `self.model_class`** (or the matching namespace) or Avo can't infer the model. Namespaced resources whose namespace matches the model's namespace infer automatically.
 - **Array resources are Beta:** no sorting, and `records` re-runs every request. Cache inside `records` for large sets, or move to an HTTP Resource.
-- **`find_record_method` in batch contexts:** `id` arrives as an Array for bulk actions — return a collection (`query.where(...)`) in that branch, not a single record.
+- **`find_record_method` in batch contexts:** `id` arrives as an Array for bulk actions — return a collection (`query.where(...)`) in that branch, not a single record. If that branch raises `ActiveRecord::RecordNotFound` (as `query.find(id)` does when one record was deleted between selection and submit), Avo retries the **scalar** branch once per id and drops the ones that are gone — so keep the scalar branch able to handle every id the array branch receives.
 - **`visible_on_sidebar` only affects the auto-generated menu.** If the app uses the menu editor, control visibility in its `visible` block instead.
 - **Don't re-invent fields/associations here.** Field DSL is the avo-fields skill; `belongs_to`/`has_many`/`use_resource` is avo-associations.
 - **Verify before writing.** Option names drift between versions — check the docs URLs above or the app's installed Avo source rather than trusting memory.

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

@@ -163,7 +163,7 @@ Check the project's own instructions for how — in this order: `AGENTS.md`, `CL
 - **The update alone is not the upgrade.** Bumping the gems and skipping the guide is the single most common way an admin breaks after an "upgrade" — and the breakage often surfaces days later, in a view nobody opened.
 - **Apply sections oldest → newest.** They're written as a chain; applying 4.0.12's change before 4.0.7's can leave you editing code the earlier section was about to rename.
 - **Silent default flips pass tests.** Sections that change a default (authorization strictness, confirmation modals, expanded filters) break nothing visible in CI and change runtime behavior. Call these out individually.
-- **A section can be triggered by the app's locale files, not its Ruby.** Avo has been moving label resolution so a derived i18n key wins *over* the class attribute — actions in `4.0.17`, then cards, dashboards and scopes in `avo-dashboards` / `avo-scopes` `4.1.2`. Nothing in the app's Ruby changed, so grepping for an API name finds nothing; the trigger is a key the app already defines under `avo.action_translations`, `avo.card_translations`, `avo.dashboard_translations` or `avo.scope_translations`. Where one exists the class attribute stops being read **even when it's a lambda**, which is then never called and computes nothing, with no error. Grep those roots in `config/locales`, and move the collision with `self.translation_key` (or a value at the registration site) rather than deleting the key — **avo-i18n**.
+- **A section can be triggered by the app's locale files, not its Ruby.** Avo has been moving label resolution so a derived i18n key wins *over* the class attribute — actions in `4.0.17`, then cards, dashboards and scopes in `avo-dashboards` / `avo-scopes` `4.1.2`, then resource descriptions in `4.2.2`. Nothing in the app's Ruby changed, so grepping for an API name finds nothing; the trigger is a key the app already defines under `avo.action_translations`, `avo.card_translations`, `avo.dashboard_translations`, `avo.scope_translations`, or `avo.resource_translations.<resource>.description`. Where one exists the class attribute stops being read **even when it's a lambda**, which is then never called and computes nothing, with no error. Grep those roots in `config/locales`, and move the collision with `self.translation_key` (or a value at the registration site) rather than deleting the key — **avo-i18n**.
 - **Add-on gems version independently.** `avo-kanban 0.1.17 → 0.1.18` has its own section even when Avo core barely moved. Work the lock diff, not just the core version.
 - **Assets after upgrade.** A GitHub-sourced install ships no precompiled assets — re-run `rake avo:build-assets` or the admin renders unstyled (**avo-setup**).
 - **Don't invent a migration.** If a version's change isn't in the guide or the release notes, stop and ask rather than guessing at the new API.

data/lib/avo/version.rb

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

data/lib/avo.rb

@@ -102,6 +102,18 @@ module Avo
     end
   end
 
+  # Exception raised when an association field has no matching model association.
+  class MissingAssociationError < StandardError
+    def initialize(model_class, association_name, field)
+      macro = field.type.to_s
+      super(
+        "Failed to find the :#{association_name} association on #{model_class} while rendering the :#{field.id} field.\n" \
+        "Define `#{macro} :#{association_name}` on #{model_class}, or update the Avo field to use an association that exists.\n" \
+        "More info on https://docs.avohq.io/#{Avo::VERSION[0]}.0/associations.html."
+      )
+    end
+  end
+
   class ResourceNotFoundError < StandardError
     def initialize(resource_name)
       super(

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: avo
 version: !ruby/object:Gem::Version
-  version: 4.2.1
+  version: 4.2.2
 platform: ruby
 authors:
 - Adrian Marin
@@ -221,6 +221,11 @@ files:
 - Gemfile.lock
 - README.md
 - Rakefile
+- app/assets/builds/avo.base.css
+- app/assets/builds/avo.base.js
+- app/assets/builds/avo.base.js.map
+- app/assets/builds/avo.custom.js
+- app/assets/builds/avo.custom.js.map
 - app/assets/builds/avo/application.css
 - app/assets/builds/avo/application.js
 - app/assets/builds/avo/application.js.map
@@ -229,6 +234,8 @@ files:
 - app/assets/builds/avo/dependencies.css
 - app/assets/builds/avo/late-registration.js
 - app/assets/builds/avo/late-registration.js.map
+- app/assets/builds/late-registration.js
+- app/assets/builds/late-registration.js.map
 - app/assets/config/avo_manifest.js
 - app/assets/images/avo/favicon-dark.ico
 - app/assets/images/avo/favicon.ico