feature: array adapter

app/components/avo/index/resource_controls_component.rb

@@ -16,6 +16,9 @@ def can_detach?
   end
 
   def can_edit?
+    # Disable edit for ArrayResources
+    return false if @resource.try(:is_array_resource?)
+
     return authorize_association_for(:edit) if @reflection.present?
 
     @resource.authorization.authorize_action(:edit, raise_exception: false)

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

@@ -41,7 +41,7 @@
         parent_resource: @parent_resource
       ) %>
     <% else %>
-      <td class="text-center">—</td>
+      <td class="px-3">—</td>
     <% end %>
   <% end %>
   <% if @resource.resource_controls_render_on_the_right? %>

app/components/avo/resource_component.rb

@@ -40,12 +40,18 @@ def detach_path
   end
 
   def can_see_the_edit_button?
+    # Disable edit for ArrayResources
+    return false if @resource.try(:is_array_resource?)
+
     return authorize_association_for(:edit) if @reflection.present?
 
     @resource.authorization.authorize_action(:edit, raise_exception: false)
   end
 
   def can_see_the_destroy_button?
+    # Disable destroy for ArrayResources
+    return false if @resource.try(:is_array_resource?)
+
     @resource.authorization.authorize_action(:destroy, raise_exception: false)
   end
 

app/components/avo/views/resource_index_component.html.erb

@@ -11,7 +11,7 @@
       description: description,
       cover_photo: resource.cover_photo,
       data: {component: "resources-index"},
-      display_breadcrumbs: @reflection.blank? || (@reflection.present? && !helpers.turbo_frame_request?)
+      display_breadcrumbs: (@reflection.blank? && @parent_resource.blank?) || (@reflection.present? && !helpers.turbo_frame_request?)
     ) do |c| %>
     <% c.with_name_slot do %>
       <%= render Avo::PanelNameComponent.new name: title, url: (params[:turbo_frame].present? && linkable?) ? field.frame_url(add_turbo_frame: false) : nil, target: :_blank do |panel_name_component| %>

app/components/avo/views/resource_index_component.rb

@@ -40,6 +40,9 @@ def available_view_types
   # The Create button is dependent on the new? policy method.
   # The create? should be called only when the user clicks the Save button so the developers gets access to the params from the form.
   def can_see_the_create_button?
+    # Disable creation for ArrayResources
+    return false if @resource.try(:is_array_resource?)
+
     return authorize_association_for(:create) if @reflection.present?
 
     @resource.authorization.authorize_action(:new, raise_exception: false) && !has_reflection_and_is_read_only

app/controllers/avo/array_controller.rb

@@ -0,0 +1,7 @@
+module Avo
+  class ArrayController < BaseController
+    def set_query
+      @query = @resource.fetch_records
+    end
+  end
+end

app/controllers/avo/associations_controller.rb

@@ -25,7 +25,11 @@ def index
       @parent_record = @parent_resource.find_record(params[:id], params: params)
       @parent_resource.hydrate(record: @parent_record)
       association_name = BaseResource.valid_association_name(@parent_record, association_from_params)
-      @query = @related_authorization.apply_policy @parent_record.send(association_name)
+      @query = if @field.try(:array)
+        @resource.fetch_records(Avo::ExecutionContext.new(target: @field.block).handle || @parent_record.try(@field.id))
+      else
+        @related_authorization.apply_policy @parent_record.send(association_name)
+      end
       @association_field = find_association_field(resource: @parent_resource, association: params[:related_name])
 
       if @association_field.present? && @association_field.scope.present?
@@ -125,7 +129,7 @@ def set_reflection
     end
 
     def set_attachment_class
-      @attachment_class = @reflection.klass
+      @attachment_class = @reflection.klass if !@field.try(:array)
     end
 
     def set_attachment_resource

app/controllers/avo/base_application_controller.rb

@@ -90,6 +90,8 @@ def related_resource
 
       return field.use_resource if field&.use_resource.present?
 
+      return Avo.resource_manager.get_resource_by_name field.id.to_s if field.try(:array)
+
       reflection = @record.class.reflect_on_association(field&.for_attribute || params[:related_name])
 
       reflected_model = reflection.klass

app/controllers/avo/base_controller.rb

@@ -30,9 +30,7 @@ def index
       set_actions
 
       # If we don't get a query object predefined from a child controller like associations, just spin one up
-      unless defined? @query
-        @query = @resource.class.query_scope
-      end
+      set_query unless defined? @query
 
       # Eager load the associations
       if @resource.includes.present?
