active_scaffold 4.3.1 → 4.4.0

data/lib/active_scaffold/helpers/form_ui_helpers.rb

@@ -27,18 +27,23 @@ module ActiveScaffold
 
       def active_scaffold_input_singular_association(column, html_options, options = {}, ui_options: column.options)
         record = html_options.delete(:object)
-        associated = html_options.include?(:associated) ? html_options.delete(:associated) : record.send(column.association.name)
-
         helper_method = association_helper_method(column.association, :sorted_association_options_find)
         select_options = send(helper_method, column.association, nil, record)
-        select_options.unshift(associated) if associated&.persisted? && select_options.exclude?(associated)
+
+        if html_options.include?(:associated)
+          options[:selected] ||= html_options.delete(:associated)
+        else
+          associated = record.send(column.association.name)
+          select_options.unshift(associated) if associated&.persisted? && select_options.exclude?(associated)
+          options[:selected] ||= associated&.id
+        end
 
         method = column.name
-        options.merge! selected: associated&.id, include_blank: as_(:_select_), object: record
+        options.reverse_merge! include_blank: as_(:_select_), object: record
 
         html_options.merge!(ui_options[:html_options] || {})
         options.merge!(ui_options)
-        html_options.delete(:multiple) # no point using multiple in a form for singular assoc, but may be set for field search
+        active_scaffold_select_name_with_multiple html_options # doesn't make sense most of time, but AS_batch use it
         active_scaffold_translate_select_options(options)
 
         html =
@@ -101,7 +106,7 @@ module ActiveScaffold
         url_options[:parent_model] ||= record.class.name
         url_options[:parent_column] ||= column.name
         url_options.reverse_merge! options[:url_options] if options[:url_options]
-        link_to(link_text, url_options, remote: true, data: {position: :popup}, class: 'as_action')
+        link_to(link_text, url_options, as_element_attributes(:field_add_new_popup, remote: true, data: {position: :popup}, class: 'as_action'))
       end
 
       def active_scaffold_new_record_subform(column, record, html_options, options: {}, new_record_attributes: nil, locals: {}, skip_link: false)
@@ -141,7 +146,7 @@ module ActiveScaffold
         create_new = active_scaffold_add_new_text(options, :add_new_text, :create_new)
         data = {select_id: select_id, subform_id: subform_id, subform_text: add_existing, select_text: create_new}
         label = data[record.send(column.name)&.new_record? ? :subform_text : :select_text]
-        link_to(label, '#', data: data, class: 'show-new-subform')
+        link_to(label, '#', as_element_attributes(:field_add_new_subform, data: data, class: 'show-new-subform'))
       end
 
       def active_scaffold_file_with_content(column, options, content, remove_file_prefix, controls_class, ui_options: column.options)
@@ -237,8 +242,8 @@ module ActiveScaffold
         end
       end
 
-      def active_scaffold_checkbox_option(option, label_method, associated_ids, checkbox_options, li_options = {})
-        content_tag(:li, li_options) do
+      def active_scaffold_checkbox_option(option, label_method, associated_ids, checkbox_options, item_options = {})
+        content_tag(:li, item_options) do
           option_id = option.is_a?(Array) ? option[1] : option.id
           label = option.is_a?(Array) ? option[0] : option.send(label_method)
           check_box_tag(checkbox_options[:name], option_id, associated_ids.include?(option_id), checkbox_options) <<
@@ -261,7 +266,7 @@ module ActiveScaffold
         html << content_tag(:ul, options.merge(class: "#{options[:class]} checkbox-list#{' draggable-lists' if draggable}")) do
           content = []
           select_options.each_with_index do |option, i|
-            content << active_scaffold_checkbox_option(option, label_method, associated_ids, name: "#{options[:name]}[]", id: "#{options[:id]}_#{i}_id")
+            content << active_scaffold_checkbox_option(option, label_method, associated_ids, {name: "#{options[:name]}[]", id: "#{options[:id]}_#{i}_id"}, ui_options[:item_options] || {})
           end
           safe_join content
         end

