brut 0.0.28 → 0.1.0

data/docs/api/Brut/FrontEnd/Forms/InputDeclarations.html

@@ -537,7 +537,7 @@ Components::Inputs::Select</p>
 </div>
 
       <div id="footer">
-  Generated on Wed Jul  2 21:45:27 2025 by
+  Generated on Tue Jul  8 01:36:09 2025 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.37 (ruby-3.4.4).
 </div>

data/docs/api/Brut/FrontEnd/Forms/InputDefinition.html

@@ -418,7 +418,7 @@ such as implementing a <span class='object_link'><a href="../../BackEnd/Validato
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#initialize-instance_method" title="#initialize (instance method)">#<strong>initialize</strong>(max: nil, maxlength: nil, min: nil, minlength: nil, name: nil, pattern: nil, required: :based_on_type, step: nil, type: nil, array: false)  &#x21d2; InputDefinition </a>
+      <a href="#initialize-instance_method" title="#initialize (instance method)">#<strong>initialize</strong>(max: nil, maxlength: nil, min: nil, minlength: nil, name: nil, pattern: :based_on_type, required: :based_on_type, step: nil, type: nil, array: false)  &#x21d2; InputDefinition </a>
     
 
     
@@ -483,7 +483,7 @@ such as implementing a <span class='object_link'><a href="../../BackEnd/Validato
     <div class="method_details first">
   <h3 class="signature first" id="initialize-instance_method">
   
-    #<strong>initialize</strong>(max: nil, maxlength: nil, min: nil, minlength: nil, name: nil, pattern: nil, required: :based_on_type, step: nil, type: nil, array: false)  &#x21d2; <tt><span class='object_link'><a href="" title="Brut::FrontEnd::Forms::InputDefinition (class)">InputDefinition</a></span></tt> 
+    #<strong>initialize</strong>(max: nil, maxlength: nil, min: nil, minlength: nil, name: nil, pattern: :based_on_type, required: :based_on_type, step: nil, type: nil, array: false)  &#x21d2; <tt><span class='object_link'><a href="" title="Brut::FrontEnd::Forms::InputDefinition (class)">InputDefinition</a></span></tt> 
   
 
   
@@ -595,7 +595,7 @@ we can in Ruby so that client side validations can be safely used for user exper
         <span class='type'>(<tt>Regexp</tt>)</span>
       
       
-        <em class="default">(defaults to: <tt>nil</tt>)</em>
+        <em class="default">(defaults to: <tt>:based_on_type</tt>)</em>
       
       
         &mdash;
@@ -690,6 +690,8 @@ we can in Ruby so that client side validations can be safely used for user exper
       <pre class="lines">
 
 
+60
+61
 62
 63
 64
@@ -734,10 +736,13 @@ we can in Ruby so that client side validations can be safely used for user exper
 103
 104
 105
-106</pre>
+106
+107
+108
+109</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/input_definition.rb', line 62</span>
+      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/input_definition.rb', line 60</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span>
   <span class='label'>max:</span> <span class='kw'>nil</span><span class='comma'>,</span>
@@ -745,7 +750,7 @@ we can in Ruby so that client side validations can be safely used for user exper
   <span class='label'>min:</span> <span class='kw'>nil</span><span class='comma'>,</span>
   <span class='label'>minlength:</span> <span class='kw'>nil</span><span class='comma'>,</span>
   <span class='label'>name:</span> <span class='kw'>nil</span><span class='comma'>,</span>
-  <span class='label'>pattern:</span> <span class='kw'>nil</span><span class='comma'>,</span>
+  <span class='label'>pattern:</span> <span class='symbol'>:based_on_type</span><span class='comma'>,</span>
   <span class='label'>required:</span> <span class='symbol'>:based_on_type</span><span class='comma'>,</span>
   <span class='label'>step:</span> <span class='kw'>nil</span><span class='comma'>,</span>
   <span class='label'>type:</span> <span class='kw'>nil</span><span class='comma'>,</span>
@@ -769,20 +774,25 @@ we can in Ruby so that client side validations can be safely used for user exper
     <span class='id identifier rubyid_required'>required</span> <span class='op'>=</span> <span class='id identifier rubyid_type'>type</span> <span class='op'>!=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>checkbox</span><span class='tstring_end'>&quot;</span></span>
   <span class='kw'>end</span>
 