@@ -316,9 +314,9 @@ def set_index_params
         available_columns = @resource.model_class.column_names
         default_sort_column = @resource.default_sort_column
 
-        if available_columns.include?(default_sort_column.to_s)
+        if available_columns&.include?(default_sort_column.to_s)
           @index_params[:sort_by] = default_sort_column
-        elsif available_columns.include?("created_at")
+        elsif available_columns&.include?("created_at")
           @index_params[:sort_by] = :created_at
         end
       end
@@ -608,6 +606,7 @@ def apply_pagination
     end
 
     def apply_sorting
+      return if @resource.try(:is_array_resource?)
       return if @index_params[:sort_by].nil?
 
       sort_by = @index_params[:sort_by].to_sym
@@ -650,5 +649,9 @@ def set_pagination_params
 
       @index_params[:per_page] = cookies[:per_page] || Avo.configuration.per_page
     end
+
+    def set_query
+      @query = @resource.class.query_scope
+    end
   end
 end

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

@@ -65,7 +65,8 @@
       } do %>
       <%= content_tag :div,
         class: "relative flex items-center justify-between w-full" do %>
-        <% if field.sortable %>
+        <% # Disable sort for array resources %>
+        <% if field.sortable && !@resource.try(:is_array_resource?) %>
           <%= link_to params.permit!.merge(sort_by: sort_by, sort_direction: sort_direction),
             class: class_names("flex-1 flex justify-between", text_classes),
             'data-turbo-frame': params[:turbo_frame] do %>

config/initializers/pagy.rb

@@ -1,5 +1,6 @@
 require "pagy/extras/trim"
 require "pagy/extras/countless"
+require "pagy/extras/array"
 if ::Pagy::VERSION >= ::Gem::Version.new("9.0")
   require "pagy/extras/size"
 end

lib/avo/concerns/has_items.rb

@@ -326,7 +326,7 @@ def is_standalone?(item)
       def hydrate_item(item)
         return unless item.respond_to? :hydrate
 
-        res = self.class.ancestors.include?(Avo::BaseResource) ? self : resource
+        res = (self.class.ancestors.include?(Avo::BaseResource) || self.class.ancestors.include?(Avo::Resources::ArrayResource)) ? self : resource
         item.hydrate(view: view, resource: res)
       end
     end

lib/avo/concerns/pagination.rb

@@ -12,6 +12,7 @@ module Pagination
           PAGINATION_METHOD = {
             default: :pagy,
             countless: :pagy_countless,
+            array: :pagy_array,
           }
         end
 

lib/avo/fields/has_many_field.rb

@@ -1,8 +1,11 @@
 module Avo
   module Fields
     class HasManyField < HasBaseField
+      attr_reader :array
+
       def initialize(id, **args, &block)
         args[:updatable] = false
+        @array = args[:array]
 
         only_on Avo.configuration.resource_default_view
 

lib/avo/resources/array_resource.rb

@@ -0,0 +1,92 @@
+module Avo
+  module Resources
+    class ArrayResource < Base
+      extend ActiveSupport::DescendantsTracker
+
+      include Avo::Concerns::FindAssociationField
+
+      delegate :model_class, to: :class
+
+      class_attribute :pagination, default: {
+        type: :array
+      }
+
+      class << self
+        def model_class
+          @@model_class ||= ActiveSupport::OrderedOptions.new.tap do |obj|
+            obj.model_name = ActiveSupport::OrderedOptions.new.tap do |thing|
+              thing.plural = route_key
+            end
+          end
+        end
+      end
+
+      def records = []
+
+      def find_record(id, query: nil, params: nil)
+        fetched_records = fetch_records
+
+        return super(id, query: fetched_records, params:) if is_active_record_relation?(fetched_records)
+
+        fetched_records.find { |i| i.id.to_s == id.to_s }
+      end
+
+      def fetch_records(array_of_records = records)
+        raise "Unable to fetch any #{name}" if array_of_records.nil?
+
+        # When the array of records is declared in a field's block, we need to get that block from the parent resource
+        # If there is no block try to pick those from the parent_record
+        # Fallback to resource's def records method
+        if params[:via_resource_class].present?
+          via_resource = Avo.resource_manager.get_resource(params[:via_resource_class])
+          via_record = via_resource.find_record params[:via_record_id], params: params
+          via_resource = via_resource.new record: via_record, view: :show
+          via_resource.detect_fields
+
+          association_field = find_association_field(resource: via_resource, association: route_key)
+
+          records_from_field_or_record = Avo::ExecutionContext.new(target: association_field.block).handle || via_record.try(route_key)
+
+          array_of_records = records_from_field_or_record || array_of_records
+        end
+
+        @fetched_records ||= if is_array_of_active_records?(array_of_records)
+          @@model_class = array_of_records.first.class
+          @@model_class.where(id: array_of_records.map(&:id))
+        elsif is_active_record_relation?(array_of_records)
+          @@model_class = array_of_records.try(:model)
+          array_of_records
+        else
+          # Dynamically create a class with accessors for all unique keys from the records
+          keys = array_of_records.flat_map(&:keys).uniq
+
+          custom_class = Class.new do
+            include ActiveModel::Model
+
+            # Dynamically define accessors
+            attr_accessor(*keys)
+
+            define_method(:to_param) do
+              id
+            end
+          end
+
+          # Map the records to instances of the dynamically created class
+          array_of_records.map do |item|
+            custom_class.new(item)
+          end
+        end
+      end
+
+      def is_array_of_active_records?(array_of_records = records)
+        @is_array_of_active_records ||= array_of_records.all? { |element| element.is_a?(ActiveRecord::Base) }
+      end
+
+      def is_active_record_relation?(array_of_records = records)
+        @is_active_record_relation ||= array_of_records.is_a?(ActiveRecord::Relation)
+      end
+
+      def is_array_resource? = true
+    end
+  end
+end