data/lib/active_scaffold/helpers/framework_ui_helpers.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module ActiveScaffold
+  module Helpers
+    module FrameworkUiHelpers
+      def as_element(key, content = nil, proc_options: {}, **options, &)
+        tag, attributes = as_tag_and_attributes(key, options, proc_options)
+        content_tag(tag, content, attributes, &)
+      end
+
+      def as_element_attributes(key, proc_options: {}, **options)
+        as_tag_and_attributes(key, options, proc_options).last
+      end
+
+      def as_tag_and_attributes(key, options, proc_options = {})
+        tag, attributes, proc = ActiveScaffold.ui_elements[key]&.values_at(:tag, :attributes, :proc)
+        tag, attributes = instance_exec(proc_options, &proc) if proc
+        [tag, attributes&.smart_merge(options) || options&.as_html_attrs]
+      end
+    end
+  end
+end

data/lib/active_scaffold/helpers/human_condition_helpers.rb

@@ -72,6 +72,7 @@ module ActiveScaffold
       alias active_scaffold_human_condition_time active_scaffold_human_condition_datetime
       alias active_scaffold_human_condition_date active_scaffold_human_condition_datetime
       alias active_scaffold_human_condition_timestamp active_scaffold_human_condition_datetime
+      alias active_scaffold_human_condition_timestamptz active_scaffold_human_condition_datetime
 
       def active_scaffold_human_condition_datetime_range_format(range_type, range)
         case range

data/lib/active_scaffold/helpers/list_column_helpers.rb

@@ -431,6 +431,24 @@ module ActiveScaffold
         data
       end
 
+      def local_sorting?
+        @page&.pager&.number_of_pages == 1 && active_scaffold_config.list.local_sorting
+      end
+
+      def column_sort_value(record, column)
+        value = record.send(column.name)
+        return if value.nil?
+
+        case column.column.type
+        when :time, :datetime, Time then value.to_i
+        when :boolean then value ? 1 : 0
+        when :binary then nil
+        when :integer then value
+        when :float, :decimal then (value % 1).zero? ? value.to_i : value
+        else value.to_s
+        end
+      end
+
       # MARK
 
       def all_marked?
@@ -465,6 +483,7 @@ module ActiveScaffold
         elsif column.inplace_edit
           tag_options[:data] = inplace_edit_data(column)
         end
+
         content_tag(:th, column_heading_value(column, sorting, sort_direction) + inplace_edit_control(column), tag_options)
       end
 

data/lib/active_scaffold/helpers/pagination_helpers.rb

@@ -3,8 +3,13 @@
 module ActiveScaffold
   module Helpers
     module PaginationHelpers
-      def pagination_ajax_link(page_number, url_options, options)
-        link_to page_number, url_options.merge(page: page_number), options.merge(class: 'as_paginate')
+      def pagination_ajax_link(page_number, url_options, options, text: nil)
+        attributes = as_element_attributes(
+          :pagination_link,
+          proc_options: {page_number: page_number, text: text},
+          **options.smart_merge(class: 'as_paginate')
+        )
+        link_to text ? as_(text) : page_number, url_options.merge(page: page_number), attributes
       end
 
       def pagination_url_options(url_options = nil)
@@ -17,6 +22,22 @@ module ActiveScaffold
         url_options
       end
 
+      def pagination_active_page(page_number, url_options, options)
+        attributes = options.slice(:id, :class).smart_merge(class: 'as_paginate current')
+        as_element :pagination_active_page, page_number,
+                   proc_options: {page_number: page_number}, **attributes
+      end
+
+      def pagination_gap(options)
+        '..'
+      end
+
+      # Wraps the complete pagination sequence, including previous and next links.
+      # UI adapters may override this method and call +super+ to add nested markup.
+      def pagination_html(&)
+        capture(&)
+      end
+
       def pagination_ajax_links(current_page, url_options, options, inner_window, outer_window)
         start_number = current_page.number - inner_window
         end_number = current_page.number + inner_window
@@ -42,16 +63,16 @@ module ActiveScaffold
             page = current_page.number - offset
             next unless page < start_number && page > last_page
 
-            html << '..' if page > last_page + 1
+            html << pagination_gap(options) if page > last_page + 1
             html << pagination_ajax_link(page, url_options, options)
             last_page = page
           end
         end
-        html << '..' if start_number > last_page + 1
+        html << pagination_gap(options) if start_number > last_page + 1
 
         [start_number, last_page + 1].max.upto(end_number) do |num|
           html << if current_page.number == num
