Purpose

Fixes #1152 by adding a new mount_with_defaults method that can inject some helpful defaults into components.

Description

I'd like to get some feedback from others before I go too far down any given path. That said, I've got the thing that was blocking me working. Say we have a component with a form, like this:

class Filters::Form < BaseComponent
  needs context : HTTP::Server::Context
  needs current_user : User
  needs operation : SaveFilter
  needs route : Lucky::RouteHelper
  needs button_text : String

  def render
    form_for route, class: "divide-y divide-gray-200" do
      div class: "px-4 py-5 sm:p-6 space-y-4" do
        mount Filters::FormFields, operation
      end

      div class: "px-4 py-4 sm:px-6" do
        mount UI::Button, &.submit button_text
      end
    end
  end
end

This is a really nice abstraction, and greatly cleans up the duplication between edit_page.cr andnew_page.cr for the Filter model, in this case.

I'm not super thrilled about having to manually add needs context and needs current_user to the component, but also not sure if we can inject that after the component is initialized so that it's available but invisible.

The use of this component looks something like this:

class Filters::NewPage < MainLayout
  needs operation : SaveFilter
  quick_def page_title, "New Filter"

  def content
    div class: "bg-white overflow-hidden shadow rounded-lg divide-y divide-gray-200" do
      div class: "px-4 py-5 sm:px-6" do
        h3 class: "text-lg leading-6 font-medium text-gray-900" do
          text "New filter"
        end
      end

      mount_with_defaults Filters::Form, operation: operation, route: Filters::Create.route, button_text: "Create filter"
    end
  end
end

To-do

• - Add specs for the new mount_with_defaults

Checklist

• - An issue already exists detailing the issue/or feature request that this PR fixes
• - All specs are formatted with crystal tool format spec src
• - Inline documentation has been added and/or updated
• - Lucky builds on docker with ./script/setup
• - All builds and specs pass on docker with ./script/test