brut 0.11.0 → 0.12.1

data/lib/brut/front_end/components/inputs/button_tag.rb

@@ -0,0 +1,43 @@
+# Creates a button tag to be used inside a form. This is only 
+# needed if your form declared a `button` and you wish the value
+# to be included whern the form is submitted (for example, if you have
+# more than one submit button and wish to know which one was clicked on the
+# back end).
+class Brut::FrontEnd::Components::Inputs::ButtonTag < Brut::FrontEnd::Components::Input
+
+  # Creates the appropriate button for the given {Brut::FrontEnd::Form} and input name. Note that if the
+  # form has no value for this input, the value `"true"` will be used, as this allows you to create
+  # buttons without worrying about an often irrelevant value.
+  #
+  # @param [Brut::FrontEnd::Form} form The form that is being rendered. This method will consult this class to understand the requirements on this input so its HTML is generated correctly.
+  # @param [String] input_name the name of the input, which should be a member of `form`
+  # @param [Integer] index if this input is part of an array, this is the index into that array. This is used to get the input's value.
+  # @param [Hash] html_attributes any additional HTML attributes to include on the `<input>` element. Note 
+  #               that if you set `type` here to be `reset` or `button`, this button will not submit
+  #               the form (as per the HTML spec).  Also note that the various
+  #               `form*` attributes *will* take effect and work as desired.
+  def initialize(form:, input_name:, index: nil, **html_attributes)
+    input = form.input(input_name, index:)
+    if input.class.name != "Brut::FrontEnd::Forms::Button"
+      raise ArgumentError, "#{self.class} can only be used with `button` elements, not #{input.class.name} form elements"
+    end
+    default_html_attributes = {}
+    html_attributes = html_attributes.map { |key,value| [ key.to_sym, value ] }.to_h
+
+    default_html_attributes[:name] = if input.array?
+                                       "#{input.name}[]"
+                                     else
+                                       input.name
+                                     end
+    value = RichString.from_string(input.value)
+    default_html_attributes[:value] = (value || "true").to_s
+
+    @attributes = default_html_attributes.merge(html_attributes)
+  end
+
+  def view_template
+    button(**@attributes) do
+      yield
+    end
+  end
+end

data/lib/brut/front_end/components/inputs/input_tag.rb

@@ -3,7 +3,6 @@ class Brut::FrontEnd::Components::Inputs::InputTag < Brut::FrontEnd::Components:
   def invalid? = @attributes["data-invalid"] == true
 
   # Creates the appropriate input for the given {Brut::FrontEnd::Form} and input name.
-  # Generally, you want to use this method over the initializer.
   #
   # @param [Brut::FrontEnd::Form} form The form that is being rendered. This method will consult this class to understand the requirements on this input so its HTML is generated correctly.
   # @param [String] input_name the name of the input, which should be a member of `form`
@@ -11,6 +10,9 @@ class Brut::FrontEnd::Components::Inputs::InputTag < Brut::FrontEnd::Components:
   # @param [Hash] html_attributes any additional HTML attributes to include on the `<input>` element.
   def initialize(form:, input_name:, index: nil, **html_attributes)
     input = form.input(input_name, index:)
+    if input.class.name != "Brut::FrontEnd::Forms::Input"
+      raise ArgumentError, "#{self.class} can only be used with `input` elements, not #{input.class.name} form elements"
+    end
     default_html_attributes = {}
     html_attributes = html_attributes.map { |key,value| [ key.to_sym, value ] }.to_h
 

data/lib/brut/front_end/components/inputs/select_tag_with_options.rb

@@ -1,7 +1,6 @@
 # Renders an HTML `<select>`.
 class Brut::FrontEnd::Components::Inputs::SelectTagWithOptions < Brut::FrontEnd::Components::Input
   # Creates the appropriate select input for the given {Brut::FrontEnd::Form} and input name.
-  # Generally, you want to use this method over the initializer.
   #
   # @param [Brut::FrontEnd::Form} form The form that is being rendered.
   #        This method will consult this class to understand the requirements

data/lib/brut/front_end/components/inputs/textarea_tag.rb