-                    content_tag(:span, num.to_s, class: 'as_paginate current')
+                    pagination_active_page(num, url_options, options)
                   else
                     pagination_ajax_link(num, url_options, options)
                   end
@@ -59,10 +80,10 @@ module ActiveScaffold
 
         if current_page.pager.infinite?
           offsets.each do |offset|
-            html << '..' << pagination_ajax_link(current_page.number + offset, url_options, options)
+            html << pagination_gap(options) << pagination_ajax_link(current_page.number + offset, url_options, options)
           end
         else
-          html << '..' unless end_number >= current_page.pager.last.number - outer_window - 1
+          html << pagination_gap(options) unless end_number >= current_page.pager.last.number - outer_window - 1
           [end_number + 1, current_page.pager.last.number - outer_window].max.upto(current_page.pager.last.number) do |num|
             html << pagination_ajax_link(num, url_options, options)
           end

data/lib/active_scaffold/helpers/search_column_helpers.rb

@@ -50,14 +50,29 @@ module ActiveScaffold
 
       # the standard active scaffold options used for class, name and scope
       def active_scaffold_search_options(column)
-        {name: "search[#{column.name}]", class: "#{column.name}-input", id: "search_#{column.name}", value: field_search_params[column.name.to_s]}
+        attributes = {
+          name: "search[#{column.name}]",
+          class: "#{column.name}-input",
+          id: "search_#{column.name}",
+          value: field_search_params[column.name.to_s]
+        }
+        as_element_attributes(:search_control, proc_options: {column: column, search_ui: column.search_ui}, **attributes)
       end
 
       def search_attribute(column, record)
         column_options = active_scaffold_search_options(column).merge(object: record)
-        content_tag :dl do
-          content_tag(:dt, label_tag(search_label_for(column, column_options), search_column_label(column, record))) <<
-            content_tag(:dd, active_scaffold_search_for(column, column_options))
+        search_attribute_html(
+          column,
+          label_tag(search_label_for(column, column_options), search_column_label(column, record)),
+          active_scaffold_search_for(column, column_options)
+        )
+      end
+
+      def search_attribute_html(column, label, field)
+        context = {column: column}
+        as_element :search_attribute, proc_options: context do
+          as_element(:search_attribute_label, label, proc_options: context) <<
+            as_element(:search_attribute_field, field, proc_options: context)
         end
       end
 
@@ -156,7 +171,7 @@ module ActiveScaffold
         select_options << [as_(:true), true] # rubocop:disable Lint/BooleanSymbol
         select_options << [as_(:false), false] # rubocop:disable Lint/BooleanSymbol
 
-        select_tag(options[:name], options_for_select(select_options, ActiveScaffold::Core.column_type_cast(options[:value], column.column)), id: options[:id])
+        select_tag(options[:name], options_for_select(select_options, ActiveScaffold::Core.column_type_cast(options[:value], column.column, column.model)), id: options[:id])
       end
       # we can't use checkbox ui because it's not possible to decide whether search for this field or not
       alias active_scaffold_search_checkbox active_scaffold_search_boolean
@@ -296,6 +311,7 @@ module ActiveScaffold
       def active_scaffold_search_timestamp(column, options, ui_options: column.options)
         active_scaffold_search_datetime(column, options, ui_options: ui_options, field_ui: :datetime)
       end
+      alias active_scaffold_search_timestamptz active_scaffold_search_timestamp
 
       def active_scaffold_search_time(column, options, ui_options: column.options)
         active_scaffold_search_datetime(column, options, ui_options: ui_options, field_ui: :time)
@@ -425,6 +441,17 @@ module ActiveScaffold
         [visibles, hiddens]
       end
 
+      def render_field_search_column(column, record)
+        column_css_class = column.css_class unless column.css_class.is_a?(Proc)
+        if column.respond_to? :each_column
+          as_element :field_search_subsection, class: column_css_class do
+            render_subsection column, record, nil, :field_search, partial: 'field_search_columns'
+          end
+        else
+          as_element :field_search_element, search_attribute(column, record), class: "form-element #{column_css_class}"
+        end
+      end
+
       def searched_by?(column)
         value = field_search_params[column.name.to_s]
         case value

