keystone_ui 0.47.0 → 0.49.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20f1ebc15a9b1a15a854e634286e510b9b224167f3f56181ab756744afaa3f44
-  data.tar.gz: a53452a7e08710ca4659937d39bb6d7384f84daa768f6d8afda29c330677a4a3
+  metadata.gz: c5188a7128c83107e3bb691fbbeb68733c14ff424e97bbbceea5cb4f901409a9
+  data.tar.gz: 897711fad313df1fad9c2d2f2d29fc881c7b26a66c59028842c18816b9fdd364
 SHA512:
-  metadata.gz: 96a47743d927612dbc8cbed5b0ab0f12c8c34ae1df1555377613b1b33962b5a8ab15732e72983879724f03c18d79da3aec22d9973bc3b8a8396b9306b8f671dc
-  data.tar.gz: 7a0a0e1d2910d253f1f424e65082cd63c3bd40e4b3dbf83cdc67186bfbff72e9116c4c8d4b548bfddf5c59a5ee8b6ceb18051f0a8489e3592a12bb95f2460db5
+  metadata.gz: 0ddc36bc018b6ebbd5be50aa7413eaddbc5380598ed7e0af989f3d241bf3522785c8def0d00aaf75b4dc733b45fbe37f18a13860570fcff137604d7f60b521cd
+  data.tar.gz: f95983f302a7fc742e5962b4477b3c21429b93cd9a1a2561390fdc33482483a6f1f68eb661770f9a9cd0cb63b592febd444f18bbce19eb886c4a526a5b9297a9

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

@@ -3,7 +3,7 @@
 module Keystone
   module Ui
     class BottomNavComponent < ViewComponent::Base
-      NAV_CLASSES = "ks-bottom-nav lg:hidden hotwire-native:hidden"
+      NAV_CLASSES = "ks-bottom-nav lg:hidden hotwire-native:hidden print:hidden"
 
       def nav_classes
         NAV_CLASSES

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

@@ -3,7 +3,7 @@
 module Keystone
   module Ui
     class BreadcrumbsComponent < ViewComponent::Base
-      CLASSES = "ks-mobile-header-back ks-breadcrumbs hidden lg:block text-sm"
+      CLASSES = "ks-mobile-header-back ks-breadcrumbs hidden lg:block text-sm print:hidden"
       SEPARATOR = "›"
 
       def initialize(trail:, current: nil)

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

@@ -3,7 +3,7 @@
 module Keystone
   module Ui
     class DesktopBackLinkComponent < ViewComponent::Base
-      CLASSES = "ks-mobile-header-back ks-page-back hidden lg:inline-flex items-center"
+      CLASSES = "ks-mobile-header-back ks-page-back hidden lg:inline-flex items-center print:hidden"
       LABEL = "Back"
 
       def initialize(url:)

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

@@ -9,7 +9,7 @@ module Keystone
         </svg>
       SVG
 
-      WRAPPER_CLASSES = "relative lg:hidden"
+      WRAPPER_CLASSES = "relative lg:hidden print:hidden"
       BUTTON_CLASSES = "ks-action-menu-button"
       DROPDOWN_CLASSES = "ks-action-menu hidden absolute right-0 z-50 w-48 origin-top-right"
 

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

@@ -15,7 +15,7 @@ module Keystone
         </svg>
       SVG
 
-      WRAPPER_CLASSES = "lg:hidden"
+      WRAPPER_CLASSES = "lg:hidden print:hidden"
       BACK_LINK_CLASSES = "ks-mobile-header-back"
       TITLE_CLASSES = "ks-mobile-header-title absolute left-1/2 -translate-x-1/2 lg:hidden truncate max-w-[60%]"
       SUBTITLE_CLASSES = "ks-mobile-header-subtitle block text-xs truncate text-center"

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

@@ -3,7 +3,7 @@
 module Keystone
   module Ui
     class NavbarComponent < ViewComponent::Base
-      NAV_BASE = "top-nav"
+      NAV_BASE = "top-nav print:hidden"
       NAV_STICKY = "sticky top-0 z-40"
       MOBILE_LEFT_CLASSES = "lg:hidden flex items-center"
       LOGO_CLASSES = "logo"

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

@@ -5,9 +5,9 @@ require "keystone_ui/visible_navigation"
 module Keystone
   module Ui
     class NavigationComponent < ViewComponent::Base
-      TOP_BAR_CLASSES = "hidden lg:block sticky top-0 z-40"
+      TOP_BAR_CLASSES = "hidden lg:block sticky top-0 z-40 print:hidden"
       SIDEBAR_ROW_CLASSES = "lg:flex"
-      SIDEBAR_CLASSES = "ks-sidebar hidden lg:flex lg:sticky lg:top-0 lg:h-screen shrink-0 overflow-y-auto"
+      SIDEBAR_CLASSES = "ks-sidebar hidden lg:flex lg:sticky lg:top-0 lg:h-screen shrink-0 overflow-y-auto print:hidden"
       SIDEBAR_LOGO_CLASSES = "ks-sidebar-logo"
       SIDEBAR_GROUP_CLASSES = "flex flex-col"
       SIDEBAR_GROUP_LABEL_CLASSES = "ks-sidebar-group-label"

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.47.0"
+  VERSION = "0.49.0"
 end

data/the_local/agents/keystone_ui-develop.md

@@ -198,6 +198,9 @@ two exceptions: `ui_page`'s `padding:` treats any value other than `:none` as
 
 5. Wire navigation in the layout.
 
+   Every navigation component is left off a printed page, so a printed page or
+   a PDF holds only the page's content.
+
    - `ui_navigation` takes no keywords and a block holding the page content, so
      it goes around `yield`. It draws the tabs the app declares with
      `config.navigation_group` as a top bar of menus from `lg:` up, then the
@@ -417,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.47.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