@@ -2,7 +2,6 @@
 class Brut::FrontEnd::Components::Inputs::TextareaTag < Brut::FrontEnd::Components::Input
 
   # Creates the appropriate textarea for the given {Brut::FrontEnd::Form} and input name.
-  # Generally, you want to use this method over the initializer.
   #
   # @param [Brut::FrontEnd::Form} form The form that is being rendered. This method will consult this class to understand the requirements on this textarea so its HTML is generated correctly.
   # @param [String] input_name the name of the input, which should be a member of `form`

data/lib/brut/front_end/form.rb

@@ -5,10 +5,12 @@ module Brut::FrontEnd::Forms
   autoload(:InputDeclarations, "brut/front_end/forms/input_declarations")
   autoload(:InputDefinition, "brut/front_end/forms/input_definition")
   autoload(:SelectInputDefinition, "brut/front_end/forms/select_input_definition")
+  autoload(:ButtonInputDefinition, "brut/front_end/forms/button_input_definition")
   autoload(:RadioButtonGroupInputDefinition, "brut/front_end/forms/radio_button_group_input_definition")
   autoload(:ConstraintViolation, "brut/front_end/forms/constraint_violation")
   autoload(:ValidityState, "brut/front_end/forms/validity_state")
   autoload(:Input, "brut/front_end/forms/input")
+  autoload(:Button, "brut/front_end/forms/button")
   autoload(:SelectInput, "brut/front_end/forms/select_input")
   autoload(:RadioButtonGroupInput, "brut/front_end/forms/radio_button_group_input")
 end
@@ -38,11 +40,11 @@ class Brut::FrontEnd::Form
       Brut.container.instrumentation.add_attributes(prefix: :brut, ignored_unknown_params: unknown_params.join(","))
     end
     @params = params.except(*unknown_params).map { |name,value|
-        input_definition = begin
-                             self.class.input_definitions[name] || self.class.input_definitions.fetch(name.to_s)
-                           rescue KeyError
-                             raise "cannot find input definition for '#{name}'. Have these: #{self.class.input_definitions.keys.inspect}"
-                           end
+      input_definition = begin
+                           self.class.input_definitions[name] || self.class.input_definitions.fetch(name.to_s)
+                         rescue KeyError
+                           raise "cannot find input definition for '#{name}'. Have these: #{self.class.input_definitions.keys.inspect}"
+                         end
       if value.kind_of?(Array)
         input_definition = begin
                              self.class.input_definitions[name] || self.class.input_definitions.fetch(name.to_s)

data/lib/brut/front_end/forms/button.rb

@@ -0,0 +1,21 @@
+# Represents the current state of a particular button that is part of a form.
+# Button's in this context don't really have state, but this allows the button to be
+# modeled like any other form element.
+class Brut::FrontEnd::Forms::Button < Brut::FrontEnd::Forms::Input
+  # Create the input with the given definition and value
+  # @param [Brut::FrontEnd::Forms::InputDefinition] input_definition
+  # @param [String] value Value of the button, which would be submitted with the form. Note
+  #                       that {Brut::FrontEnd::Forms::ButtonInputDefinition#make_input} will
+  #                       default this value to `"true"`.
+  def initialize(input_definition:, value:, index:)
+    @input_definition = input_definition
+    @validity_state = Brut::FrontEnd::Forms::ValidityState.new
+    @index = index
+    self.value=(value)
+  end
+
+  def value=(new_value)
+    @value = new_value.to_s
+    @typed_value = @value
+  end
+end

data/lib/brut/front_end/forms/button_input_definition.rb

@@ -0,0 +1,33 @@
+# Defines a button to be used to submit a form (as opposed to an `<input type="submit">`).
+# This is needed when the name/value of the button should be submitted witih the form.
+class Brut::FrontEnd::Forms::ButtonInputDefinition
+  include Brut::Framework::FussyTypeEnforcement
+
+  attr_reader :name
+
+  # Create a ButtonInputDefinition.
+  #
+  # @param [String] name Name of the button (required)
+  # @param [true|false] array If true, the form will expect multiple values for this input.  The values will be available as an array. Any values omitted by the user will be present as empty strings.
+  #
+  # @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button BUTTON Element
+  def initialize(
+    name:,
+    array: false
+  )
+    name  = name.to_s
+    @name  = type!(name,  String,        "name",  required: true)
+    @array = type!(array, [true, false], "array", required: true)
+  end
+
+  def array? = @array
+
+
+  # Create an Input based on this definition, initializing it with the given value.
+  # @param [String] value the value to give this input initially.
+  # @param [Integer] index the index of this input, if it is part of an array of
+  #                  inputs. `nil` is allowed only if the input definition is not for an array.
+  def make_input(value:, index:)
+    Brut::FrontEnd::Forms::Button.new(input_definition: self, value:, index:)
+  end
+end

data/lib/brut/front_end/forms/input_declarations.rb

@@ -11,6 +11,16 @@ module Brut::FrontEnd::Forms::InputDeclarations
     )
   end
 
