keystone_ui 0.14.0 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19985a6e534c22e09228551a7b42fdce26c07108512510302e0943d78bbbd220
-  data.tar.gz: 2ab28d0ba73793eada71a4164a876c491c11c48fe34e1e779cd4e47b4e0c5874
+  metadata.gz: cdb61774853355f3b66ae9c1a7d6f4930005216827486777c19b582b3ac775f2
+  data.tar.gz: a815979ea629c273e43b8b7d39a20a1310908dedee967aec21b326e027784333
 SHA512:
-  metadata.gz: 3977daa450ed35f50d903ed792260ba8559b52826aca4882941f1c73185dd6b5b99f3fbb007ae7d7b0fc37d866bd0201f162ad979dd4cf409c1f944a34165d4c
-  data.tar.gz: 4598172f5ab465a6c4e81a6b16f1e55206b93a2865598dbbc9d27f49b1bcd7ff029aff2ac104cc9f532bb3774a971324066b83052f244bc1a40848df552ea781
+  metadata.gz: '0975326ab4b00a0f6ce7f28ae8642e2bee4704e13509046a1c2ad820e50880ace96f0b0d0e66dfd95e29b3d7d56cff68f7e4aef1264c507b2480eb72d3b14c5d'
+  data.tar.gz: e06fedfeebf535bf2c17ae2dc30938878a05f3cfb918f29df694886538f2c88f97d83d5eb51e9210e4dcdc8bfdbf3b16c8daef006d0bc51f6f93815752c4268c

data/app/components/keystone/ui/form_field_component.html.erb

@@ -15,7 +15,7 @@
     <textarea name="<%= @attribute %>" rows="3" class="<%= Keystone::Ui::TextareaComponent::BASE_CLASSES %>"<% if @placeholder %> placeholder="<%= @placeholder %>"<% end %>><%= @value %></textarea>
   <% elsif select? %>
     <select name="<%= @attribute %>" class="<%= Keystone::Ui::SelectComponent::BASE_CLASSES %>">
-      <% unless required? %><option value=""></option><% end %>
+      <% unless required? %><option value=""><%= blank_option_text %></option><% end %>
       <% select_options.each do |label, value| %>
         <option value="<%= value %>" <%= "selected" if @value.to_s == value.to_s %>><%= label %></option>
       <% end %>

data/app/components/keystone/ui/form_field_component.rb

@@ -11,7 +11,7 @@ module Keystone
       CHECKBOX_CLASSES = "ks-checkbox"
       CHECKBOX_WRAPPER_CLASSES = "flex items-center gap-2"
 
-      def initialize(attribute:, label: nil, type: :text, required: false, hint: nil, placeholder: nil, min: nil, max: nil, step: nil, value: nil, options: [], errors: [])
+      def initialize(attribute:, label: nil, type: :text, required: false, hint: nil, placeholder: nil, min: nil, max: nil, step: nil, value: nil, options: [], errors: [], include_blank: nil)
         @attribute = attribute
         @label = label
         @type = type
@@ -24,6 +24,7 @@ module Keystone
         @value = value
         @options = options
         @errors = Array(errors)
+        @include_blank = include_blank.to_s
       end
 
       def label_text
@@ -66,6 +67,10 @@ module Keystone
         @options
       end
 
+      def blank_option_text
+        @include_blank
+      end
+
       def input_options
         options = { name: @attribute.to_s, class: Keystone::Ui::InputComponent::BASE_CLASSES }
         unless textarea?

data/lib/keystone_ui/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module KeystoneUi
-  VERSION = "0.14.0"
+  VERSION = "0.15.0"
 end

data/the_local/agents/keystone_ui-develop.md

@@ -96,7 +96,7 @@ outer element. See Conventions before using it.
   The `<form>` wrapper. `method:` may be `:patch`/`:put`/`:delete` and is
   translated for Rails. Set `multipart: true` when the form contains a file
   upload.
-- `ui_form_field(attribute:, label: nil, type: :text, required: false, hint: nil, placeholder: nil, min: nil, max: nil, step: nil, value: nil, options: [], errors: [])`
+- `ui_form_field(attribute:, label: nil, type: :text, required: false, hint: nil, placeholder: nil, min: nil, max: nil, step: nil, value: nil, options: [], errors: [], include_blank: nil)`
   — a labeled field with hint and error text. This is the default way to render
   an input. `type:` `:text` `:number` `:email` `:password` `:date` `:textarea`
   `:checkbox` `:select`. `attribute:` is used verbatim as the input's `name`, so
@@ -104,7 +104,9 @@ outer element. See Conventions before using it.
   pass `label:` whenever the attribute is a nested name. `label:` defaults to the
   attribute with underscores turned to spaces and the first letter capitalized.
   `options:` is for `:select` and takes `[[label, value], ...]`; `value:` picks
-  the selected option, and a non-required select gets a leading blank option. A
+  the selected option, and a non-required select gets a leading empty option,
+  worded by `include_blank:` (for example `"Not set yet"`) or left blank without
+  it. Never add your own empty choice to `options:` as well. A
   `:checkbox` renders its label beside the box, submits `"0"` when unchecked and
   `"1"` when checked, and pre-checks when `value:` is `"1"`. `errors:` is an
   array of message strings.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: keystone_ui
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.15.0
 platform: ruby
 authors:
 - Tyler Schneider