-  <span class='ivar'>@max</span>       <span class='op'>=</span> <span class='id identifier rubyid_type!'>type!</span><span class='lparen'>(</span> <span class='id identifier rubyid_max'>max</span>       <span class='comma'>,</span> <span class='const'>Numeric</span>                   <span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>max</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
+  <span class='ivar'>@max</span>       <span class='op'>=</span> <span class='id identifier rubyid_max'>max</span>
   <span class='ivar'>@maxlength</span> <span class='op'>=</span> <span class='id identifier rubyid_type!'>type!</span><span class='lparen'>(</span> <span class='id identifier rubyid_maxlength'>maxlength</span> <span class='comma'>,</span> <span class='const'>Numeric</span>                   <span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>maxlength</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
-  <span class='ivar'>@min</span>       <span class='op'>=</span> <span class='id identifier rubyid_type!'>type!</span><span class='lparen'>(</span> <span class='id identifier rubyid_min'>min</span>       <span class='comma'>,</span> <span class='const'>Numeric</span>                   <span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>min</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
+  <span class='ivar'>@min</span>       <span class='op'>=</span> <span class='id identifier rubyid_min'>min</span>
   <span class='ivar'>@minlength</span> <span class='op'>=</span> <span class='id identifier rubyid_type!'>type!</span><span class='lparen'>(</span> <span class='id identifier rubyid_minlength'>minlength</span> <span class='comma'>,</span> <span class='const'>Numeric</span>                   <span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>minlength</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
   <span class='ivar'>@name</span>      <span class='op'>=</span> <span class='id identifier rubyid_type!'>type!</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span>      <span class='comma'>,</span> <span class='const'>String</span>                    <span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>name</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>true</span><span class='rparen'>)</span>
-  <span class='ivar'>@pattern</span>   <span class='op'>=</span> <span class='id identifier rubyid_type!'>type!</span><span class='lparen'>(</span> <span class='id identifier rubyid_pattern'>pattern</span>   <span class='comma'>,</span> <span class='const'>String</span>                    <span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>pattern</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
   <span class='ivar'>@required</span>  <span class='op'>=</span> <span class='id identifier rubyid_type!'>type!</span><span class='lparen'>(</span> <span class='id identifier rubyid_required'>required</span>  <span class='comma'>,</span> <span class='lbracket'>[</span><span class='kw'>true</span><span class='comma'>,</span> <span class='kw'>false</span><span class='rbracket'>]</span>             <span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>required</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>true</span><span class='rparen'>)</span>
   <span class='ivar'>@step</span>      <span class='op'>=</span> <span class='id identifier rubyid_type!'>type!</span><span class='lparen'>(</span> <span class='id identifier rubyid_step'>step</span>      <span class='comma'>,</span> <span class='const'>Numeric</span>                   <span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>step</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
   <span class='ivar'>@type</span>      <span class='op'>=</span> <span class='id identifier rubyid_type!'>type!</span><span class='lparen'>(</span> <span class='id identifier rubyid_type'>type</span>      <span class='comma'>,</span> <span class='const'>INPUT_TYPES_TO_CLASS</span><span class='period'>.</span><span class='id identifier rubyid_keys'>keys</span> <span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>type</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>true</span><span class='rparen'>)</span>
   <span class='ivar'>@array</span>     <span class='op'>=</span> <span class='id identifier rubyid_type!'>type!</span><span class='lparen'>(</span> <span class='id identifier rubyid_array'>array</span>     <span class='comma'>,</span> <span class='lbracket'>[</span><span class='kw'>true</span><span class='comma'>,</span> <span class='kw'>false</span><span class='rbracket'>]</span>             <span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>array</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>required:</span> <span class='kw'>true</span><span class='rparen'>)</span>
 
-  <span class='kw'>if</span> <span class='ivar'>@pattern</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_type'>type</span> <span class='op'>==</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>email</span><span class='tstring_end'>&quot;</span></span>
-    <span class='ivar'>@pattern</span> <span class='op'>=</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>^[^@]+@[^@]+\.[^@]+$</span><span class='regexp_end'>/</span></span><span class='period'>.</span><span class='id identifier rubyid_source'>source</span>
-  <span class='kw'>end</span>
+  <span class='ivar'>@pattern</span> <span class='op'>=</span> <span class='kw'>if</span> <span class='id identifier rubyid_pattern'>pattern</span> <span class='op'>==</span> <span class='symbol'>:based_on_type</span> 
+               <span class='kw'>if</span> <span class='id identifier rubyid_type'>type</span> <span class='op'>==</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>email</span><span class='tstring_end'>&quot;</span></span>
+                 <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>^[^@]+@[^@]+\.[^@]+$</span><span class='regexp_end'>/</span></span><span class='period'>.</span><span class='id identifier rubyid_source'>source</span>
+               <span class='kw'>else</span>
+                 <span class='kw'>nil</span>
+               <span class='kw'>end</span>
+             <span class='kw'>else</span>
+               <span class='id identifier rubyid_type!'>type!</span><span class='lparen'>(</span> <span class='id identifier rubyid_pattern'>pattern</span><span class='comma'>,</span> <span class='const'>String</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>pattern</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
+             <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -1217,10 +1227,10 @@ we can in Ruby so that client side validations can be safely used for user exper
       <pre class="lines">
 
 
-108</pre>
+111</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/input_definition.rb', line 108</span>
+      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/input_definition.rb', line 111</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_array?'>array?</span> <span class='op'>=</span> <span class='ivar'>@array</span></pre>
     </td>
@@ -1288,12 +1298,12 @@ inputs. <code>nil</code> is allowed only if the input definition is not for an a
       <pre class="lines">
 
 
-115
-116
-117</pre>
+118
+119
+120</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/input_definition.rb', line 115</span>
+      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/input_definition.rb', line 118</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_make_input'>make_input</span><span class='lparen'>(</span><span class='label'>value:</span><span class='comma'>,</span> <span class='label'>index:</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="../../../Brut.html" title="Brut (module)">Brut</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="../../FrontEnd.html" title="Brut::FrontEnd (module)">FrontEnd</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="../Forms.html" title="Brut::FrontEnd::Forms (module)">Forms</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Input.html" title="Brut::FrontEnd::Forms::Input (class)">Input</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="Input.html#initialize-instance_method" title="Brut::FrontEnd::Forms::Input#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='label'>input_definition:</span> <span class='kw'>self</span><span class='comma'>,</span> <span class='label'>value:</span><span class='comma'>,</span> <span class='label'>index:</span><span class='rparen'>)</span>
@@ -1308,7 +1318,7 @@ inputs. <code>nil</code> is allowed only if the input definition is not for an a
 </div>
 
       <div id="footer">
-  Generated on Wed Jul  2 21:45:28 2025 by
+  Generated on Tue Jul  8 01:36:10 2025 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.37 (ruby-3.4.4).
 </div>

data/docs/api/Brut/FrontEnd/Forms/RadioButtonGroupInput.html

@@ -111,6 +111,34 @@
   <h2>Instance Attribute Summary <small><a href="#" class="summary_toggle">collapse</a></small></h2>
   <ul class="summary">
     
+      <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#typed_value-instance_method" title="#typed_value (instance method)">#<strong>typed_value</strong>  &#x21d2; Date|Time|BigDecimal|String|true|false|nil </a>
+    
+
+    
+  </span>
+  
+  
+  
+    
+      <span class="note title readonly">readonly</span>
+    
+    
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>The value of the input, as coerced to the type used to evaluate constraints.</p>
+</div></span>
+  
+</li>
+
+    
       <li class="public ">
   <span class="summary_signature">
     
@@ -307,18 +335,18 @@
       <pre class="lines">
 
 
-11
-12
-13
-14
 15
 16
 17
 18
-19</pre>
+19
+20
+21
+22
+23</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 11</span>
+      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 15</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='label'>input_definition:</span><span class='comma'>,</span> <span class='label'>value:</span><span class='comma'>,</span> <span class='label'>index:</span><span class='rparen'>)</span>
   <span class='ivar'>@input_definition</span> <span class='op'>=</span> <span class='id identifier rubyid_input_definition'>input_definition</span>
@@ -342,7 +370,94 @@
       
       <span id=""></span>
       <div class="method_details first">
-  <h3 class="signature first" id="validity_state-instance_method">
+  <h3 class="signature first" id="typed_value-instance_method">
+  
+    #<strong>typed_value</strong>  &#x21d2; <tt>Date|Time|BigDecimal|String|true|false|nil</tt>  <span class="extras">(readonly)</span>
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>The value of the input,
+as coerced to the type used to evaluate constraints.
+Returns <code>nil</code> if the value could not be coerced (which likely means
+there is or will be a constraint violation), <strong>or</strong>
+if it is a blank String.</p>
+
+<p>Of note, <code>type=color</code> will return a String here, but that String
+should be parseable into a hex code, i.e. #XXXXXX, where each "X"
+is 0-9 or a-f.  Further, <code>type=time</code> will also return a string
+in the format HH:MM or HH:MM:SS, where the time is in 24 hour
+time.  Lastly, <code>type=datetime-local</code> will return a <code>Time</code>, even
+though the control allows the visitor to choose an invalid time.
+If there is no <code>valueMissing</code> constraint violation, but this
+attribute returns <code>nil</code>, <span class='object_link'><a href="#value-instance_method" title="Brut::FrontEnd::Forms::RadioButtonGroupInput#value (method)">#value</a></span> <em>will</em> return the string sent by
+the browser, even if it's not a real timestamp.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Date|Time|BigDecimal|String|true|false|nil</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>the value of the input,
+as coerced to the type used to evaluate constraints.
+Returns <code>nil</code> if the value could not be coerced (which likely means
+there is or will be a constraint violation), <strong>or</strong>
+if it is a blank String.</p>
+
+<p>Of note, <code>type=color</code> will return a String here, but that String
+should be parseable into a hex code, i.e. #XXXXXX, where each "X"
+is 0-9 or a-f.  Further, <code>type=time</code> will also return a string
+in the format HH:MM or HH:MM:SS, where the time is in 24 hour
+time.  Lastly, <code>type=datetime-local</code> will return a <code>Time</code>, even
+though the control allows the visitor to choose an invalid time.
+If there is no <code>valueMissing</code> constraint violation, but this
+attribute returns <code>nil</code>, <span class='object_link'><a href="#value-instance_method" title="Brut::FrontEnd::Forms::RadioButtonGroupInput#value (method)">#value</a></span> <em>will</em> return the string sent by
+the browser, even if it's not a real timestamp.</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+9
+10
+11</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 9</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_typed_value'>typed_value</span>
+  <span class='ivar'>@typed_value</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      
+      <span id=""></span>
+      <div class="method_details ">
+  <h3 class="signature " id="validity_state-instance_method">
   
     #<strong>validity_state</strong>  &#x21d2; <tt><span class='object_link'><a href="ValidityState.html" title="Brut::FrontEnd::Forms::ValidityState (class)">Brut::FrontEnd::Forms::ValidityState</a></span></tt>  <span class="extras">(readonly)</span>
   
@@ -383,12 +498,12 @@
       <pre class="lines">
 
 
-8
-9
-10</pre>
+12
+13
+14</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 8</span>
+      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 12</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_validity_state'>validity_state</span>
   <span class='ivar'>@validity_state</span>
@@ -411,7 +526,10 @@
   
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Returns the input's value.</p>
+    <p>Returns the input's value. <strong>DO NOTE</strong> this returns a string.  This is
+because HTML stores these values as Strings.  When using a checkbox, in
+particular, the value will <em>not</em> be a boolean. You cannot do <code>if
+input.value</code> and expect that work. See <span class='object_link'><a href="#typed_value-instance_method" title="Brut::FrontEnd::Forms::RadioButtonGroupInput#typed_value (method)">#typed_value</a></span> instead.</p>
 
 
   </div>
@@ -429,7 +547,10 @@
       
       
         &mdash;
-        <div class='inline'><p>the input's value</p>
+        <div class='inline'><p>the input's value. <strong>DO NOTE</strong> this returns a string.  This is
+because HTML stores these values as Strings.  When using a checkbox, in
+particular, the value will <em>not</em> be a boolean. You cannot do <code>if
+input.value</code> and expect that work. See <span class='object_link'><a href="#typed_value-instance_method" title="Brut::FrontEnd::Forms::RadioButtonGroupInput#typed_value (method)">#typed_value</a></span> instead.</p>
 </div>
       
     </li>
@@ -526,12 +647,12 @@ that <code>key</code> should not be a key used for client-side validations.</p>
       <pre class="lines">
 
 
-41
-42
-43</pre>
+48
+49
+50</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 41</span>
+      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 48</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_server_side_constraint_violation'>server_side_constraint_violation</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span><span class='id identifier rubyid_context'>context</span><span class='op'>=</span><span class='kw'>true</span><span class='rparen'>)</span>
   <span class='ivar'>@validity_state</span><span class='period'>.</span><span class='id identifier rubyid_server_side_constraint_violation'>server_side_constraint_violation</span><span class='lparen'>(</span><span class='label'>key:</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='label'>context:</span> <span class='id identifier rubyid_context'>context</span><span class='rparen'>)</span>
@@ -583,10 +704,10 @@ that <code>key</code> should not be a key used for client-side validations.</p>
       <pre class="lines">
 
 
-46</pre>
+53</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 46</span>
+      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/radio_button_group_input.rb', line 53</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_valid?'>valid?</span> <span class='op'>=</span> <span class='ivar'>@validity_state</span><span class='period'>.</span><span class='id identifier rubyid_valid?'>valid?</span></pre>
     </td>
@@ -599,7 +720,7 @@ that <code>key</code> should not be a key used for client-side validations.</p>
 </div>
 
       <div id="footer">
-  Generated on Wed Jul  2 21:45:28 2025 by
+  Generated on Tue Jul  8 01:36:10 2025 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.37 (ruby-3.4.4).
 </div>

data/docs/api/Brut/FrontEnd/Forms/RadioButtonGroupInputDefinition.html

@@ -577,7 +577,7 @@ supported by the browser.  Also note that arrays of radio button groups are not
 </div>
 
       <div id="footer">
-  Generated on Wed Jul  2 21:45:28 2025 by
+  Generated on Tue Jul  8 01:36:11 2025 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.37 (ruby-3.4.4).
 </div>

data/docs/api/Brut/FrontEnd/Forms/SelectInput.html

@@ -121,6 +121,34 @@
   <h2>Instance Attribute Summary <small><a href="#" class="summary_toggle">collapse</a></small></h2>
   <ul class="summary">
     
+      <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#typed_value-instance_method" title="#typed_value (instance method)">#<strong>typed_value</strong>  &#x21d2; Date|Time|BigDecimal|String|true|false|nil </a>
+    
+
+    
+  </span>
+  
+  
+  
+    
+      <span class="note title readonly">readonly</span>
+    
+    
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>The value of the input, as coerced to the type used to evaluate constraints.</p>
+</div></span>
+  
+</li>
+
+    
       <li class="public ">
   <span class="summary_signature">
     
@@ -317,15 +345,15 @@
       <pre class="lines">
 
 
-12
-13
-14
-15
 16
-17</pre>
+17
+18
+19
+20
+21</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/select_input.rb', line 12</span>
+      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/select_input.rb', line 16</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='label'>input_definition:</span><span class='comma'>,</span> <span class='label'>value:</span><span class='comma'>,</span> <span class='label'>index:</span><span class='rparen'>)</span>
   <span class='ivar'>@input_definition</span> <span class='op'>=</span> <span class='id identifier rubyid_input_definition'>input_definition</span>
@@ -346,7 +374,94 @@
       
       <span id=""></span>
       <div class="method_details first">
-  <h3 class="signature first" id="validity_state-instance_method">
+  <h3 class="signature first" id="typed_value-instance_method">
+  
+    #<strong>typed_value</strong>  &#x21d2; <tt>Date|Time|BigDecimal|String|true|false|nil</tt>  <span class="extras">(readonly)</span>
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>The value of the input,
+as coerced to the type used to evaluate constraints.
+Returns <code>nil</code> if the value could not be coerced (which likely means
+there is or will be a constraint violation), <strong>or</strong>
+if it is a blank String.</p>
+
+<p>Of note, <code>type=color</code> will return a String here, but that String
+should be parseable into a hex code, i.e. #XXXXXX, where each "X"
+is 0-9 or a-f.  Further, <code>type=time</code> will also return a string
+in the format HH:MM or HH:MM:SS, where the time is in 24 hour
+time.  Lastly, <code>type=datetime-local</code> will return a <code>Time</code>, even
+though the control allows the visitor to choose an invalid time.
+If there is no <code>valueMissing</code> constraint violation, but this
+attribute returns <code>nil</code>, <span class='object_link'><a href="#value-instance_method" title="Brut::FrontEnd::Forms::SelectInput#value (method)">#value</a></span> <em>will</em> return the string sent by
+the browser, even if it's not a real timestamp.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Date|Time|BigDecimal|String|true|false|nil</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>the value of the input,
+as coerced to the type used to evaluate constraints.
+Returns <code>nil</code> if the value could not be coerced (which likely means
+there is or will be a constraint violation), <strong>or</strong>
+if it is a blank String.</p>
+
+<p>Of note, <code>type=color</code> will return a String here, but that String
+should be parseable into a hex code, i.e. #XXXXXX, where each "X"
+is 0-9 or a-f.  Further, <code>type=time</code> will also return a string
+in the format HH:MM or HH:MM:SS, where the time is in 24 hour
+time.  Lastly, <code>type=datetime-local</code> will return a <code>Time</code>, even
+though the control allows the visitor to choose an invalid time.
+If there is no <code>valueMissing</code> constraint violation, but this
+attribute returns <code>nil</code>, <span class='object_link'><a href="#value-instance_method" title="Brut::FrontEnd::Forms::SelectInput#value (method)">#value</a></span> <em>will</em> return the string sent by
+the browser, even if it's not a real timestamp.</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+10
+11
+12</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/select_input.rb', line 10</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_typed_value'>typed_value</span>
+  <span class='ivar'>@typed_value</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      
+      <span id=""></span>
+      <div class="method_details ">
+  <h3 class="signature " id="validity_state-instance_method">
   
     #<strong>validity_state</strong>  &#x21d2; <tt><span class='object_link'><a href="ValidityState.html" title="Brut::FrontEnd::Forms::ValidityState (class)">Brut::FrontEnd::Forms::ValidityState</a></span></tt>  <span class="extras">(readonly)</span>
   
@@ -387,12 +502,12 @@
       <pre class="lines">
 
 
-9
-10
-11</pre>
+13
+14
+15</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/select_input.rb', line 9</span>
+      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/select_input.rb', line 13</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_validity_state'>validity_state</span>
   <span class='ivar'>@validity_state</span>
@@ -415,7 +530,10 @@
   
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Returns the input's value.</p>
+    <p>Returns the input's value. <strong>DO NOTE</strong> this returns a string.  This is
+because HTML stores these values as Strings.  When using a checkbox, in
+particular, the value will <em>not</em> be a boolean. You cannot do <code>if
+input.value</code> and expect that work. See <span class='object_link'><a href="#typed_value-instance_method" title="Brut::FrontEnd::Forms::SelectInput#typed_value (method)">#typed_value</a></span> instead.</p>
 
 
   </div>
@@ -433,7 +551,10 @@
       
       
         &mdash;
-        <div class='inline'><p>the input's value</p>
+        <div class='inline'><p>the input's value. <strong>DO NOTE</strong> this returns a string.  This is
+because HTML stores these values as Strings.  When using a checkbox, in
+particular, the value will <em>not</em> be a boolean. You cannot do <code>if
+input.value</code> and expect that work. See <span class='object_link'><a href="#typed_value-instance_method" title="Brut::FrontEnd::Forms::SelectInput#typed_value (method)">#typed_value</a></span> instead.</p>
 </div>
       
     </li>
@@ -530,12 +651,12 @@ that <code>key</code> should not be a key used for client-side validations.</p>
       <pre class="lines">
 
 
-39
-40
-41</pre>
+46
+47
+48</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/select_input.rb', line 39</span>
+      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/select_input.rb', line 46</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_server_side_constraint_violation'>server_side_constraint_violation</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span><span class='id identifier rubyid_context'>context</span><span class='op'>=</span><span class='kw'>true</span><span class='rparen'>)</span>
   <span class='ivar'>@validity_state</span><span class='period'>.</span><span class='id identifier rubyid_server_side_constraint_violation'>server_side_constraint_violation</span><span class='lparen'>(</span><span class='label'>key:</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='label'>context:</span> <span class='id identifier rubyid_context'>context</span><span class='rparen'>)</span>
@@ -587,10 +708,10 @@ that <code>key</code> should not be a key used for client-side validations.</p>
       <pre class="lines">
 
 
-44</pre>
+51</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/select_input.rb', line 44</span>
+      <pre class="code"><span class="info file"># File 'lib/brut/front_end/forms/select_input.rb', line 51</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_valid?'>valid?</span> <span class='op'>=</span> <span class='ivar'>@validity_state</span><span class='period'>.</span><span class='id identifier rubyid_valid?'>valid?</span></pre>
     </td>
@@ -603,7 +724,7 @@ that <code>key</code> should not be a key used for client-side validations.</p>
 </div>
 
       <div id="footer">
-  Generated on Wed Jul  2 21:45:27 2025 by
+  Generated on Tue Jul  8 01:36:10 2025 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.37 (ruby-3.4.4).
 </div>