data/lib/active_scaffold/helpers/tabs_helpers.rb

@@ -6,11 +6,11 @@ module ActiveScaffold
     module TabsHelpers
       def active_scaffold_tabbed_by(column, record, scope, subsection_id, &)
         add_tab_url = params_for(action: 'render_field', tabbed_by: column.tabbed_by, id: record.to_param, column: column.label)
-        refresh_opts = {refresh_link: {text: 'Add tab', class: 'refresh-link add-tab'}}
+        refresh_opts = {field_selector: "##{subsection_id}_input", refresh_link: {text: 'Add tab', class: 'refresh-link add-tab'}}
         tab_options = send(override_helper_per_model(:active_scaffold_tab_options, record.class), column, record)
         used_tabs = send(override_helper_per_model(:active_scaffold_current_tabs, record.class), column, record, tab_options)
         input_helper = override_helper_per_model(:active_scaffold_input_for_tabbed, record.class)
-        send(input_helper, column, record, subsection_id, tab_options, used_tabs.map(&:first)) <<
+        send(input_helper, column, record, subsection_id, tab_options, used_tabs.map { |v, _| v }) <<
           active_scaffold_refresh_link(nil, {'data-update_url' => url_for(add_tab_url)}, record, refresh_opts) <<
           active_scaffold_tabs_for(column, record, subsection_id, tab_options, used_tabs, &)
       end
@@ -32,8 +32,6 @@ module ActiveScaffold
           tab_values = record.send(col.name).map(&tabbed_by).compact
           if tabbed_by_association(col, tabbed_by)
             tab_values.map! { |value| [value, value.id.to_s] }
-          else
-            tab_values.map! { |value| [tab_options.find { |_, tab_value, _| value == tab_value }&.first || value, value] }
           end
           used_choices.merge tab_values
         end
@@ -41,7 +39,7 @@ module ActiveScaffold
       end
 
       def active_scaffold_tab_options(column, record)
-        subform_column = column.first
+        subform_column = column.visible_columns.first
         if subform_column
           tabbed_by = subform_column.options[:tabbed_by] || column.tabbed_by
           if tabbed_by_association(subform_column, tabbed_by)
@@ -51,7 +49,7 @@ module ActiveScaffold
         end
         if tab_column
           label_method = (tab_column.form_ui_options || tab_column.options)[:label_method] || :to_label
-          helper_method = association_helper_method(column.association, :sorted_association_options_find)
+          helper_method = association_helper_method(tab_column.association, :sorted_association_options_find)
           send(helper_method, tab_column.association, nil, subform_record).map do |opt_record|
             [opt_record.send(label_method), opt_record.id, opt_record]
           end

data/lib/active_scaffold/helpers/view_helpers.rb

@@ -18,6 +18,7 @@ module ActiveScaffold
       include ActiveScaffold::Helpers::SearchColumnHelpers
       include ActiveScaffold::Helpers::HumanConditionHelpers
       include ActiveScaffold::Helpers::FilterHelpers
+      include ActiveScaffold::Helpers::FrameworkUiHelpers
 
       ##
       ## Delegates
@@ -31,6 +32,12 @@ module ActiveScaffold
       ## Uncategorized
       ##
 
+      # UI adapters may override this method and call +super+ to wrap the table,
+      # for example in a responsive-table container.
+      def list_table_html(&)
+        capture(&)
+      end
+
       def handle_exception_on_column(exception, column, record = nil)
         raise exception if exception.instance_variable_get(:@_active_scaffold_wrapped)
 
@@ -126,6 +133,7 @@ module ActiveScaffold
       def column_heading_class(column, sorting)
         classes = "#{column.name}-column_heading "
         classes << "sorted #{sorting.direction_of(column).downcase} " if sorting.sorts_on? column
+        classes << 'skip-local-sorting' if column.skip_local_sorting?
         classes << column.css_class unless column.css_class.nil? || column.css_class.is_a?(Proc)
         classes
       end
@@ -140,6 +148,10 @@ module ActiveScaffold
         params[:eid] ? {eid: id_from_controller(params[:eid])} : {}
       end
 