+  # Declares a named button for this form, which is required in order to have this button's name and
+  # value sent to the back.  This will generate a `<button>` tag. To use `<input type="submit">`, {.input} should
+  # be used instead.
+  # @param [String] name The name of the button (used in the `name` attribute)
+  def button(name)
+    self.add_input_definition(
+      Brut::FrontEnd::Forms::ButtonInputDefinition.new(name:)
+    )
+  end
+
   # Declares a select for this form, to be modeled via an HTML `<SELECT>` tag. Note that this will not define the values that appear
   # in the select.  That is done when the select is rendered, which you might do with a
   # {Brut::FrontEnd::Components::Inputs::Select}

data/lib/brut/front_end/forms/input_definition.rb

@@ -32,6 +32,7 @@ class Brut::FrontEnd::Forms::InputDefinition
     "radio"          => String,
     "range"          => String,
     "search"         => String,
+    "submit"         => String,
     "tel"            => String,
     "text"           => String,
     "time"           => Time, # XXX
@@ -49,7 +50,7 @@ class Brut::FrontEnd::Forms::InputDefinition
   # @param [Integer] maxlength Maximum length of the value allowed.
   # @param [String] name Name of the input (required)
   # @param [Regexp] pattern that the value must match. Note that this technically must be a regular expression that works for both Ruby and JavaScript, so don't get fancy.
-  # @param [true|false] required true if this field is required, false otherwise. Default is `true` unless `type` is `"checkbox"`.
+  # @param [true|false] required true if this field is required, false otherwise. Default is `true` unless `type` is `"checkbox"` or `"submit"`.
   # @param [Integer] step Step value for ranged inputs.  A value that is not on a step is considered invalid.
   # @param [String] type the type of input to create. Should be a value from the HTML spec. Default is based on the value of `name`. If `email`, `type` is `email`. If `password` or `password_confirmation`, type is `password`. Otherwise `text`.
   # @param [true|false] array If true, the form will expect multiple values for this input.  The values will be available as an array. Any values omitted by the user will be present as empty strings.
@@ -84,7 +85,11 @@ class Brut::FrontEnd::Forms::InputDefinition
 
     type = type.to_s
     if required == :based_on_type
-      required = type != "checkbox"
+      required = case type
+                 when "checkbox" then false
+                 when "submit"   then false
+                 else true
+                 end
     end
 
     @max       = max

data/lib/brut/version.rb

@@ -1,4 +1,4 @@
 module Brut
   # @!visibility private
-  VERSION = "0.11.0"
+  VERSION = "0.12.1"
 end

data/mkbrut/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mkbrut (0.11.0)
+    mkbrut (0.12.1)
 
 GEM
   remote: https://rubygems.org/

data/mkbrut/lib/mkbrut/version.rb

@@ -1,3 +1,3 @@
 module MKBrut
-  VERSION = "0.11.0"
+  VERSION = "0.12.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brut
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.1
 platform: ruby
 authors:
 - David Bryant Copeland
@@ -809,6 +809,7 @@ files:
 - docs/api/Brut/FrontEnd/Components/I18nTranslations.html
 - docs/api/Brut/FrontEnd/Components/Input.html
 - docs/api/Brut/FrontEnd/Components/Inputs.html
