avo 2.11.1.pre.3 → 2.11.2.pre.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 794b7326ae2257afd693641ff51ba513d09d4729a77a671a96f1291f0b31b8e3
-  data.tar.gz: a3b8b5d2f19e9ac16164ae6cb634a0f53d92da7af1b4bc3c829704327f112c91
+  metadata.gz: ab1a9ef1d382202009c6238b84e53b78cde379babde8bbfbdf95c94d64f422ae
+  data.tar.gz: d73bd4cf8b9125695e835f41971eff6ea37a4e0df79fb802e8eeb87b62eeb4c9
 SHA512:
-  metadata.gz: 15b95f8cef9a7ec9af6a272dd2abddbb7d8471f5edefb568b16e84f3b26165f7ac4f913974d70291463c8fcbc4427d7608a41a01c0167864d0368178ebf1e755
-  data.tar.gz: 7a7b600d0cc554e8aa30377199dad939e82c8165310b9f81cfe911c06a4d3cac3c72617fdad432475cd61bfcb60a1d00ee5ba4101a2d204940f48f6c6f03ba72
+  metadata.gz: 0b6d7c8732f5e27e6963ef7e660c55a92c32740449a09924a4f0b300bf98ccb64637eb662d9f111e24d6c1a46fe0ebaa4ffc91b2e667de2189de2ba9dfbfe0c9
+  data.tar.gz: 57c439b934e2ef860157cec05d4da4e2652d45b1da258cc4410911ef81c9e99f011acc9ef0c8fd06f5c0452a765ccb89b6c5d91af46ef3a94ca9a85fbf9cd8c0

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    avo (2.11.1.pre.3)
+    avo (2.11.2.pre.2)
       active_link_to
       addressable
       breadcrumbs_on_rails

data/app/assets/stylesheets/css/sidebar.css

@@ -9,20 +9,10 @@
     @apply lg:pl-0;
   }
 
-  /* Hide the sidebar by default. */
-  .avo-sidebar {
-    @apply lg:hidden;
-  }
-
   &.sidebar-open {
     /* Add padding to the main area to allow for the sidebar to expand. */
     .main-content-area {
       @apply lg:pl-64;
     }
-
-    /* Show the sidebar. */
-    .avo-sidebar {
-      @apply lg:block;
-    }
   }
 }

data/app/assets/svgs/failed_to_load.svg

@@ -0,0 +1,15 @@
+<svg width="275" height="275" viewBox="0 0 275 275" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M137.714 274.227C213.377 274.227 274.714 212.89 274.714 137.227C274.714 61.5636 213.377 0.226593 137.714 0.226593C62.0512 0.226593 0.714233 61.5636 0.714233 137.227C0.714233 212.89 62.0512 274.227 137.714 274.227Z" fill="url(#paint0_linear_663_759)"/>
+<rect x="55.5142" y="67.8133" width="164.4" height="32.88" fill="white"/>
+<path d="M219.914 274.227H55.5142V97.0399C63.2629 97.0312 70.6918 93.9492 76.171 88.4701C81.6502 82.9909 84.7322 75.562 84.7409 67.8133H190.688C190.679 71.6518 191.432 75.4538 192.903 78.9994C194.374 82.5449 196.533 85.7636 199.256 88.4692C201.962 91.1929 205.181 93.353 208.727 94.8242C212.273 96.2953 216.075 97.0484 219.914 97.0399V274.227Z" fill="white"/>
+<path d="M137.714 186.547C161.926 186.547 181.554 166.919 181.554 142.707C181.554 118.494 161.926 98.8666 137.714 98.8666C113.502 98.8666 93.8743 118.494 93.8743 142.707C93.8743 166.919 113.502 186.547 137.714 186.547Z" fill="#4285F4"/>
+<path d="M153.214 163.373L137.714 147.874L122.214 163.373L117.048 158.207L132.548 142.707L117.048 127.207L122.214 122.041L137.714 137.54L153.214 122.041L158.381 127.207L142.881 142.707L158.381 158.207L153.214 163.373Z" fill="white"/>
+<path d="M161.461 197.507H113.968C110.941 197.507 108.488 199.96 108.488 202.987C108.488 206.013 110.941 208.467 113.968 208.467H161.461C164.487 208.467 166.941 206.013 166.941 202.987C166.941 199.96 164.487 197.507 161.461 197.507Z" fill="#DFEAFB"/>
+<path d="M177.901 219.427H97.5275C94.501 219.427 92.0475 221.88 92.0475 224.907C92.0475 227.933 94.501 230.387 97.5275 230.387H177.901C180.927 230.387 183.381 227.933 183.381 224.907C183.381 221.88 180.927 219.427 177.901 219.427Z" fill="#DFEAFB"/>
+<defs>
+<linearGradient id="paint0_linear_663_759" x1="137.714" y1="0.226593" x2="137.714" y2="274.227" gradientUnits="userSpaceOnUse">
+<stop stop-color="#E3ECFA"/>
+<stop offset="1" stop-color="#DAE7FF"/>
+</linearGradient>
+</defs>
+</svg>

data/app/components/avo/common_field_wrapper_component.html.erb

@@ -19,4 +19,8 @@
   <div class="flex-1 flex flex-row md:min-h-inherit py-2 <% unless @displayed_in_modal %> px-6 <% end %>">
     <%= content %>
   </div>
+  <% if params[:avo_debug].present? %>
+    <!-- Raw value: -->
+    <!-- <%== @field.value.inspect %> -->
+  <% end %>
 <% end %>

data/app/components/avo/fields/date_field/show_component.html.erb

@@ -5,9 +5,5 @@
     date_field_format_value: @field.format,
   } do %>
     <%= @field.formatted_value %>
