datagrid 2.0.0.pre.alpha → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37409811e25a50a023aa095fb8854424fea3867e137b8d212d619ba191307abe
-  data.tar.gz: 2485f8f3a8cf9d196011a584e680c345d147430ef3d263b151569ae10fc3ef69
+  metadata.gz: 73b5ec45b488122854f535af2e33440795923c7186f07195b1dd12c830656a83
+  data.tar.gz: 72b4cf51c6b47d6d3985bad16f0ca775b09b0770172c8ddaa67eb53091f50fb5
 SHA512:
-  metadata.gz: 2974b76d03c7a3c014a3b853570ae0a11e2c137f0e4faea6be0dfcff45b49e4c64037298337e0f9e3028ecd64d938747770903469888339e6a43bbcc03330a59
-  data.tar.gz: 52d188d5c0e6a41a3f44061274695b5eee22f7c669c1814f26ae38cfeee364b66c8437ca85c55fa3a73d8fe3333e6c9820fda9b1e2ccee770d48bcba7d72bfe3
+  metadata.gz: ebd3afee727b599bc3cfb1bb54aea656fb117edff207bfde118ef9fce36d716344ab7384dd2a801e3efd3d64e19fef419882b2a343a91408ce680755bfaf79bc
+  data.tar.gz: 3ee4d83c374287526c0f96a821c72d0254b2c1eed9d1cedef619c3bfd2425a2f21065b1571a7f065afebb6efe8c9c71ddf07f5e76678c755f5f5b99a3bfd4e06

data/.yardopts

@@ -0,0 +1,2 @@
+--markup=markdown
+--readme=README.md

data/CHANGELOG.md

@@ -1,18 +1,65 @@
 # Changelog
 