+      def server_error_msg(content = nil, **attributes, &)
+        as_element :server_error, content, **attributes, &
+      end
+
       def column_empty?(column_value)
         @_empty_values ||= ['&nbsp;', empty_field_text].compact
         empty = column_value.nil?

data/lib/active_scaffold/tableless.rb

@@ -24,16 +24,19 @@ class ActiveScaffold::Tableless < ActiveRecord::Base
 
   class Column < ActiveRecord::ConnectionAdapters::Column
     def initialize(name, default, type, null = true, *, **) # rubocop:disable Style/OptionalBooleanParameter,Metrics/ParameterLists
-      if Rails.version >= '8.1'
-        if type.is_a?(Symbol)
-          cast_type = ActiveRecord::Type.lookup(type)
-        else
-          metadata = ActiveRecord::Base.connection.send :fetch_type_metadata, type
-          cast_type = ActiveRecord::Type.lookup(metadata.type)
-        end
+      connection = ActiveRecord::Base.connection
+      sql_type = type.is_a?(Symbol) ? connection.type_to_sql(type) : type.to_s
+      cast_type = connection.send(:lookup_cast_type, sql_type)
+      metadata = ActiveRecord::ConnectionAdapters::SqlTypeMetadata.new(
+        sql_type: sql_type,
+        type: cast_type.type,
+        limit: cast_type.limit,
+        precision: cast_type.precision,
+        scale: cast_type.scale
+      )
+      if ActiveRecord.version >= Gem::Version.new('8.1')
         super(name, cast_type, default, metadata, null, *, **)
       else
-        metadata = ActiveRecord::Base.connection.send :fetch_type_metadata, type.to_s
         super(name, default, metadata, null, *, **)
       end
     end

data/lib/active_scaffold/version.rb

@@ -3,8 +3,8 @@
 module ActiveScaffold
   module Version
     MAJOR = 4
-    MINOR = 3
-    PATCH = 1
+    MINOR = 4
+    PATCH = 0
     FIX = nil
 
     STRING = [MAJOR, MINOR, PATCH, FIX].compact.join('.')

data/lib/active_scaffold.rb

@@ -58,6 +58,174 @@ module ActiveScaffold
   mattr_accessor :javascripts, instance_writer: false
   self.javascripts = []
 
