keystone_ui 0.48.0 → 0.49.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92d45d0ca72ce5a2128a391d80bd404bcfae53fc8cbef3a2a79ffaad716bcf1e
-  data.tar.gz: 48fc5e92e536ddd94a2ee7b60793f29a72969f3a9329ab86e8f6d66222c6dc2a
+  metadata.gz: c5188a7128c83107e3bb691fbbeb68733c14ff424e97bbbceea5cb4f901409a9
+  data.tar.gz: 897711fad313df1fad9c2d2f2d29fc881c7b26a66c59028842c18816b9fdd364
 SHA512:
-  metadata.gz: dff8292ec2415468e2c63f54a12b12bd5a8dcca50313794b3ab5a78720cc1cec36e344044fa00cf3689932a86bc256c7edd94c5af6f01002d54f6d9b491efc0b
-  data.tar.gz: e226f99862c150bb1f8d2e81c03c66fb63ffb5a70e5e53759532eedde96767367a4f12873e46f34eccddf9603e8ecce3ccf52510d1aa59791bf7823342cc2d33
+  metadata.gz: 0ddc36bc018b6ebbd5be50aa7413eaddbc5380598ed7e0af989f3d241bf3522785c8def0d00aaf75b4dc733b45fbe37f18a13860570fcff137604d7f60b521cd
+  data.tar.gz: f95983f302a7fc742e5962b4477b3c21429b93cd9a1a2561390fdc33482483a6f1f68eb661770f9a9cd0cb63b592febd444f18bbce19eb886c4a526a5b9297a9

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

@@ -12,7 +12,8 @@
     <% end %>
   </div>
   <p class="<%= value_classes %>">
-    <% if link? %><a href="<%= href %>" class="<%= value_link_classes %>"><%= value %></a><% else %><%= value %><% end %><% if suffix? %><span class="<%= suffix_classes %>"> <%= suffix %></span><% end %>
+    <% if missing? %><span class="<%= Keystone::Ui::StatCardComponent::FALLBACK_CLASSES %>"><%= fallback %></span><% elsif link? %><a href="<%= href %>" class="<%= value_link_classes %>"><%= value %></a><% else %><%= value %><% end %><% if suffix? %><span class="<%= suffix_classes %>"> <%= suffix %></span><% end %>
   </p>
+  <% if note %><p class="<%= Keystone::Ui::StatCardComponent::NOTE_CLASSES %>"><%= note %></p><% end %>
   <p class="<%= change_row_classes %>"><%= change_label %></p>
 </div>

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

@@ -6,6 +6,7 @@ module Keystone
       EMPHASIS_CLASSES = "ks-stat-card-emphasis"
       HEADER_CLASSES = "ks-stat-card-header flex items-start justify-between"
       CARD_CLASSES = "ks-metric-card relative"
+      PLAIN_CLASSES = "ks-metric-plain relative"
       LABEL_CLASSES = "ks-stat-card-label text-sm"
       VALUE_BASE_CLASSES = "ks-stat-card-value text-3xl"
       SUFFIX_CLASSES = "ks-stat-card-suffix text-lg"
@@ -13,6 +14,8 @@ module Keystone
       CHANGE_ROW_CLASSES = "ks-stat-card-change h-5 text-sm"
       VALUE_LINK_CLASSES = "hover:underline focus:outline-none focus-visible:underline"
       INFO_BUTTON_CLASSES = "ks-stat-card-info peer shrink-0 transition"
+      NOTE_CLASSES = "ks-stat-card-note text-sm"
+      FALLBACK_CLASSES = "ks-stat-card-fallback"
 
       INFO_ICON = <<~SVG.freeze
         <svg xmlns="http://www.w3.org/2000/svg" class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" /></svg>
@@ -26,10 +29,13 @@ module Keystone
         info: "ks-tone-info"
       }.freeze
 
-      attr_reader :label, :value, :suffix, :definition, :calculation, :change, :href
+      attr_reader :label, :value, :suffix, :definition, :calculation, :change, :href, :note
 
-      def initialize(label:, value:, variant: :neutral, suffix: nil, definition: nil, calculation: nil, change: nil, href: nil)
+      def initialize(label:, value:, variant: :neutral, suffix: nil, definition: nil, calculation: nil, change: nil, href: nil, note: nil, plain: false, fallback: nil)
         @label = label
+        @fallback = fallback
+        @note = note
+        @plain = plain
         @value = value
         @variant = variant
         @suffix = suffix
@@ -39,8 +45,16 @@ module Keystone
         @href = href
       end
 
+      def missing?
+        @value.to_s.empty? && !@fallback.nil?
+      end
+
+      def fallback
+        @fallback
+      end
+
       def classes
-        CARD_CLASSES
+        @plain ? PLAIN_CLASSES : CARD_CLASSES
       end
 
       def label_classes

data/lib/keystone_ui/version.rb

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

data/the_local/agents/keystone_ui-develop.md

@@ -420,7 +420,7 @@ two exceptions: `ui_page`'s `padding:` treats any value other than `:none` as
 
 10. Explain figures.
 
-    - `ui_stat_card(label:, value:, variant: :neutral, suffix: nil, definition: nil, calculation: nil, change: nil, href: nil)`
+    - `ui_stat_card(label:, value:, variant: :neutral, suffix: nil, definition: nil, calculation: nil, change: nil, href: nil, note: nil, plain: false, fallback: nil)`
       — `variant:` is `:neutral` `:success` `:danger` `:warning` `:info` and
       colours the value. `change:` is a signed number shown as `▲ 4.2%` in
       green, `▼` in red, or plain at zero. `href:` links the value only, so

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: keystone_ui
 version: !ruby/object:Gem::Version
-  version: 0.48.0
+  version: 0.49.0
 platform: ruby
 authors:
 - Tyler Schneider
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.22.0
+        version: 0.25.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.22.0
+        version: 0.25.0
 - !ruby/object:Gem::Dependency
   name: view_component
   requirement: !ruby/object:Gem::Requirement