+- docs/api/Brut/FrontEnd/Components/Inputs/ButtonTag.html
 - docs/api/Brut/FrontEnd/Components/Inputs/CsrfToken.html
 - docs/api/Brut/FrontEnd/Components/Inputs/InputTag.html
 - docs/api/Brut/FrontEnd/Components/Inputs/RadioButton.html
@@ -823,6 +824,8 @@ files:
 - docs/api/Brut/FrontEnd/Flash.html
 - docs/api/Brut/FrontEnd/Form.html
 - docs/api/Brut/FrontEnd/Forms.html
+- docs/api/Brut/FrontEnd/Forms/Button.html
+- docs/api/Brut/FrontEnd/Forms/ButtonInputDefinition.html
 - docs/api/Brut/FrontEnd/Forms/ConstraintViolation.html
 - docs/api/Brut/FrontEnd/Forms/Input.html
 - docs/api/Brut/FrontEnd/Forms/Input/Color.html
@@ -885,6 +888,8 @@ files:
 - docs/api/Brut/I18n/HTTPAcceptLanguage/AlwaysEnglish.html
 - docs/api/Brut/Instrumentation.html
 - docs/api/Brut/Instrumentation/LoggerSpanExporter.html
+- docs/api/Brut/Instrumentation/Methods.html
+- docs/api/Brut/Instrumentation/Methods/ClassMethods.html
 - docs/api/Brut/Instrumentation/OpenTelemetry.html
 - docs/api/Brut/Instrumentation/OpenTelemetry/NormalizedAttributes.html
 - docs/api/Brut/Instrumentation/OpenTelemetry/Span.html
@@ -959,7 +964,7 @@ files:
 - docs/assets/adrs.md.BxjHi9-8.lean.js
 - docs/assets/ai.md.Cy9GWnER.js
 - docs/assets/ai.md.Cy9GWnER.lean.js
-- docs/assets/app.0-aKXKdt.js
+- docs/assets/app.CGHFI-MA.js
 - docs/assets/assets.md.7C3HWkga.js
 - docs/assets/assets.md.7C3HWkga.lean.js
 - docs/assets/basic-form-with-violations.Cv6Y9-Q_.png
@@ -968,16 +973,16 @@ files:
 - docs/assets/brut-js.md.B4GYxQVw.lean.js
 - docs/assets/business-logic.md.BY4hGy0m.js
 - docs/assets/business-logic.md.BY4hGy0m.lean.js
-- docs/assets/chunks/@localSearchIndexroot.DPhqaz1b.js
-- docs/assets/chunks/VPLocalSearchBox.CW-UBkNA.js
+- docs/assets/chunks/@localSearchIndexroot.DcMsFVrO.js
+- docs/assets/chunks/VPLocalSearchBox.-c-Kihwo.js
 - docs/assets/chunks/framework.1L-BeKqY.js
-- docs/assets/chunks/theme.a6feKWJO.js
+- docs/assets/chunks/theme.DpqrgXG8.js
 - docs/assets/cli.md.CjsktgFz.js
 - docs/assets/cli.md.CjsktgFz.lean.js
-- docs/assets/components.md.BzVRwegp.js
-- docs/assets/components.md.BzVRwegp.lean.js
-- docs/assets/configuration.md.eM5wFVi5.js
-- docs/assets/configuration.md.eM5wFVi5.lean.js
+- docs/assets/components.md.X4h_TEG-.js
+- docs/assets/components.md.X4h_TEG-.lean.js
+- docs/assets/configuration.md.CPCyUo5A.js
+- docs/assets/configuration.md.CPCyUo5A.lean.js
 - docs/assets/css.md.CltvJqAa.js
 - docs/assets/css.md.CltvJqAa.lean.js
 - docs/assets/custom-element-tests.md.B_rbta32.js
@@ -1003,10 +1008,10 @@ files:
 - docs/assets/flash-and-session.md.nPvUpnUx.lean.js
 - docs/assets/form-constraints.md.KTv5cdR4.js
 - docs/assets/form-constraints.md.KTv5cdR4.lean.js