-    <% if params[:avo_debug].present? %>
-      <!-- Raw value: -->
-      <!-- <%= @field.formatted_value.inspect %> -->
-    <% end %>
   <% end %>
 <% end %>

data/app/components/avo/fields/trix_field/edit_component.rb

@@ -2,6 +2,6 @@
 
 class Avo::Fields::TrixField::EditComponent < Avo::Fields::EditComponent
   def trix_id
-    "trix_#{@resource.name.underscore}_#{@field.id}"
+    "trix_#{@resource.class_name_without_resource.underscore}_#{@field.id}"
   end
 end

data/app/components/avo/index/field_wrapper_component.html.erb

@@ -19,6 +19,6 @@
   <% end %>
   <% if params[:avo_debug].present? %>
     <!-- Raw value: -->
-    <!-- <%= @field.value.inspect %> -->
+    <!-- <%== @field.value.inspect %> -->
   <% end %>
 <% end %>

data/app/components/avo/index/resource_controls_component.html.erb

@@ -5,6 +5,7 @@
   <% if can_view? %>
     <%= link_to helpers.svg('eye', class: button_classes),
       show_path,
+      class: 'flex items-center',
       title: t('avo.view_item', item: singular_resource_name).capitalize,
       data: {
         target: 'control:view',
@@ -17,6 +18,7 @@
   <% if can_edit? %>
     <%= link_to helpers.svg('edit', class: button_classes),
       edit_path,
+      class: 'flex items-center',
       title: t('avo.edit_item', item: singular_resource_name).capitalize,
       data: {
         target: 'control:edit',
@@ -31,6 +33,7 @@
     <%= form_with url: helpers.resource_detach_path(params[:resource_name], params[:id], params[:related_name], @resource.model.id),
       method: :delete,
       local: true,
+      class: 'flex items-center',
       html: {
         'data-turbo-frame': params[:turbo_frame]
       } do |form| %>

data/app/components/avo/index/table_row_component.html.erb

@@ -9,12 +9,21 @@
       </div>
     </td>
   <% end %>
+  <% if Avo.configuration.resource_controls_on_the_left? %>
+    <td class="text-right whitespace-nowrap px-2" data-control="resource-controls">
+      <div class="flex items-center justify-end flex-grow-0 h-full w-full">
+        <%= render(Avo::Index::ResourceControlsComponent.new(resource: @resource, reflection: @reflection, parent_model: @parent_model, parent_resource: @parent_resource, view_type: :table)) %>
+      </div>
+    </td>
+  <% end %>
   <% @resource.get_fields(reflection: @reflection, only_root: true).each_with_index do |field, index| %>
     <%= render field.component_for_view(:index).new(field: field, resource: @resource, index: index, parent_model: @parent_model) %>
   <% end %>
-  <td class="text-right whitespace-nowrap px-2">
-    <div class="flex items-center justify-end flex-grow-0 h-full w-full">
-      <%= render(Avo::Index::ResourceControlsComponent.new(resource: @resource, reflection: @reflection, parent_model: @parent_model, parent_resource: @parent_resource, view_type: :table)) %>
-    </div>
-  </td>
+  <% if Avo.configuration.resource_controls_on_the_right? %>
+    <td class="text-right whitespace-nowrap px-2" data-control="resource-controls">
+      <div class="flex items-center justify-end flex-grow-0 h-full w-full">
+        <%= render(Avo::Index::ResourceControlsComponent.new(resource: @resource, reflection: @reflection, parent_model: @parent_model, parent_resource: @parent_resource, view_type: :table)) %>
+      </div>
+    </td>
+  <% end %>
 </tr>

data/app/components/avo/item_switcher_component.html.erb

@@ -1,6 +1,6 @@
 <% if item.is_tool? %>
   <% if item&.partial.present? %>
-    <%= render item.partial, tool: item %>
+    <%= render item.partial, tool: item, form: @form %>
   <% end %>
 <% elsif item.is_panel? %>
   <%= render Avo::PanelComponent.new(title: item.name, description: item.description, index: index, view: view) do |c| %>

data/app/components/avo/sidebar_component.html.erb

@@ -1,6 +1,12 @@
 <div
-  class="avo-sidebar fixed z-[60] t-0 application-sidebar w-64 hidden lg:flex flex-1 border-r lg:border-none bg-none h-[calc(100vh-4rem)] bg-gray-25 lg:bg-transparent <%= 'print:hidden' if Avo.configuration.hide_layout_when_printing %>";
-  data-sidebar-target="sidebar"
+  class="avo-sidebar fixed z-[60] t-0 application-sidebar w-64 flex-1 border-r lg:border-none bg-none h-[calc(100vh-4rem)] bg-gray-25 lg:bg-transparent <%= 'print:hidden' if Avo.configuration.hide_layout_when_printing %> <%= @sidebar_open ? 'flex' : 'hidden' %>"
+  data-sidebar-target="<%= stimulus_target %>"
+  data-transition-enter="transition ease-out duration-100"
+  data-transition-enter-start="transform opacity-0 -translate-x-full"
+  data-transition-enter-end="transform opacity-100 translate-x-0"
+  data-transition-leave="transition ease-in duration-75"
+  data-transition-leave-start="transform opacity-100 translate-x-0"
+  data-transition-leave-end="transform opacity-0 -translate-x-full"
 >
   <div class="flex flex-col w-full h-full">
     <div class="flex-1 flex flex-col justify-between overflow-auto h-full pt-3 scroll-shadows">

data/app/components/avo/sidebar_component.rb

@@ -1,6 +1,11 @@
 # frozen_string_literal: true
 
 class Avo::SidebarComponent < ViewComponent::Base
+  def initialize(sidebar_open: nil, for_mobile: false)
+    @sidebar_open = sidebar_open
+    @for_mobile = for_mobile
+  end
+
   def dashboards
     Avo::App.dashboards_for_navigation
   end
@@ -12,4 +17,8 @@ class Avo::SidebarComponent < ViewComponent::Base
   def tools
     Avo::App.tools_for_navigation
   end
+
+  def stimulus_target
+    @for_mobile ? "mobileSidebar" : "sidebar"
+  end
 end

data/app/controllers/avo/application_controller.rb

@@ -151,7 +151,7 @@ module Avo
       is_attach_action = params[model_param_key].blank? && params[:related_name].present? && params[:fields].present?
 
       unless is_attach_action
-        @model = @resource.fill_model(@model_to_fill, cast_nullable(model_params))
+        @model = @resource.fill_model(@model_to_fill, cast_nullable(model_params), extra_params: extra_params)
       end
     end
 
@@ -328,7 +328,7 @@ module Avo
 
     def set_sidebar_open
       value = cookies["#{Avo::COOKIES_KEY}.sidebar.open"]
-      @sidebar_open = value.blank? || value == '1'
+      @sidebar_open = value.blank? || value == "1"
     end
   end
 end

data/app/controllers/avo/base_controller.rb

@@ -11,7 +11,7 @@ module Avo
     before_action :set_edit_title_and_breadcrumbs, only: [:edit, :update]
     before_action :fill_model, only: [:create, :update]
     # Don't run base authorizations for associations
-    before_action :authorize_base_action, if: -> {controller_name != "associations"}
+    before_action :authorize_base_action, if: -> { controller_name != "associations" }
 
     def index
       @page_title = @resource.plural_name.humanize
@@ -248,7 +248,11 @@ module Avo
     end
 
     def permitted_params
-      @resource.get_field_definitions.select(&:updatable).map(&:to_permitted_param)
+      @resource.get_field_definitions.select(&:updatable).map(&:to_permitted_param).concat extra_params
+    end
+
+    def extra_params
+      @resource.class.extra_params || []
     end
 
     def cast_nullable(params)

data/app/javascript/js/controllers/fields/key_value_controller.js

@@ -110,13 +110,15 @@ export default class extends Controller {
   }
 
   inputField(id = 'key', index, key, value) {
+    const inputValue = id === 'key' ? key : value
+
     return `<input
   class="${this.options.inputClasses} focus:bg-gray-100 !rounded-none border-gray-600 border-r border-l-0 border-b-0 border-t-0 focus:border-gray-300 w-1/2 focus:outline-none outline-none key-value-input-${id}"
   data-action="input->key-value#${id}FieldUpdated"
   placeholder="${this.options[`${id}_label`]}"
   data-index="${index}"
   ${this[`${id}InputDisabled`] ? "disabled='disabled'" : ''}
-  value="${id === 'key' ? key : value}"
+  value="${typeof inputValue === 'undefined' || inputValue === null ? '' : inputValue}"
 />`
   }
 

data/app/javascript/js/controllers/sidebar_controller.js

@@ -1,8 +1,9 @@
 import { Controller } from '@hotwired/stimulus'
+import { enter, leave, toggle } from 'el-transition'
 import Cookies from 'js-cookie'
 
 export default class extends Controller {
-  static targets = ['sidebar', 'mainArea']
+  static targets = ['sidebar', 'mobileSidebar', 'mainArea']
 
   static values = {
     open: Boolean,
@@ -23,12 +24,14 @@ export default class extends Controller {
   markSidebarClosed() {
     Cookies.set(this.cookieKey, '0')
     this.openValue = false
+    leave(this.sidebarTarget)
     this.mainAreaTarget.classList.remove('sidebar-open')
   }
 
   markSidebarOpen() {
     Cookies.set(this.cookieKey, '1')
     this.openValue = true
+    enter(this.sidebarTarget)
     this.mainAreaTarget.classList.add('sidebar-open')
   }
 
@@ -41,6 +44,6 @@ export default class extends Controller {
   }
 
   toggleSidebarOnMobile() {
-    this.sidebarTarget.classList.toggle('hidden')
+    toggle(this.mobileSidebarTarget)
   }
 }

data/app/views/avo/home/failed_to_load.html copy.erb

@@ -0,0 +1,23 @@
+<%= render Avo::TurboFrameWrapperComponent.new(params[:turbo_frame]) do %>
+  <%
+  classes = 'absolute inset-auto left-1/2 top-1/2 transform -translate-x-1/2 -translate-y-1/2'
+  label = t 'avo.failed_to_load'
+%>
+  <div class="relative flex-1 py-12">
+    <div class="relative block text-gray-300 h-40 w-full">
+      <%= svg 'avocado', class: "#{classes} h-20 text-gray-400" %>
+      <%= svg 'code', class: "#{classes} h-8 -ml-20 -mt-12" %>
+      <%= svg 'fire', class: "#{classes} h-8 -ml-10 -mt-24" %>
+      <%= svg 'color-swatch', class: "#{classes} h-8 ml-8 -mt-24" %>
+      <%= svg 'globe', class: "#{classes} h-8 ml-20 -mt-12" %>
+      <%= svg 'library', class: "#{classes} h-8 -ml-20 mt-4" %>
+      <%= svg 'photograph', class: "#{classes} h-8 ml-20 mt-4" %>
+    </div>
+    <div class="relative block text-center text-lg text-gray-400 font-semibold -mt-10"><%= label %> <span class="border-b-2 border-dashed"><%= params[:turbo_frame].to_s.humanize.downcase if params[:turbo_frame].present? %></span> frame</div>
+  </div>
+  <% if Rails.env.development? %>
+    <div class="text-center text-sm w-full">
+      This is not an issue with Avo. Click <%= link_to 'this link', params[:src], target: :_blank %> to see why this frame failed to load.
+    </div>
+  <% end %>
+<% end %>

data/app/views/avo/home/failed_to_load.html.erb

@@ -3,21 +3,15 @@
   classes = 'absolute inset-auto left-1/2 top-1/2 transform -translate-x-1/2 -translate-y-1/2'
   label = t 'avo.failed_to_load'
 %>
-  <div class="relative flex-1 py-12">
-    <div class="relative block text-gray-300 h-40 w-full">
-      <%= svg 'avocado', class: "#{classes} h-20 text-gray-400" %>
-      <%= svg 'code', class: "#{classes} h-8 -ml-20 -mt-12" %>
-      <%= svg 'fire', class: "#{classes} h-8 -ml-10 -mt-24" %>
-      <%= svg 'color-swatch', class: "#{classes} h-8 ml-8 -mt-24" %>
-      <%= svg 'globe', class: "#{classes} h-8 ml-20 -mt-12" %>
-      <%= svg 'library', class: "#{classes} h-8 -ml-20 mt-4" %>
-      <%= svg 'photograph', class: "#{classes} h-8 ml-20 mt-4" %>
+  <div class="relative flex-1 py-4">
+    <div class="relative block text-gray-300 h-64 w-full">
+      <%= svg 'failed_to_load', class: "#{classes} h-52 text-gray-400" %>
     </div>
-    <div class="relative block text-center text-lg text-gray-400 font-semibold -mt-10"><%= label %> <span class="border-b-2 border-dashed"><%= params[:turbo_frame].to_s.humanize.downcase if params[:turbo_frame].present? %></span> frame</div>
+    <div class="relative block text-center text-lg text-gray-400 font-semibold pb-6"><%= label %> <span class="border-b-2 border-dashed"><%= params[:turbo_frame].to_s.humanize.downcase if params[:turbo_frame].present? %></span> frame</div>
+    <% if Rails.env.development? %>
+      <div class="text-center text-sm w-full pb-3">
+        This is not an issue with Avo. Use <%= link_to 'this page', params[:src], target: :_blank %> to see why this frame failed to load.
+      </div>
+    <% end %>
   </div>
-  <% if Rails.env.development? %>
-    <div class="text-center text-sm w-full">
-      This is not an issue with Avo. Click <%= link_to 'this link', params[:src], target: :_blank %> to see why this frame failed to load.
-    </div>
-  <% end %>
 <% end %>

data/app/views/avo/partials/_table_header.html.erb

@@ -1,9 +1,14 @@
 <thead class="bg-white border-b border-gray-200 pb-1">
   <% if @resource.record_selector %>
-    <th class="rounded-lg">
+    <th class="rounded-lg" data-control="item-select-th">
       <%== item_select_all_input %>
     </th>
   <% end %>
+  <% if Avo.configuration.resource_controls_on_the_left? %>
+    <th class="w-24" data-control="resource-controls-th">
+      <!-- Item controls cell -->
+    </th>
+  <% end %>
   <% fields.each_with_index do |field, index|  %>
     <%
       if params[:sort_by] == field.id.to_s
@@ -39,7 +44,7 @@
           ""
         end
     %>
-    <th class="text-left uppercase px-3 py-2 whitespace-nowrap rounded-l">
+    <th class="text-left uppercase px-3 py-2 whitespace-nowrap rounded-l" data-control="resource-field-th">
       <% if field.sortable %>
         <%= link_to params.permit!.merge(sort_by: sort_by, sort_direction: sort_direction), class: "flex items-center #{classes} #{'cursor-pointer' if field.sortable}", 'data-turbo-frame': params[:turbo_frame] do %>
           <%= field.name %>
@@ -52,7 +57,9 @@
       <% end %>
     </th>
   <% end %>
-  <th class="w-24">
-    <!-- Item controls cell -->
-  </th>
+  <% if Avo.configuration.resource_controls_on_the_right? %>
+    <th class="w-24" data-control="resource-controls-th">
+      <!-- Item controls cell -->
+    </th>
+  <% end %>
 </thead>

data/app/views/layouts/avo/application.html.erb

@@ -23,7 +23,12 @@
       <div class="flex-1 flex flex-col max-w-full">
         <%= render partial: "avo/partials/navbar" %>
         <div data-sidebar-target="mainArea" class="content-area flex-1 flex pt-16 relative <%= 'sidebar-open' if @sidebar_open %>">
-          <%= render Avo::SidebarComponent.new %>
+          <div class="hidden lg:flex">
+            <%= render Avo::SidebarComponent.new sidebar_open: @sidebar_open %>
+          </div>
+          <div class="flex lg:hidden">
+            <%= render Avo::SidebarComponent.new sidebar_open: false, for_mobile: true %>
+          </div>
           <div class="main-content-area flex-1 flex flex-col min-h-full max-w-full">
             <div class="content p-4 lg:p-6 flex-1 flex flex-col justify-between items-stretch <%= @container_classes %>">
               <%= render partial: "avo/partials/custom_tools_alert" %>

data/bin/init

@@ -28,6 +28,11 @@ app_root do
   header 'Preparing the database'
   run! 'bin/rails db:setup'
 
+  header 'Building assets'
+  run! 'yarn build:js'
+  run! 'yarn build:custom-js'
+  run! 'yarn build:css'
+
   if use_docker == 'y'
     header 'Stopping the Docker image'
     run! 'docker-compose stop'

data/lib/avo/base_resource.rb

@@ -47,6 +47,7 @@ module Avo
     class_attribute :after_update_path, default: :show
     class_attribute :record_selector, default: true
     class_attribute :keep_filters_panel_open, default: false
+    class_attribute :extra_params
 
     class << self
       delegate :t, to: ::I18n
@@ -251,7 +252,7 @@ module Avo
       end
     end
 
-    def fill_model(model, params)
+    def fill_model(model, params, extra_params: [])
       # Map the received params to their actual fields
       fields_by_database_id = get_field_definitions
         .reject do |field|
@@ -262,6 +263,7 @@ module Avo
         end
         .to_h
 
+      # Write the field values
       params.each do |key, value|
         field = fields_by_database_id[key]
 
@@ -270,6 +272,19 @@ module Avo
         model = field.fill_field model, key, value, params
       end
 
+      # Write the user configured extra params to the model
+      if extra_params.present?
+        extra_params.each do |param_id|
+          # if it's a nested array, use the key
+          param_id = param_id.first.first if param_id.is_a? Hash
+
+          next unless model.respond_to? "#{param_id}="
+
+          param_value = params[param_id]
+          model.send("#{param_id}=", param_value)
+        end
+      end
+
       model
     end
 

data/lib/avo/concerns/has_fields.rb

@@ -13,8 +13,6 @@ module Avo
       end
 
       class_methods do
-        delegate :tool, to: :items_holder
-
         # DSL methods
         def field(name, **args, &block)
           ensure_items_holder_initialized
@@ -34,8 +32,14 @@ module Avo
           self.items_holder.tabs Avo::TabGroupBuilder.parse_block(&block)
         end
 
+        def tool(klass, **args)
+          ensure_items_holder_initialized
+
+          items_holder.tool klass, **args
+        end
+
         def heading(body, **args)
-          self.items_holder.add_item Avo::Fields::HeadingField.new(body, order_index: items_index, **args)
+          self.items_holder.heading body, **args
         end
         # END DSL methods
 

data/lib/avo/concerns/model_class_constantized.rb

@@ -14,7 +14,7 @@ module Avo
           when String, Symbol
             value.to_s.safe_constantize
           else
-            raise ArgumentError.new "Failed to find a proper model class for #{self.to_s}"
+            raise ArgumentError.new "Failed to find a proper model class for #{self}"
           end
         end
       end

data/lib/avo/configuration/resource_configuration.rb

@@ -0,0 +1,21 @@
+module Avo
+  class Configuration
+    module ResourceConfiguration
+      def resource_controls_placement=(val)
+        @resource_controls_placement_instance = val
+      end
+
+      def resource_controls_placement
+        @resource_controls_placement_instance || :right
+      end
+
+      def resource_controls_on_the_left?
+        resource_controls_placement == :left
+      end
+
+      def resource_controls_on_the_right?
+        resource_controls_placement == :right
+      end
+    end
+  end
+end

data/lib/avo/configuration.rb

@@ -1,5 +1,7 @@
 module Avo
   class Configuration
+    include ResourceConfiguration
+
     attr_writer :root_path
     attr_accessor :app_name
     attr_accessor :timezone

data/lib/avo/items_holder.rb

@@ -49,6 +49,12 @@ module Avo
       add_item panel
     end
 
+    def heading(body = nil, **args, &block)
+      field = Avo::Fields::HeadingField.new(body, **args)
+
+      add_item field
+    end
+
     def add_item(instance)
       @items << instance
 

data/lib/avo/panel_builder.rb

@@ -5,6 +5,7 @@ class Avo::PanelBuilder
     end
   end
 
+  delegate :heading, to: :items_holder
   delegate :field, to: :items_holder
   delegate :items, to: :items_holder
 

data/lib/avo/version.rb

@@ -1,3 +1,3 @@
 module Avo
-  VERSION = "2.11.1.pre.3" unless const_defined?(:VERSION)
+  VERSION = "2.11.2.pre.2" unless const_defined?(:VERSION)
 end