+  # A way to define the tags and html attributes used in different places.
+  # Changing the class or replacing the attributes may break the default AS stylesheets, but not JS or functionality.
+  #
+  # The keys in the hash are the names used by ActiveScaffold to identify the
+  # elements.
+  # The values are a hash of attributes used to create the markup, supporting the following keys:
+  # * The :tag key can be used to specify a different tag name for the element.
+  # * The :attributes key can be used to specify additional html attributes.
+  # * The :proc key can be used to specify a method to dinamically return the tag and attributes hash, as an array.
+  #   When :proc is present, :tag and :attributes won't be used. The proc will receive an options hash, which usually
+  #   will be a hash with html attributes, but in some cases may have other options:
+  #   * For :action_link_group the hash will have keys such as :level, :first_action, and other options supported by
+  #     +display_action_links+
+  #   * For :action_link_separator the hash will have keys such as :level, :level_0_tag, and other options supported by
+  #     +display_action_links+
+  #   * Form and search elements receive the column and the configured UI in the options hash.
+  #   * Action link elements receive the link, record, rendering options, and authorized state.
+  #   * Pagination elements receive the page number and, for links, the optional text key.
+  # Some keys don't have a :tag key, because only attributes are used, the tag is hardcoded, usually elements that are
+  # rendered as a form or table, or a table's element (thead, tbody, tr, td, th, tfoot, etc.). For those elements,
+  # the :tag key will be ignored if it's set, so the tag can't be changed.
+  mattr_reader :ui_elements
+  @@ui_elements ||= {
+    list: {tag: :div},
+    list_header: {tag: :div},
+    list_title: {tag: :h2},
+    list_actions: {tag: :div},
+    filters: {tag: :div, attributes: {class: 'filters'}},
+    before_header_table: {tag: :table},
+    list_content: {tag: :div},
+    list_table: {}, # table
+    list_table_head: {}, # thead
+    list_table_head_row: {}, # tr
+    list_records: {}, # tbody
+    list_messages: {attributes: {class: 'messages'}}, # tbody
+    list_messages_container: {}, # td
+    list_action_messages: {tag: :div},
+    filtered_message: {tag: :div, attributes: {class: 'filtered-message'}},
+    applied_filters_message: {tag: :div, attributes: {class: 'filtered-message applied-filters'}},
+    empty_message: {tag: :p},
+    message_reset: {tag: :div, attributes: {class: 'reset'}},
+    message_close: {tag: :a, attributes: {href: '#', class: 'close'}},
+    server_error: {tag: :p, attributes: {class: 'error-message message server-error'}},
+    info_message: {tag: :div, attributes: {class: 'info-message message'}},
+    warning_message: {tag: :div, attributes: {class: 'warning-message message'}},
+    error_message: {tag: :div, attributes: {class: 'error-message message'}},
+    list_footer: {tag: :div, attributes: {class: 'active-scaffold-footer'}},
+    list_found: {tag: :div},
+    list_found_count: {tag: :span},
+    list_calculations: {}, # tr
+    pagination_links: {tag: :div},
+    pagination_link: {}, # a
+    pagination_active_page: {tag: :span},
+    record_actions_cell: {}, # td
+    record_action_links: {}, # table
+    action_link_group: {
+      proc: lambda do |options|
+        if options[:level]&.zero?
+          tag = :div
+          attributes = {class: 'action_group'}
+        else
+          tag = :li
+          attributes = {class: ('top' if options[:first_action]).to_s}
+        end
+        attributes[:class] += ' hover_click' if hover_via_click?
+        [tag, attributes]
+      end
+    },
+    action_link_separator: {
+      proc: lambda do |options|
+        tag = options[:level_0_tag] || :a if options[:level]&.zero?
+        [tag || :li, {class: 'separator'}]
+      end
+    },
+    action_link_group_title: {tag: :div},
+    action_link_group_content: {tag: :ul},
+    action_link: {}, # a
+    action_link_item: {tag: :li},
+    dynamic_action_group: {tag: :ul, attributes: {class: 'dynamic-menu'}},
+    dynamic_action_group_element: {tag: :li},
+    search_form: {}, # form
+    search_field: {attributes: {class: 'text-input', size: 50, autocomplete: :off}}, # input type=search
+    search_control: {}, # input, select or textarea
+    search_submit: {attributes: {class: 'submit'}}, # input type=submit
+    search_reset: {attributes: {class: 'reset'}}, # a
+    field_search_form: {}, # form
+    field_search_fields_columns: {tag: :div, attributes: {class: 'form-columns'}},
+    field_search_fields_container: {tag: :ol},
+    field_search_subsection: {tag: :li, attributes: {class: 'sub-section'}},
+    field_search_element: {tag: :li},
+    field_search_submit: {attributes: {class: 'submit'}}, # input type=submit
+    field_search_reset: {attributes: {class: 'reset'}}, # a
+    field_search_footer: {tag: :p},
+    form: {}, # form
+    form_title: {tag: :h4},
+    form_messages_container: {tag: :div},
+    form_fields_columns: {tag: :div, attributes: {class: 'form-columns'}},
+    fields_container: {tag: :ol},
+    form_subsection: {tag: :li, attributes: {class: 'sub-section'}},
+    form_subsection_header: {tag: :h5},
+    subform: {tag: :li},
+    subform_header: {tag: :h5},
+    subform_footer: {tag: :div, attributes: {class: 'footer'}},
+    subform_record_remove: {}, # a
+    subform_record_remove_reason: {tag: :span, attributes: {class: 'destroy reason'}},
+    subform_create_another: {}, # a
+    subform_replace_with_new: {}, # a
+    subform_add_existing: {}, # a
+    form_element: {tag: :li},
+    form_attribute: {tag: :dl},
+    form_attribute_label: {tag: :dt},
+    form_attribute_field: {tag: :dd},
+    search_attribute: {tag: :dl},
+    search_attribute_label: {tag: :dt},
+    search_attribute_field: {tag: :dd},
+    form_control: {}, # input, select or textarea
+    form_field_description: {tag: :span, attributes: {class: 'description'}},
+    form_field_description_close: {tag: :span, attributes: {class: 'close'}},
+    form_footer: {tag: :p},
+    form_submit: {attributes: {class: 'submit'}}, # input type=submit
+    form_apply: {attributes: {class: 'submit'}}, # input type=submit
+    form_cancel: {}, # a
+    field_add_new_subform: {},
+    field_add_new_popup: {},
+    show_title: {tag: :h4},
+    show_actions: {tag: :div},
+    show_columns_block: {tag: :dl},
+    show_label_block: {tag: :dt},
+    show_columns_group: {tag: :dd},
+    show_value_block: {tag: :dd},
+    show_footer: {tag: :p, attributes: {class: 'form-footer'}},
+    show_cancel: {} # a
+  }
+
+  def self.set_element_tag(name, tag)
+    (ui_elements[name] ||= {})[:tag] = tag
+  end
+
+  # Replace an element's complete definition. Use a block instead of +tag+ and
+  # +attributes+ to define a dynamic element.
+  def self.set_element(name, tag: nil, attributes: nil, &proc)
+    if proc && (tag || attributes)
+      raise ArgumentError, 'tag and attributes cannot be used with a proc'
+    end
+
+    ui_elements[name] = if proc
+                          {proc: proc}
+                        else
+                          {}.tap do |element|
+                            element[:tag] = tag if tag
+                            element[:attributes] = attributes.as_html_attrs if attributes
+                          end
+                        end
+  end
+
+  def self.set_element_proc(name, &block)
+    (ui_elements[name] ||= {})[:proc] = block
+  end
+
+  def self.set_element_attributes(name, attributes)
+    (ui_elements[name] ||= {})[:attributes] = attributes.as_html_attrs
+  end
+
+  def self.add_element_attributes(name, attributes)
+    attrs = (ui_elements[name] ||= {})[:attributes] || {}
+    ui_elements[name][:attributes] = attrs.smart_merge(attributes)
+  end
+
   def self.threadsafe!; end
 
   mattr_writer :jquery_ui_loaded, instance_writer: false