-- docs/assets/forms.md.B3BHvCV3.js
-- docs/assets/forms.md.B3BHvCV3.lean.js
-- docs/assets/getting-started.md.BgR0ZHsl.js
-- docs/assets/getting-started.md.BgR0ZHsl.lean.js
+- docs/assets/forms.md.BwmfAZ6Z.js
+- docs/assets/forms.md.BwmfAZ6Z.lean.js
+- docs/assets/getting-started.md.mPgbkbBv.js
+- docs/assets/getting-started.md.mPgbkbBv.lean.js
 - docs/assets/handlers.md.h84MMB1R.js
 - docs/assets/handlers.md.h84MMB1R.lean.js
 - docs/assets/hooks.md.Jmb5VOLA.js
@@ -1016,8 +1021,8 @@ files:
 - docs/assets/index.md.Bn9e0sRJ.js
 - docs/assets/index.md.Bn9e0sRJ.lean.js
 - docs/assets/initial-home-page.DNIaYmgP.png
-- docs/assets/instrumentation.md.BgcaGVYH.js
-- docs/assets/instrumentation.md.BgcaGVYH.lean.js
+- docs/assets/instrumentation.md._lNSriEZ.js
+- docs/assets/instrumentation.md._lNSriEZ.lean.js
 - docs/assets/javascript.md.DzrMxUmI.js
 - docs/assets/javascript.md.DzrMxUmI.lean.js
 - docs/assets/jobs.md.S-2amAYp.js
@@ -1040,8 +1045,8 @@ files:
 - docs/assets/pages.md.B7Hc-i6H.lean.js
 - docs/assets/recipes_alternate-layouts.md.BwEytl59.js
 - docs/assets/recipes_alternate-layouts.md.BwEytl59.lean.js
-- docs/assets/recipes_authentication.md.Dzvi_g69.js
-- docs/assets/recipes_authentication.md.Dzvi_g69.lean.js
+- docs/assets/recipes_authentication.md.BAISoxmN.js
+- docs/assets/recipes_authentication.md.BAISoxmN.lean.js
 - docs/assets/recipes_blank-layouts.md.fyAUJyJR.js
 - docs/assets/recipes_blank-layouts.md.fyAUJyJR.lean.js
 - docs/assets/recipes_custom-flash.md.CrQbI5eH.js
@@ -1072,10 +1077,10 @@ files:
 - docs/assets/styled-home-page.BzdI7dWz.png
 - docs/assets/tutorial.md.BM40jnoq.js
 - docs/assets/tutorial.md.BM40jnoq.lean.js
-- docs/assets/tutorials_01-intro.md.BXvYWcO9.js
-- docs/assets/tutorials_01-intro.md.BXvYWcO9.lean.js
-- docs/assets/tutorials_02-dialog.md.CIeg8R--.js
-- docs/assets/tutorials_02-dialog.md.CIeg8R--.lean.js
+- docs/assets/tutorials_01-intro.md.B4sUBY3X.js
+- docs/assets/tutorials_01-intro.md.B4sUBY3X.lean.js
+- docs/assets/tutorials_02-dialog.md.DOonTBrE.js
+- docs/assets/tutorials_02-dialog.md.DOonTBrE.lean.js
 - docs/assets/unit-tests.md.DUGrnLj5.js
 - docs/assets/unit-tests.md.DUGrnLj5.lean.js
 - docs/assets/welcome-to-brut.VSWzl17-.png
@@ -1285,6 +1290,7 @@ files:
 - lib/brut/front_end/components/form_tag.rb
 - lib/brut/front_end/components/i18n_translations.rb
 - lib/brut/front_end/components/input.rb
+- lib/brut/front_end/components/inputs/button_tag.rb
 - lib/brut/front_end/components/inputs/csrf_token.rb
 - lib/brut/front_end/components/inputs/input_tag.rb
 - lib/brut/front_end/components/inputs/radio_button.rb
@@ -1298,6 +1304,8 @@ files:
 - lib/brut/front_end/download.rb
 - lib/brut/front_end/flash.rb
 - lib/brut/front_end/form.rb
+- lib/brut/front_end/forms/button.rb
+- lib/brut/front_end/forms/button_input_definition.rb
 - lib/brut/front_end/forms/constraint_violation.rb
 - lib/brut/front_end/forms/input.rb
 - lib/brut/front_end/forms/input_declarations.rb