lib/avo/resources/resource_manager.rb

@@ -40,7 +40,7 @@ def fetch_resources
             load_resources_namespace
           end
 
-          BaseResource.descendants
+          BaseResource.descendants + ArrayResource.descendants
         end
 
         def load_resources_namespace

lib/generators/avo/concerns/parent_controller.rb

@@ -12,6 +12,8 @@ module ParentController
         end
 
         def parent_controller
+          return "Avo::ArrayController" if options["array"]
+
           options["parent-controller"] || ::Avo.configuration.resource_parent_controller
         end
       end

lib/generators/avo/resource_generator.rb

@@ -17,6 +17,11 @@ class ResourceGenerator < NamedBaseGenerator
         type: :string,
         required: false
 
+      class_option "array",
+        desc: "Indicates if the resource should be an array.",
+        type: :boolean,
+        default: false
+
       def create
         return if override_controller?
 
@@ -25,6 +30,14 @@ def create
       end
 
       no_tasks do
+        def parent_resource
+          if options["array"]
+            "Avo::Resources::ArrayResource"
+          else
+            "Avo::BaseResource"
+          end
+        end
+
         def can_connect_to_the_database?
           result = false
           begin

lib/generators/avo/templates/resource/resource.tt

@@ -1,11 +1,30 @@
-class Avo::Resources::<%= resource_class %> < Avo::BaseResource
+class Avo::Resources::<%= resource_class %> < <%= parent_resource %><% if options["array"] %>
+  def records
+    [
+      {
+        id: 1,
+        title: "Example 1"
+      },
+      {
+        id: 2,
+        title: "Example 2"
+      }
+    ]
+  end
+  <% else %>
   # self.includes = []
   # self.attachments = []<%= model_class_from_args %>
   # self.search = {
   #   query: -> { query.ransack(id_eq: params[:q], m: "or").result(distinct: false) }
   # }
-
+  <% end %><% if options["array"] %>
+  def fields
+    field :id, as: :id
+    field :title
+  end<% else %>
   def fields
     field :id, as: :id<%= generate_fields %>
-  end
+  end<% end %>
 end
+
+

spec/dummy/app/avo/resources/attendee.rb

@@ -0,0 +1,21 @@
+class Avo::Resources::Attendee < Avo::Resources::ArrayResource
+  self.description = -> {
+    return "Attendees from field block" if params["resource_name"] == "events"
+    return "First 6 users" if params["resource_name"] == "courses"
+
+    "#{@record&.name || "All the users"} rendered as array resource"
+  }
+
+  # Test array resource, this method should be called only on attendees index
+  def records = User.all
+
+  def fields
+    field :id, as: :id
+    field :name
+
+    with_options visible: -> { !resource.record.is_a?(User) } do
+      field :role
+      field :organization
+    end
+  end
+end

spec/dummy/app/avo/resources/course.rb

@@ -11,6 +11,8 @@ def show_fields
     fields_bag
     field :links, as: :has_many, searchable: true, placeholder: "Click to choose a link",
       discreet_pagination: true
+
+    field :attendees, as: :has_many, array: true
   end
 
   def index_fields