@@ -106,3 +274,4 @@ require 'active_scaffold/engine'
 require 'ice_nine'
 require 'ice_nine/core_ext/object'
 require 'request_store'
+require 'html_attrs'

data/lib/tasks/bundle.rake

@@ -16,7 +16,8 @@ namespace :bundle do
     gemfiles.each do |gemfile|
       puts "Locking #{File.basename(gemfile)}..."
       Bundler.with_unbundled_env do
-        system("bundle lock --gemfile='#{gemfile}'")
+        command = ['bundle', 'lock', "--gemfile=#{gemfile}", '--add-platform', 'ruby']
+        system(*command, exception: true)
       end
     end
 

data/lib/tasks/mock_app.rake

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+namespace :mock_app do
+  desc 'Build the mock app stylesheets'
+  task :assets do
+    environment = {
+      'BUNDLE_GEMFILE' => File.expand_path(ENV.fetch('BUNDLE_GEMFILE', 'Gemfile'))
+    }
+    Dir.chdir('test/mock_app') do
+      system(environment, 'rails', 'dartsass:build', exception: true)
+    end
+  end
+
+  desc 'Start the mock_app server and Dart Sass watcher (default port 3000)'
+  task :server do
+    args = ARGV.drop_while { |a| a != '--' }.drop(1)
+    Dir.chdir('test/mock_app') do
+      environment = {'BUNDLE_GEMFILE' => File.expand_path('../../Gemfile', __dir__)}
+      system(environment, 'rails', 'dartsass:build', exception: true)
+      watcher = Process.spawn(environment, 'rails', 'dartsass:watch')
+      _pid, status = Process.wait2(Process.spawn(environment, 'rails', 'server', *args))
+      exit status.exitstatus
+    ensure
+      begin
+        if watcher
+          Process.kill('TERM', watcher)
+          Process.wait(watcher)
+        end
+      rescue Errno::ECHILD, Errno::ESRCH
+        # The watcher already exited.
+      end
+    end
+  end
+
+  desc 'Start the mock_app console'
+  task :console do
+    args = ARGV.drop_while { |a| a != '--' }.drop(1)
+    Dir.chdir('test/mock_app') do
+      exec({'BUNDLE_GEMFILE' => File.expand_path('../../Gemfile', __dir__)},
+           'rails', 'console', *args)
+    end
+  end
+end