-## 2.0.0
+## [2.0.1]
+
+* Fixed `search` field type support [#330](https://github.com/bogdan/datagrid/issues/330)
+
+``` ruby
+class UsersGrid < Datagrid::Base
+  scope  { User }
+
+  filter(
+    :query, :string, input_options: { type: "search" }
+  ) do |value, scope|
+    scope.magic_search(value)
+  end
+end
+```
+
+Renders filter as:
+
+``` html
+<input type="search" name="users_grid[query]" id="users_grid_query"/>
+```
+
+* Added support for `default_filter_options` and added lambda support for `default_column_options` [#333](https://github.com/bogdan/datagrid/issues/333) by @tmikoss.
+
+``` ruby
+class UsersGrid < Datagrid::Base
+  scope { User }
+
+  self.default_column_options = -> (column) {
+    {header: I18n.t("datagrid.keywords.#{column.name}")}
+  }
+
+  self.default_filter_options = -> (filter) {
+    {
+      header: I18n.t("datagrid.keywords.user.#{filter.name}"),
+      input_options: filter.type == :string ? {type: "textarea"} : {},
+    }
+  }
+  
+  filter(:first_name, :string)
+  filter(:last_name, :string)
+
+  column(:first_name)
+  column(:last_name)
+end
+```
+
+## [2.0.0]
 
 Version 2 is a major update implementing a lot of major improvements
 at the cost of backward compatibility.
 
 [Changes and migration guide](./version-2)
 
-## 1.8.3
+## [1.8.3]
 
 * Fix rails hooking for version 7.1. [#327](https://github.com/bogdan/datagrid/issues/327)
 * Fix formatting of value for `date` and `datetime-local` input types
 
-## 1.8.2
+## [1.8.2]
 
 * Treat true/false as YES/NO when assigned as strings for xboolean filter.
 * Support infinite ranges for date, datetime and integer filters.
@@ -20,11 +67,11 @@ at the cost of backward compatibility.
 * Add `Datagrid#reset` method to reset a column cache.
 * Drop support of Rails 6.0 [#326](https://github.com/bogdan/datagrid/pull/326)
 
-## 1.8.1
+## [1.8.1]
 
 * Prioritize `input_options` over generated by default. [#319](https://github.com/bogdan/datagrid/pull/319)
 
-## 1.8.0
+## [1.8.0]
 
 * Support `input_options: {type: "textarea"}` as `<textarea/>` tag
 * Remove deprecated `eboolean` filter
@@ -37,18 +84,18 @@ at the cost of backward compatibility.
 * Add ability to specify `columns` option for `datagrid_row`.
   [#314](https://github.com/bogdan/datagrid/pull/314)
 
-## 1.7.0
+## [1.7.0]
 
 * Depend on `railties` instead of `rails` to prevent loading of unnecessary frameworks
 * Bugfix `File.exist?` usage for Ruby 3.0 [#307](https://github.com/bogdan/datagrid/issues/307)
 * Drop support of old Ruby versions (< 2.7) [#305](https://github.com/bogdan/datagrid/pull/305)
 * Drop support of old Rails versions (< 6.0) [#305](https://github.com/bogdan/datagrid/pull/305)
 
-## 1.6.3
+## [1.6.3]
 
 * Fix usage of options spread operator for Ruby 3.0 [#296](https://github.com/bogdan/datagrid/issues/296)
 
-## 1.6.2
+## [1.6.2]
 
 * Add `input_options` and `label_options` to `filter` method [#294](https://github.com/bogdan/datagrid/issues/294)
 * Fix `<option>` tag rendering for Rails 6.0

data/README.md

@@ -23,8 +23,6 @@ including admin panels, analytics and data browsers:
 * Sequel
 * Array (in-memory data of smaller scale)
 
-[Create an issue](https://github.com/bogdan/datagrid/issues/new) if you want more.
-
 ## Datagrid Philosophy
 
 1. Expressive DSL complements OOD instead of replacing it.
@@ -164,7 +162,7 @@ end
 Some formatting options are also available.
 Each column is sortable.
 
-[More about columns](https://github.com/bogdan/datagrid/wiki/Columns)
+[More about columns](https://rubydoc.info/gems/datagrid/Datagrid/Columns)
 
 ### Front end
 
@@ -198,7 +196,7 @@ rails g datagrid::views
 
 All advanced frontend things are described in:
 
-[Frontend section on wiki](https://rubydoc.info/gems/datagrid/Datagrid/Helper)
+[Frontend documentation](https://rubydoc.info/gems/datagrid/Datagrid/Helper)
 
 ## Questions & Issues
 

data/datagrid.gemspec

@@ -19,6 +19,7 @@ Gem::Specification.new do |s|
     "CHANGELOG.md",
     "README.md",
     "datagrid.gemspec",
+    ".yardopts",
   ]
   s.files += `git ls-files | grep -E '^(app|lib|templates)'`.split("\n")
   s.homepage = "https://github.com/bogdan/datagrid"
@@ -27,7 +28,7 @@ Gem::Specification.new do |s|
   s.metadata = {
     "homepage_uri" => s.homepage,
     "bug_tracker_uri" => "#{s.homepage}/issues",
-    "documentation_uri" => "#{s.homepage}/wiki",
+    "documentation_uri" => "https://rubydoc.info/gems/datagrid",
     "changelog_uri" => "#{s.homepage}/blob/main/CHANGELOG.md",
     "source_code_uri" => s.homepage,
     "rubygems_mfa_required" => "true",

data/lib/datagrid/columns/column.rb

@@ -8,37 +8,52 @@ module Datagrid
       class ResponseFormat
         attr_accessor :data_block, :html_block
 
+        # @!visibility private
         def initialize
           yield(self)
         end
 
+        # @!visibility private
         def data(&block)
           self.data_block = block
         end
 
+        # @!visibility private
         def html(&block)
           self.html_block = block
         end
 
+        # @!visibility private
         def call_data
           data_block.call
         end
 
+        # @!visibility private
         def to_s
           call_data.to_s
         end
 
+        # @!visibility private
         def call_html(context)
           context.instance_eval(&html_block)
         end
       end
 
-      attr_accessor :grid_class, :options, :data_block, :name, :html_block, :query
+      # @attribute [r] grid_class
+      #   @return [Class] grid class where column is defined
+      # @attribute [r] name
+      #   @return [Symbol] column name
+      # @attribute [r] options
+      #   @return [Hash<Symbol, Object>] column options
+      attr_reader :grid_class, :name, :query, :options, :data_block, :html_block
 
+      # @!visibility private
       def initialize(grid_class, name, query, options = {}, &block)
-        self.grid_class = grid_class
-        self.name = name.to_sym
-        self.options = options
+        @grid_class = grid_class
+        @name = name.to_sym
+        @query = query
+        @options = Datagrid::Utils.callable(grid_class.default_column_options, self).merge(options)
+
         if options[:class]
           Datagrid::Utils.warn_once(
             "column[class] option is deprecated. Use {tag_options: {class: ...}} instead.",
@@ -49,24 +64,26 @@ module Datagrid
           }
         end
         if options[:html] == true
-          self.html_block = block
+          @html_block = block
         else
-          self.data_block = block
+          @data_block = block
 
-          self.html_block = options[:html] if options[:html].is_a? Proc
+          @html_block = options[:html] if options[:html].is_a? Proc
         end
-        self.query = query
       end
 
+      # @deprecated Use {Datagrid::Columns#data_value} instead
       def data_value(model, grid)
         # backward compatibility method
         grid.data_value(name, model)
       end
 
+      # @deprecated Use {#header} instead
       def label
         options[:label]
       end
 
+      # @return [String] column header
       def header
         if (header = options[:header])
           Datagrid::Utils.callable(header)
@@ -75,7 +92,9 @@ module Datagrid
         end
       end
 
+      # @return [Object] column order expression
       def order
+        return nil if options[:order] == false
         if options.key?(:order) && options[:order] != true
           options[:order]
         else
@@ -83,10 +102,12 @@ module Datagrid
         end
       end
 
+      # @return [Boolean] weather column support order
       def supports_order?
-        order || order_by_value?
+        !!order || order_by_value?
       end
 
+      # @!visibility private
       def order_by_value(model, grid)
         if options[:order_by_value] == true
           grid.data_value(self, model)
@@ -95,6 +116,7 @@ module Datagrid
         end
       end
 
+      # @return [Boolean] weather a column should be ordered by value
       def order_by_value?
         !!options[:order_by_value]
       end
@@ -105,22 +127,27 @@ module Datagrid
         options[:order_desc]
       end
 
+      # @return [Boolean] weather a column should be displayed in HTML
       def html?
         options[:html] != false
       end
 
+      # @return [Boolean] weather a column should be displayed in data
       def data?
         data_block != nil
       end
 
+      # @return [Boolean] weather a column is explicitly marked mandatory
       def mandatory?
         !!options[:mandatory]
       end
 
+      # @return [Hash<Symbol, Object>] `tag_options` option value
       def tag_options
         options[:tag_options] || {}
       end
 
+      # @deprecated Use {#tag_options} instead.
       def html_class
         Datagrid::Utils.warn_once(
           "Column#html_class is deprecated. Use Column#tag_options instead.",
@@ -128,30 +155,38 @@ module Datagrid
         options[:class]
       end
 
+      # @return [Boolean] weather a `mandatory` option is explicitly set
       def mandatory_explicitly_set?
         options.key?(:mandatory)
       end
 
+      # @param [Datagrid::Base] grid object
+      # @return [Boolean] weather a column is available via `if` and `unless` options
       def enabled?(grid)
         ::Datagrid::Utils.process_availability(grid, options[:if], options[:unless])
       end
 
+      # @return [String] column console inspection
       def inspect
         "#<#{self.class} #{grid_class}##{name} #{options.inspect}>"
       end
 
+      # @return [String] column header
       def to_s
         header
       end
 
+      # @!visibility private
       def html_value(context, asset, grid)
         grid.html_value(name, context, asset)
       end
 
+      # @!visibility private
       def generic_value(model, grid)
         grid.generic_value(self, model)
       end
 
+      # @!visibility private
       def append_preload(relation)
         return relation unless preload
 
@@ -168,6 +203,7 @@ module Datagrid
         end
       end
 
+      # @return [Object] `preload` option value
       def preload
         preload = options[:preload]
 
@@ -178,6 +214,8 @@ module Datagrid
         end
       end
 
+      protected
+
       def driver
         grid_class.driver
       end

data/lib/datagrid/columns.rb

@@ -2,6 +2,7 @@
 
 require "datagrid/utils"
 require "active_support/core_ext/class/attribute"
+require "datagrid/columns/column"
 
 module Datagrid
   # Defines a column to be used for displaying data in a Datagrid.
@@ -154,6 +155,10 @@ module Datagrid
   #
   #     self.default_column_options = { order: false }
   #
+  # It can also accept a proc with the column instance as an argument:
+  #
+  #     self.default_column_options = ->(column) { { order: column.name == :id } }
+  #
   # ## Columns Visibility
   #
   # Columns can be dynamically shown or hidden based on the grid's `column_names` accessor.
@@ -199,33 +204,34 @@ module Datagrid
   #       presenter.user.created_at
   #     end
   module Columns
-    require "datagrid/columns/column"
-
     # @!method default_column_options=(value)
-    # @param [Hash] value default options passed to #column method call
-    # @return [Hash] default options passed to #column method call
-    # @example
-    #   # Disable default order
-    #   self.default_column_options = { order: false }
-    #   # Makes entire report HTML
-    #   self.default_column_options = { html: true }
+    #   @param [Hash,Proc] value default options passed to {#column} method call.
+    #     When a proc is passed, it will be called with the column instance as an argument,
+    #     and expected to produce the options hash.
+    #   @return [Hash,Proc] default options passed to {#column} method call, or a proc that returns them.
+    #   @example Disable default order
+    #     self.default_column_options = { order: false }
+    #   @example Makes entire report HTML
+    #     self.default_column_options = { html: true }
+    #   @example Set the default header for all columns
+    #     self.default_column_options = ->(column) { { header: I18n.t(column.name, scope: 'my_scope.columns') } }
 
     # @!method default_column_options
-    # @return [Hash]
-    # @see #default_column_options=
+    #   @return [Hash,Proc] default options passed to {#column} method call, or a proc that returns them.
+    #   @see #default_column_options=
 
     # @!method batch_size=(value)
-    # @param [Integer] value Specify a default batch size when generating CSV or just data. Default: 1000
-    # @return [Integer] Specify a default batch size when generating CSV or just data.
-    # @example
-    #   self.batch_size = 500
-    #   # Disable batches
-    #   self.batch_size = nil
-    #
+    #   Specify a default batch size when generating CSV or just data.
+    #   @param [Integer] value a batch size when generating CSV or just data. Default: 1000
+    #   @return [void]
+    #   @example Set batch size to 500
+    #     self.batch_size = 500
+    #   @example Disable batches
+    #     self.batch_size = nil
 
     # @!method batch_size
-    # @return [Integer]
-    # @see #batch_size=
+    #   @return [Integer]
+    #   @see #batch_size=
 
     # @visibility private
     # @param [Object] base
@@ -253,37 +259,31 @@ module Datagrid
         filter_columns(columns_array, *column_names, data: data, html: html)
       end
 
-      # Defines new datagrid column
-      #
+      # Defines a new datagrid column
       # @param name [Symbol] column name
       # @param query [String, nil] a string representing the query to select this column (supports only ActiveRecord)
-      # @param options [Hash{Symbol => Object}] hash of options
       # @param block [Block] proc to calculate a column value
+      # @option options [Boolean, String] html Determines if the column should be present
+      #   in the HTML table and how it is formatted.
+      # @option options [String, Array<Symbol>] order Determines if the column can be sortable and
+      #   specifies the ORM ordering method.
+      #   Example: `"created_at, id"` for ActiveRecord, `[:created_at, :id]` for Mongoid.
+      # @option options [String] order_desc Specifies a descending order for the column
+      #   (used when `:order` cannot be easily reversed by the ORM).
+      # @option options [Boolean, Proc] order_by_value Enables Ruby-level ordering for the column.
+      #   Warning: Sorting large datasets in Ruby is not recommended.
+      #   If `true`, Datagrid orders by the column value.
+      #   If a block is provided, Datagrid orders by the block's return value.
+      # @option options [Boolean] mandatory If `true`, the column will never be hidden by the `#column_names` selection.
+      # @option options [Symbol] before Places the column before the specified column when determining order.
+      # @option options [Symbol] after Places the column after the specified column when determining order.
+      # @option options [Boolean, Proc] if conditions when a column is available.
+      # @option options [Boolean, Proc] unless conditions when a column is not available.
+      # @option options [Symbol, Array<Symbol>] preload Specifies associations
+      #   to preload for the column within the scope.
+      # @option options [Hash] tag_options Specifies HTML attributes for the `<td>` or `<th>` of the column.
+      #   Example: `{ class: "content-align-right", "data-group": "statistics" }`.
       # @return [Datagrid::Columns::Column]
-      #
-      # Available options:
-      #
-      # * <tt>html</tt> - determines if current column should be present in html table and how is it formatted
-      # * <tt>order</tt> - determines if this column could be sortable and how.
-      #   The value of order is explicitly passed to ORM ordering method.
-      #   Example: <tt>"created_at, id"</tt> for ActiveRecord, <tt>[:created_at, :id]</tt> for Mongoid
-      # * <tt>order_desc</tt> - determines a descending order for given column
-      #   (only in case when <tt>:order</tt> can not be easily reversed by ORM)
-      # * <tt>order_by_value</tt> - used in case it is easier to perform ordering at ruby level not on database level.
-      #   Warning: using ruby to order large datasets is very unrecommended.
-      #   If set to true - datagrid will use column value to order by this column
-      #   If block is given - datagrid will use value returned from block
-      # * <tt>mandatory</tt> - if true, column will never be hidden with #column_names selection
-      # * <tt>url</tt> - a proc with one argument, pass this option to easily convert the value into an URL
-      # * <tt>before</tt> - determines the position of this column, by adding it before the column passed here
-      # * <tt>after</tt> - determines the position of this column, by adding it after the column passed here
-      # * <tt>if</tt> - the column is shown if the reult of calling this argument is true
-      # * <tt>unless</tt> - the column is shown unless the reult of calling this argument is true
-      # * <tt>preload</tt> - spefies which associations of the scope should be preloaded for this column
-      # * `tag_options` - specify HTML attributes to be set for `<td>` or `<th>` of a column
-      #   Example: `{ class: "content-align-right", "data-group": "statistics" }`
-      #
-      # @see https://github.com/bogdan/datagrid/wiki/Columns
       def column(name, query = nil, **options, &block)
         define_column(columns_array, name, query, **options, &block)
       end
@@ -333,10 +333,10 @@ module Datagrid
       # Defines a model decorator that will be used to define a column value.
       # All column blocks will be given a decorated version of the model.
       # @return [void]
-      # @example
+      # @example Wrapping a model with presenter
       #   decorate { |user| UserPresenter.new(user) }
-      #
-      #   decorate { UserPresenter } # a shortcut
+      # @example A shortcut for doing the same
+      #   decorate { UserPresenter }
       def decorate(model = nil, &block)
         if !model && !block
           raise ArgumentError, "decorate needs either a block to define decoration or a model to decorate"
@@ -376,9 +376,10 @@ module Datagrid
         block ||= lambda do |model|
           model.public_send(name)
         end
+
         position = Datagrid::Utils.extract_position_from_options(columns, options)
         column = Datagrid::Columns::Column.new(
-          self, name, query, default_column_options.merge(options), &block
+          self, name, query, options, &block
         )
         columns.insert(position, column)
         column
@@ -403,14 +404,16 @@ module Datagrid
       )
     end
 
-    # @param column_names [Array<String>] list of column names if you want to limit data only to specified columns
+    # @param column_names [Array<String, Symbol>] list of column names
+    #   if you want to limit data only to specified columns
     # @return [Array<String>] human readable column names. See also "Localization" section
     def header(*column_names)
       data_columns(*column_names).map(&:header)
     end
 
     # @param asset [Object] asset from datagrid scope
-    # @param column_names [Array<String>] list of column names if you want to limit data only to specified columns
+    # @param column_names [Array<String, Symbol>] list of column names
+    #   if you want to limit data only to specified columns
     # @return [Array<Object>] column values for given asset
     def row_for(asset, *column_names)
       data_columns(*column_names).map do |column|
@@ -419,7 +422,8 @@ module Datagrid
     end
 
     # @param asset [Object] asset from datagrid scope
-    # @return [Hash] A mapping where keys are column names and values are column values for the given asset
+    # @return [Hash] A mapping where keys are column names and
+    #   values are column values for the given asset
     def hash_for(asset)
       result = {}
       data_columns.each do |column|
@@ -428,7 +432,8 @@ module Datagrid
       result
     end
 
-    # @param column_names [Array<String>] list of column names if you want to limit data only to specified columns
+    # @param column_names [Array<String,Symbol>] list of column names
+    #   if you want to limit data only to specified columns
     # @return [Array<Array<Object>>] with data for each row in datagrid assets without header
     def rows(*column_names)
       map_with_batches do |asset|
@@ -436,7 +441,8 @@ module Datagrid
       end
     end
 
-    # @param column_names [Array<String>] list of column names if you want to limit data only to specified columns
+    # @param column_names [Array<String, Symbol>] list of column names
+    #   if you want to limit data only to specified columns.
     # @return [Array<Array<Object>>] data for each row in datagrid assets with header.
     def data(*column_names)
       rows(*column_names).unshift(header(*column_names))
@@ -461,7 +467,7 @@ module Datagrid
       end
     end
 
-    # @param column_names [Array<String>]
+    # @param column_names [Array<String,Symbol>]
     # @param options [Hash] CSV generation options
     # @return [String] a CSV representation of the data in the grid
     #
@@ -514,7 +520,7 @@ module Datagrid
       columns(*column_names, data: data, html: true)
     end
 
-    # Finds a column definition by name
+    # Finds a column by name
     # @param name [String, Symbol] column name to be found
     # @return [Datagrid::Columns::Column, nil]
     def column_by_name(name)
@@ -522,22 +528,21 @@ module Datagrid
     end
 
     # Gives ability to have a different formatting for CSV and HTML column value.
-    #
-    # @example
+    # @example Formating using Rails view helpers
     #   column(:name) do |model|
     #     format(model.name) do |value|
     #       tag.strong(value)
     #     end
     #   end
-    #
+    # @example Formatting using a separated view template
     #   column(:company) do |model|
     #     format(model.company.name) do
-    #       render partial: "company_with_logo", locals: {company: model.company }
+    #       render partial: "companies/company_with_logo", locals: {company: model.company }
     #     end
     #   end
     # @return [Datagrid::Columns::Column::ResponseFormat] Format object
     def format(value, &block)
-      if block_given?
+      if block
         self.class.format(value, &block)
       else
         # don't override Object#format method
@@ -545,26 +550,26 @@ module Datagrid
       end
     end
 
+    # @param [Object] asset one of the assets from grid scope
     # @return [Datagrid::Columns::DataRow] an object representing a grid row.
     # @example
-    #  class MyGrid
-    #    scope { User }
-    #    column(:id)
-    #    column(:name)
-    #    column(:number_of_purchases) do |user|
-    #      user.purchases.count
-    #    end
-    #  end
+    #   class MyGrid
+    #     scope { User }
+    #     column(:id)
+    #     column(:name)
+    #     column(:number_of_purchases) do |user|
+    #       user.purchases.count
+    #     end
+    #   end
     #
-    #  row = MyGrid.new.data_row(User.last)
-    #  row.id # => user.id
-    #  row.number_of_purchases # => user.purchases.count
+    #   row = MyGrid.new.data_row(User.last)
+    #   row.id # => user.id
+    #   row.number_of_purchases # => user.purchases.count
     def data_row(asset)
       ::Datagrid::Columns::DataRow.new(self, asset)
     end
 
     # Defines a column at instance level
-    #
     # @see Datagrid::Columns::ClassMethods#column
     def column(name, query = nil, **options, &block)
       self.class.define_column(columns_array, name, query, **options, &block)
@@ -578,7 +583,6 @@ module Datagrid
 
     # @return [Array<Datagrid::Columns::Column>] all columns
     #   that are possible to be displayed for the current grid object
-    #
     # @example
     #   class MyGrid
     #     filter(:search) {|scope, value| scope.full_text_search(value)}
@@ -600,6 +604,8 @@ module Datagrid
       end
     end
 
+    # @param [String,Symbol] column_name column name
+    # @param [Object] asset one of the assets from grid scope
     # @return [Object] a cell data value for given column name and asset
     def data_value(column_name, asset)
       column = column_by_name(column_name)
@@ -611,6 +617,9 @@ module Datagrid
       end
     end
 
+    # @param [String,Symbol] column_name column name
+    # @param [Object] asset one of the assets from grid scope
+    # @param [ActionView::Base] context view context object
     # @return [Object] a cell HTML value for given column name and asset and view context
     def html_value(column_name, context, asset)
       column = column_by_name(column_name)
@@ -624,6 +633,7 @@ module Datagrid
       end
     end
 
+    # @param [Object] model one of the assets from grid scope
     # @return [Object] a decorated version of given model if decorator is specified or the model otherwise.
     def decorate(model)
       self.class.decorate(model)

data/lib/datagrid/configuration.rb

@@ -1,6 +1,20 @@
 # frozen_string_literal: true
 
 module Datagrid
+  # @return [Configuration] current Datagrid configuration
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  # @yield block to configure
+  # @yieldparam [Configuration] configuration
+  # @yieldreturn [void]
+  # @return [void] configure datagrid
+  # @see Datagrid::Configuration
+  def self.configure(&block)
+    block.call(configuration)
+  end
+
   # ## Configuration
   #
   # Datagrid provides several configuration options.
@@ -11,12 +25,14 @@ module Datagrid
   # Datagrid.configure do |config|
   #   # Defines date formats that can be used to parse dates.
   #   # Note: Multiple formats can be specified. The first format is used to format dates as strings,
-  #   # while other formats are used only for parsing dates from strings (e.g., if your app supports multiple formats).
-  #   config.date_formats = ["%m/%d/%Y", "%Y-%m-%d"]
+  #   # while other formats are used only for parsing dates
+  #   # from strings (e.g., if your app supports multiple formats).
+  #   config.date_formats = "%m/%d/%Y", "%Y-%m-%d"
   #
   #   # Defines timestamp formats that can be used to parse timestamps.
   #   # Note: Multiple formats can be specified. The first format is used to format timestamps as strings,
-  #   # while other formats are used only for parsing timestamps from strings (e.g., if your app supports multiple formats).
+  #   # while other formats are used only for parsing timestamps
+  #   # from strings (e.g., if your app supports multiple formats).
   #   config.datetime_formats = ["%m/%d/%Y %h:%M", "%Y-%m-%d %h:%M:%s"]
   # end
   # ```

data/lib/datagrid/core.rb

@@ -18,8 +18,7 @@ module Datagrid
   # Both having appropriate use cases
   #
   # @example Defining a scope in a grid class
-  #   class ProjectsGrid
-  #     include Datagrid
+  #   class ProjectsGrid < ApplicationGrid
   #     scope { Project.includes(:category) }
   #   end
   #
@@ -53,6 +52,7 @@ module Datagrid
         class_attribute :datagrid_attributes, instance_writer: false, default: []
         class_attribute :dynamic_block, instance_writer: false
         class_attribute :forbidden_attributes_protection, instance_writer: false, default: false
+        class_attribute :default_filter_options, default: {}
       end
     end
 

data/lib/datagrid/filters/base_filter.rb

@@ -7,7 +7,6 @@ module Datagrid
   end
 end
 
-# @!visibility private
 module Datagrid
   module Filters
     class BaseFilter
@@ -16,7 +15,7 @@ module Datagrid
       def initialize(grid_class, name, **options, &block)
         self.grid_class = grid_class
         self.name = name.to_sym
-        self.options = options
+        self.options = Datagrid::Utils.callable(grid_class.default_filter_options, self).merge(options)
         self.block = block
       end
 

data/lib/datagrid/filters/extended_boolean_filter.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-# @!visibility private
 module Datagrid
   module Filters
     class ExtendedBooleanFilter < Datagrid::Filters::EnumFilter

data/lib/datagrid/filters/float_filter.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-# @!visibility private
 module Datagrid
   module Filters
     class FloatFilter < Datagrid::Filters::BaseFilter

data/lib/datagrid/filters.rb

@@ -24,10 +24,10 @@ module Datagrid
   #     grid = UserGrid.new(posts_count: 1, name: "John")
   #     grid.assets # SELECT * FROM users WHERE users.posts_count > 1 AND name = 'John'
   #
-  # # Filter Block
-  #
   # Filter blocks should always return a chainable ORM object (e.g., `ActiveRecord::Relation`) rather than an `Array`.
   #
+  # # Filter Block
+  #
   # Filter blocks should have at least one argument representing the value assigned to the grid object attribute:
   #
   #     filter(:name, :string) # { |value| where(name: value) }
@@ -123,6 +123,16 @@ module Datagrid
   #     filter(:id, :integer, header: "Identifier")
   #     filter(:created_at, :date, range: true, default: proc { 1.month.ago.to_date..Date.today })
   #
+  # ## Default Filter Options
+  #
+  # Default options for all filters in a grid can be set using `default_filter_options`.
+  #
+  #     self.default_filter_options = { header: "" }
+  #
+  # It can also accept a proc with the filter instance as an argument:
+  #
+  #     self.default_filter_options = ->(filter) { { header: I18n.t(filter.name, scope: 'filters') } }
+  #
   # # Localization
   #
   # Filter labels can be localized or specified via the `:header` option:
@@ -130,6 +140,18 @@ module Datagrid
   #     filter(:created_at, :date, header: "Creation date")
   #     filter(:created_at, :date, header: proc { I18n.t("creation_date") })
   module Filters
+    # @!method default_filter_options=(value)
+    #   @param [Hash,Proc] value default options passed to {#filter} method call.
+    #     When a proc is passed, it will be called with the filter instance as an argument,
+    #     and expected to produce the options hash.
+    #   @return [Hash,Proc] default options passed to {#filter} method call, or a proc that returns them.
+    #   @example Set the default header for all filters
+    #     self.default_filter_options = ->(filter) { { header: I18n.t(filter.name, scope: 'my_scope.filters') } }
+
+    # @!method default_filter_options
+    #   @return [Hash,Proc] default options passed to {#filter} method call, or a proc that returns them.
+    #   @see #default_filter_options=
+
     require "datagrid/filters/base_filter"
     require "datagrid/filters/enum_filter"
     require "datagrid/filters/extended_boolean_filter"
@@ -161,9 +183,9 @@ module Datagrid
 
     extend ActiveSupport::Concern
 
-    # @!visibility private
     included do
       include Datagrid::Core
+      class_attribute :default_filter_options, instance_writer: false, default: {}
       class_attribute :filters_array, default: []
     end
 
@@ -190,37 +212,33 @@ module Datagrid
       # @param [Symbol] name filter name
       # @param [Symbol] type filter type that defines type case and GUI representation of a filter
       # @param [Hash] options hash of options
-      # @param [Proc] block proc to apply the filter
+      # @yield [value, scope, grid] Block to apply the filter.
+      # @yieldparam [Object] value The value assigned to the filter.
+      # @yieldparam [Object] scope The current ORM scope being filtered.
+      # @yieldparam [Datagrid::Base] grid The datagrid instance.
       # @return [Datagrid::Filters::BaseFilter] Filter definition object
-      # @see https://github.com/bogdan/datagrid/wiki/Filters
-      #
-      # Available options:
-      #
-      # * <tt>:header</tt> - determines the header of the filter
-      # * <tt>:default</tt> - the default filter value.
-      #   Can be a <tt>Proc</tt> in case default should be recalculated.
-      # * <tt>:range</tt> - if true, filter can accept two values that are treated
-      #   as a range that will be used for filtering.
-      #   Not all of the filter types support this option. Here are the list of types that do:
-      #   <tt>:integer</tt>, <tt>:float</tt>, <tt>:date</tt>, <tt>:datetime</tt>, <tt>:string</tt>
-      # * <tt>:multiple</tt> -  if true multiple values can be assigned to this filter.
-      #   If String is assigned as a filter value, it is parsed from string using a separator symbol (`,` by default).
-      #   But you can specify a different separator as option value. Default: false.
-      # * <tt>:allow_nil</tt> - determines if the value can be nil
-      # * <tt>:allow_blank</tt> - determines if the value can be blank
-      # * <tt>:before</tt> - determines the position of this filter,
-      #   by adding it before the filter passed here (when using datagrid_form_with helper)
-      # * <tt>:after</tt> - determines the position of this filter,
-      #   by adding it after the filter passed here (when using datagrid_form_with helper)
-      # * <tt>:dummy</tt> - if true, this filter will not be applied automatically
-      #   and will be just displayed in form. In case you may want to apply it manually.
-      # * <tt>:if</tt> - specify the condition when the filter can be dislayed and used.
-      #   Accepts a block or a symbol with an instance method name
-      # * <tt>:unless</tt> - specify the reverse condition when the filter can be dislayed and used.
-      #   Accepts a block or a symbol with an instance method name
-      # * <tt>:input_options</tt> - options passed when rendering html input tag attributes.
-      #   Use <tt>input_options.type</tt> to control input type including <tt>textarea</tt>.
-      # * <tt>:label_options</tt> - options passed when rendering html label tag attributes
+      # @option options [String] header Determines the header of the filter.
+      # @option options [Object, Proc] default The default filter value. Accepts a `Proc` to allow dynamic calculation.
+      # @option options [Boolean] range Whether the filter accepts two values to define a range.
+      #   Supported by types: `:integer`, `:float`, `:date`, `:datetime`, and `:string`.
+      # @option options [Boolean, String] multiple If true, allows multiple values for the filter.
+      #   Strings are parsed using a separator (default: `,`). Can accept a custom separator. Default: `false`.
+      # @option options [Boolean] allow_nil Whether the filter value can be `nil`. Default: `false`.
+      # @option options [Boolean] allow_blank Whether the filter value can be blank. Default: `false`.
+      # @option options [Symbol] before Specifies the position of this filter by placing it before another filter.
+      #   Used with the `datagrid_form_for` helper.
+      # @option options [Symbol] after Specifies the position of this filter by placing it after another filter.
+      #   Used with the `datagrid_form_for` helper.
+      # @option options [Boolean] dummy If true, the filter is not applied automatically and
+      #   is only displayed in the form. Useful for manual application.
+      # @option options [Proc, Symbol] if Specifies a condition under which the filter is displayed and used.
+      #   Accepts a block or the name of an instance method.
+      # @option options [Proc, Symbol] unless Specifies a condition under which the filter is NOT displayed or used.
+      #   Accepts a block or the name of an instance method.
+      # @option options [Hash] input_options Options passed to the HTML input tag for rendering attributes.
+      #   Use `input_options[:type]` to control the input type (e.g., `textarea`).
+      # @option options [Hash] label_options Options passed to the HTML label tag for rendering attributes.
+      # @see Datagrid::Filters
       def filter(name, type = :default, **options, &block)
         klass = type.is_a?(Class) ? type : FILTER_TYPES[type]
         raise ConfigurationError, "filter class #{type.inspect} not found" unless klass

data/lib/datagrid/form_builder.rb

@@ -5,6 +5,14 @@ require "datagrid/deprecated_object"
 
 module Datagrid
   module FormBuilder
+    # @!visibility private
+    TYPE_METHOD_MAP = {
+      search: :search_field,
+      textarea: :text_area,
+      hidden: :hidden_field,
+      number: :number_field,
+    }.with_indifferent_access
+
     # @param filter_or_attribute [Datagrid::Filters::BaseFilter, String, Symbol] filter object or filter name
     # @param options [Hash] options of rails form input helper
     # @return [String] a form input html for the corresponding filter name
@@ -56,16 +64,12 @@ module Datagrid
         datetime_local_field filter.name, **options, &block
       when :date
         date_field filter.name, **options, &block
-      when :textarea
-        text_area filter.name, value: object.filter_value_as_string(filter), **options, &block
       when :checkbox
         value = options.fetch(:value, 1).to_s
-        options = { checked: true, **options } if filter.enum_checkboxes? && enum_checkbox_checked?(filter, value)
+        if filter.enum_checkboxes? && enum_checkbox_checked?(filter, value) && !options.key?(:checked)
+          options[:checked] = true
+        end
         check_box filter.name, options, value
-      when :hidden
-        hidden_field filter.name, **options
-      when :number
-        number_field filter.name, **options
       when :select
         select(
           filter.name,
@@ -80,7 +84,13 @@ module Datagrid
           &block
         )
       else
-        text_field filter.name, value: object.filter_value_as_string(filter), **options, &block
+        public_send(
+          TYPE_METHOD_MAP[type] || :text_field,
+          filter.name,
+          value: object.filter_value_as_string(filter),
+          **options,
+          &block
+        )
       end
     end
 

data/lib/datagrid/generators/scaffold.rb

@@ -2,7 +2,6 @@
 
 require "rails/generators"
 
-# @!visibility private
 module Datagrid
   # @!visibility private
   module Generators

data/lib/datagrid/helper.rb

@@ -17,7 +17,8 @@ module Datagrid
   # [built-in CSS](https://github.com/bogdan/datagrid/blob/master/app/assets/stylesheets/datagrid.sass).
   #
   # Datagrid includes helpers and a form builder for easy frontend generation.
-  # If you need a fully-featured custom GUI, create your templates manually with the help of the {Datagrid::Columns} API.
+  # If you need a fully-featured custom GUI, create your templates manually
+  # with the help of the {Datagrid::Columns} API.
   #
   # ## Controller and Routing
   #
@@ -63,7 +64,8 @@ module Datagrid
   #
   # ### Advanced Method
   #
-  # You can use Rails built-in tools to create a form. Additionally, Datagrid provides helpers to generate input/select elements for filters:
+  # You can use Rails built-in tools to create a form.
+  # Additionally, Datagrid provides helpers to generate input/select elements for filters:
   #
   # ``` haml
   # - form_with model: UserGrid.new, method: :get, url: users_path do |f|
@@ -169,7 +171,7 @@ module Datagrid
   #
   # To customize Datagrid views:
   #
-  #     rake datagrid:copy_partials
+  #     rails g datagrid:views
   #
   # This creates files in `app/views/datagrid/`, which you can modify to suit your needs:
   #
@@ -240,7 +242,7 @@ module Datagrid
   #
   # https://github.com/bogdan/datagrid/blob/master/lib/datagrid/locale/en.yml
   module Helper
-    # @param grid [Datagrid] grid object
+    # @param grid [Datagrid::Base] grid object
     # @param column [Datagrid::Columns::Column, String, Symbol] column name
     # @param model [Object] an object from grid scope
     # @return [Object] individual cell value from the given grid, column name and model
@@ -264,19 +266,16 @@ module Datagrid
     # Renders html table with columns defined in grid class.
     # In the most common used you need to pass paginated collection
     # to datagrid table because datagrid do not have pagination compatibilities:
-    # Supported options:
-    #
-    # * <tt>:html</tt> - hash of attributes for <table> tag
-    # * <tt>:order</tt> - If false do not generate ordering controlls.
-    #   Default: true.
-    # * <tt>:columns</tt> - Array of column names to display.
-    #   Used in case when same grid class is used in different places
-    #   and needs different columns. Default: all defined columns.
-    # * <tt>:partials</tt> - Path for partials lookup.
-    #   Default: 'datagrid'.
-    # @param grid [Datagrid] grid object
+    # @param grid [Datagrid::Base] grid object
     # @param assets [Array] objects from grid scope
     # @param [Hash{Symbol => Object}] options HTML attributes to be passed to `<table>` tag
+    # @option options [Hash] html A hash of attributes for the `<table>` tag.
+    # @option options [Boolean] order Whether to generate ordering controls.
+    #   If set to `false`, ordering controls are not generated. Default: `true`.
+    # @option options [Array<Symbol>] columns An array of column names to display.
+    #   Use this when the same grid class is used in different contexts and requires different columns.
+    #   Default: all defined columns.
+    # @option options [String] partials The path for partials lookup. Default: `'datagrid'`.
     # @return [String] table tag HTML markup
     # @example
     #   assets = grid.assets.page(params[:page])
@@ -294,16 +293,14 @@ module Datagrid
 
     # Renders HTML table header for given grid instance using columns defined in it
     #
-    # Supported options:
-    #
-    # * <tt>:order</tt> - display ordering controls built-in into header
-    #   Default: true
-    # * <tt>:columns</tt> - Array of column names to display.
-    #   Used in case when same grid class is used in different places
-    #   and needs different columns. Default: all defined columns.
-    # * <tt>:partials</tt> - Path for partials lookup.
-    #   Default: 'datagrid'.
-    # @param grid [Datagrid] grid object
+    # @option options [Boolean] order Whether to display ordering controls built into the header.
+    #   Default: `true`.
+    # @option options [Array<Symbol,String>] columns An array of column names to display.
+    #   Use this when the same grid class is used in different contexts and requires different columns.
+    #   Default: all defined columns.
+    # @option options [String] partials The path for partials lookup.
+    #   Default: `'datagrid'`.
+    # @param grid [Datagrid::Base] grid object
     # @param [Object] opts (deprecated) pass keyword arguments instead
     # @param [Hash] options
     # @return [String] HTML table header tag markup
@@ -321,22 +318,21 @@ module Datagrid
     # Renders HTML table rows using given grid definition using columns defined in it.
     # Allows to provide a custom layout for each for in place with a block
     #
-    # Supported options:
-    #
-    # * <tt>:columns</tt> - Array of column names to display.
-    #   Used in case when same grid class is used in different places
-    #   and needs different columns. Default: all defined columns.
-    # * <tt>:partials</tt> - Path for partials lookup.
-    #   Default: 'datagrid'.
-    #
+    # @option options [Array<Symbol>] columns An array of column names to display.
+    #   Use this when the same grid class is used in different contexts and requires different columns.
+    #   Default: all defined columns.
+    # @option options [String] partials The path for partials lookup.
+    #   Default: `'datagrid'`.
     # @return [String]
-    # @example
-    #   = datagrid_rows(grid) # Generic table rows Layout
-    #
-    #   = datagrid_rows(grid) do |row| # Custom Layout
+    # @example Generic table rows Layout
+    #   = datagrid_rows(grid)
+    # @example Custom Layout
+    #   = datagrid_rows(grid) do |row|
     #     %tr
     #       %td= row.project_name
     #       %td.project-status{class: row.status}= row.status
+    # @param [Datagrid::Base] grid datagrid object
+    # @param [Array<Object>] assets assets as per defined in grid scope
     def datagrid_rows(grid, assets = grid.assets, **options, &block)
       safe_join(
         assets.map do |asset|
@@ -346,11 +342,12 @@ module Datagrid
     end
 
     # @return [String] renders ordering controls for the given column name
-    #
-    # Supported options:
-    #
-    # * <tt>:partials</tt> - Path for partials lookup.
-    #   Default: 'datagrid'.
+    # @option options [String] partials The path for partials lookup.
+    #   Default: `'datagrid'`.
+    # @param [Datagrid::Base] grid datagrid object
+    # @param [Datagrid::Columns::Column] column
+    # @deprecated Put necessary code inline inside datagrid/head partial.
+    #   See built-in partial for example.
     def datagrid_order_for(grid, column, options = {})
       Datagrid::Utils.warn_once(<<~MSG)
         datagrid_order_for is deprecated.
@@ -362,15 +359,11 @@ module Datagrid
     end
 
     # Renders HTML for grid with all filters inputs and labels defined in it
-    #
-    # Supported options:
-    #
-    # * <tt>:partials</tt> - Path for form partial lookup.
-    #   Default: 'datagrid' results in using `app/views/datagrid/` partials.
-    #   Example: 'datagrid_admin' results in using `app/views/datagrid_admin` partials.
-    # * <tt>:model</tt> - Datagrid object to be rendedred.
-    # * All options supported by Rails <tt>form_with</tt> helper
-    # @param grid [Datagrid] grid object
+    # @option options [String] partials Path for form partial lookup.
+    #   Default: `'datagrid'`, which uses `app/views/datagrid/` partials.
+    #   Example: `'datagrid_admin'` uses `app/views/datagrid_admin` partials.
+    # @option options [Datagrid::Base] model a Datagrid object to be rendered.
+    # @option options [Hash] All options supported by Rails `form_with` helper.
     # @param [Hash{Symbol => Object}] options
     # @return [String] form HTML tag markup
     def datagrid_form_with(**options)
@@ -390,7 +383,7 @@ module Datagrid
     #   Default: 'datagrid'.
     # * All options supported by Rails <tt>form_with</tt> helper
     # @deprecated Use {#datagrid_form_with} instead.
-    # @param grid [Datagrid] grid object
+    # @param grid [Datagrid::Base] grid object
     # @param [Hash] options
     # @return [String] form HTML tag markup
     def datagrid_form_for(grid, options = {})
@@ -409,25 +402,24 @@ module Datagrid
 
     # Provides access to datagrid columns data.
     # Used in case you want to build html table completelly manually
-    # @param grid [Datagrid] grid object
+    # @param grid [Datagrid::Base] grid object
     # @param asset [Object] object from grid scope
     # @param block [Proc] block with Datagrid::Helper::HtmlRow as an argument returning a HTML markup as a String
     # @param [Hash{Symbol => Object}] options
     # @return [Datagrid::Helper::HtmlRow, String] captured HTML markup if block given otherwise row object
-    # @example
-    #   # Suppose that grid has first_name and last_name columns
+    # @example Render default layout for row
+    #   <%= datagrid_row(grid, user, columns: [:first_name, :last_name, :actions]) %>
+    # @example Rendering custom layout for `first_name` and `last_name` columns
     #   <%= datagrid_row(grid, user) do |row| %>
     #     <tr>
     #       <td><%= row.first_name %></td>
     #       <td><%= row.last_name %></td>
     #     </tr>
     #   <% end %>
-    # @example
+    # @example Rendering custom layout passing a block
     #   <% row = datagrid_row(grid, user) %>
     #   First Name: <%= row.first_name %>
     #   Last Name: <%= row.last_name %>
-    # @example
-    #   <%= datagrid_row(grid, user, columns: [:first_name, :last_name, :actions]) %>
     def datagrid_row(grid, asset, **options, &block)
       Datagrid::Helper::HtmlRow.new(self, grid, asset, options).tap do |row|
         return capture(row, &block) if block_given?
@@ -435,7 +427,7 @@ module Datagrid
     end
 
     # Generates an ascending or descending order url for the given column
-    # @param grid [Datagrid] grid object
+    # @param grid [Datagrid::Base] grid object
     # @param column [Datagrid::Columns::Column, String, Symbol] column name
     # @param descending [Boolean] order direction, descending if true, otherwise ascending.
     # @return [String] order layout HTML markup
@@ -475,7 +467,7 @@ module Datagrid
     #   row = datagrid_row(grid, user)
     #   row.class      # => Datagrid::Helper::HtmlRow
     #   row.first_name # => "<strong>Bogdan</strong>"
-    #   row.grid       # => Grid object
+    #   row.grid       # => Datagrid::Base object
     #   row.asset      # => User object
     #   row.each do |value|
     #     puts value

data/lib/datagrid/ordering.rb

@@ -33,6 +33,35 @@ module Datagrid
       end
     end
 
+    # @!method order=(value)
+    #   Specify a column to be used to order the grid
+    #   @param [Symbol, String] value column name
+    #   @return [void]
+    #   @example
+    #     class MyGrid < ApplicationGrid
+    #       scope { User }
+    #       column(:name)
+    #     end
+    #
+    #     grid = MyGrid.new
+    #     grid.order = :name
+    #     grid.descending = true
+    #     grid.assets # => SELECT * FROM users ORDER BY users.name DESC
+
+    # @!method order
+    #   @return [Symbol, nil] specified order column name
+    #   @see #order=
+
+    # @!method descending=(value)
+    #   Specify an order direction for an order column
+    #   @param [Boolean] value specify `true` for descending order` or `false` for ascending
+    #   @return [void]
+    #   @see #order=
+
+    # @!method descending?
+    #   @return [Boolean] specified order direction
+    #   @see #descending=
+
     # @!visibility private
     def assets
       check_order_valid!

data/lib/datagrid/utils.rb

@@ -133,8 +133,8 @@ module Datagrid
           !property_availability(grid, unless_option, false)
       end
 
-      def callable(value)
-        value.respond_to?(:call) ? value.call : value
+      def callable(value, *arguments)
+        value.respond_to?(:call) ? value.call(*arguments) : value
       end
 
       protected

data/lib/datagrid/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Datagrid
-  VERSION = "2.0.0-alpha"
+  VERSION = "2.0.1"
 end

data/lib/datagrid.rb

@@ -4,7 +4,6 @@ require "action_view"
 require "datagrid/configuration"
 require "datagrid/engine"
 
-# @main README.md
 module Datagrid
   # @!visibility private
   def self.included(base)
@@ -19,15 +18,6 @@ module Datagrid
     end
   end
 
-  def self.configuration
-    @configuration ||= Configuration.new
-  end
-
-  # Configure
-  def self.configure(&block)
-    block.call(configuration)
-  end
-
   class ConfigurationError < StandardError; end
   class ArgumentError < ::ArgumentError; end
   class ColumnUnavailableError < StandardError; end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: datagrid
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre.alpha
+  version: 2.0.1
 platform: ruby
 authors:
 - Bogdan Gusiev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-19 00:00:00.000000000 Z
+date: 2025-01-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -33,6 +33,7 @@ extra_rdoc_files:
 - LICENSE.txt
 - README.md
 files:
+- ".yardopts"
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
@@ -93,7 +94,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/bogdan/datagrid
   bug_tracker_uri: https://github.com/bogdan/datagrid/issues
-  documentation_uri: https://github.com/bogdan/datagrid/wiki
+  documentation_uri: https://rubydoc.info/gems/datagrid
   changelog_uri: https://github.com/bogdan/datagrid/blob/main/CHANGELOG.md
   source_code_uri: https://github.com/bogdan/datagrid
   rubygems_mfa_required: 'true'