keystone_ui 0.40.0 → 0.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50be7dcd619f5461a74ec4c8b7d2d6e09deb955af9b17817b1ef690f842f5a07
-  data.tar.gz: 1148f6cf6bba00291658cec6c0672eeae3500093ebbffec67bbbc412fabe72eb
+  metadata.gz: fff79f2588c403bbbb1d39b9fec8075955b0f758019fdea442d1dbc081750f99
+  data.tar.gz: f92a6ccfa5f383ccc81952c008c8d3dcd59d61906b36d62de4bb9186a3bfcd58
 SHA512:
-  metadata.gz: 884b4a4d0b72cf66bc76d5e94af4322a65f1b82aa81a5fba5b6b3f3fbad865524d6dd7fb75dce0a33d1fec8e88e41691a4a57b045e5d920751b3c6fe1453e545
-  data.tar.gz: ca9f20d6ef81510e165a8c6a938e6a2cc0cb37dfc1c426b97f17e1695686521727d5e0336809084761d8c0e59f90aef425fe912878d79661e44fa89e4d12137b
+  metadata.gz: f61c6841e06dcb1fed471c93fbfb41f7655b32e44348ea45df84d961c9b735b051f6e40232738e4df478ea34dac3e6a0c48c8172c2367ddb7f90c292fafdb6cf
+  data.tar.gz: d319f7e7a1782535045369da6220ba4dfe0c9fad7a7b15ec8132dddd23b75e69943881df988275cef18b3c41c898afca053d4d2592b3e7e8b091b5acab993e02

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

@@ -7,12 +7,19 @@
       <div class="<%= SIDEBAR_LOGO_CLASSES %>"><%= logo %></div>
     <% end %>
     <% groups.each do |group| %>
-      <details class="<%= SIDEBAR_GROUP_CLASSES %>"<%= " open" if group.active %>>
-        <summary class="<%= sidebar_group_label_classes(group) %>"><%= group.label %></summary>
-        <% group.tabs.each do |tab| %>
-          <a class="<%= sidebar_tab_classes(tab) %>" href="<%= tab.href %>"><%= tab.label %></a>
-        <% end %>
-      </details>
+      <% if group.standalone %>
+        <% tab = group.tabs.first %>
+        <a class="<%= sidebar_tab_classes(tab) %>" href="<%= tab.href %>"><%= tab.label %></a>
+      <% else %>
+        <details class="<%= SIDEBAR_GROUP_CLASSES %>"<%= " open" if group.active %>>
+          <summary class="<%= sidebar_group_label_classes(group) %>"><%= group.label %></summary>
+          <div class="<%= SIDEBAR_GROUP_TABS_CLASSES %>">
+            <% group.tabs.each do |tab| %>
+              <a class="<%= sidebar_tab_classes(tab) %>" href="<%= tab.href %>"><%= tab.label %></a>
+            <% end %>
+          </div>
+        </details>
+      <% end %>
     <% end %>
     <% if menus? %>
       <div class="<%= SIDEBAR_MENUS_CLASSES %>"><%= menus %></div>
@@ -33,9 +40,14 @@
   <% end %>
   <% navbar.with_desktop_links do %>
     <% groups.each do |group| %>
-      <%= render Keystone::Ui::NavDropdownComponent.new(title: group.label, area: group.label, active: group.active) do %>
-        <% group.tabs.each do |tab| %>
-          <%= render Keystone::Ui::NavItemComponent.new(label: tab.label, href: tab.href, active: tab.active) %>
+      <% if group.standalone %>
+        <% tab = group.tabs.first %>
+        <%= render Keystone::Ui::NavItemComponent.new(label: tab.label, href: tab.href, active: tab.active) %>
+      <% else %>
+        <%= render Keystone::Ui::NavDropdownComponent.new(title: group.label, area: group.label, active: group.active) do %>
+          <% group.tabs.each do |tab| %>
+            <%= render Keystone::Ui::NavItemComponent.new(label: tab.label, href: tab.href, active: tab.active) %>
+          <% end %>
         <% end %>
       <% end %>
     <% end %>

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

@@ -11,6 +11,7 @@ module Keystone
       SIDEBAR_LOGO_CLASSES = "ks-sidebar-logo"
       SIDEBAR_GROUP_CLASSES = "flex flex-col"
       SIDEBAR_GROUP_LABEL_CLASSES = "ks-sidebar-group-label"
+      SIDEBAR_GROUP_TABS_CLASSES = "ks-sidebar-group-tabs"
       SIDEBAR_TAB_CLASSES = "ks-sidebar-tab"
       ACTIVE_CLASS = "active"
       SIDEBAR_MENUS_CLASSES = [

data/lib/keystone_ui/configuration.rb

@@ -31,6 +31,12 @@ module KeystoneUi
       @navigation_groups << group
     end
 
+    def navigation_tab(key, label:, href:, permitted:)
+      group = NavigationGroup.new(label, standalone: true)
+      group.tab(key, label: label, href: href, permitted: permitted)
+      @navigation_groups << group
+    end
+
     def supplied_look(view)
       look_supplier&.call(view)&.to_s
     end

data/lib/keystone_ui/navigation_group.rb

@@ -10,11 +10,16 @@ module KeystoneUi
 
     attr_reader :label, :tabs
 
-    def initialize(label)
+    def initialize(label, standalone: false)
       @label = label
+      @standalone = standalone
       @tabs = []
     end
 
+    def standalone?
+      @standalone
+    end
+
     def tabs_permitted_for(view)
       tabs.select { |tab| tab.permitted.call(view) }
     end

data/lib/keystone_ui/version.rb

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

data/lib/keystone_ui/visible_navigation.rb

@@ -4,7 +4,7 @@ require "keystone_ui/navigation_order"
 
 module KeystoneUi
   class VisibleNavigation
-    Group = Struct.new(:label, :tabs, :active, keyword_init: true)
+    Group = Struct.new(:label, :tabs, :active, :standalone, keyword_init: true)
     Tab = Struct.new(:label, :href, :active, keyword_init: true)
 
     def initialize(declared_groups, view:, saved_order:, current_tab:)
@@ -28,7 +28,7 @@ module KeystoneUi
 
     def visible_group(group, tabs)
       visible_tabs = tabs.map { |tab| visible_tab(tab) }
-      Group.new(label: group.label, tabs: visible_tabs, active: visible_tabs.any?(&:active))
+      Group.new(label: group.label, tabs: visible_tabs, active: visible_tabs.any?(&:active), standalone: group.standalone?)
     end
 
     def visible_tab(tab)

data/the_local/agents/keystone_ui-develop.md

@@ -197,7 +197,10 @@ two exceptions: `ui_page`'s `padding:` treats any value other than `:none` as
      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
      content, and below `lg:` it draws only the content. It leaves out tabs
-     whose permission check fails and groups with no tab left.
+     whose permission check fails and groups with no tab left. A tab declared
+     outside any group with `config.navigation_tab` is drawn as a plain link
+     in the top bar and as a plain tab with no group label in the sidebar,
+     which does not open or close.
    - Inside its block, `navigation.with_logo do ... end` puts the app's logo at
      the left of the top bar, and `navigation.with_menus do ... end` puts menus
      such as the account menu at its right, so the layout draws no second bar.

data/the_local/agents/keystone_ui-install.md

@@ -31,6 +31,8 @@ built on ViewComponent; hook it in before building any screen with those helpers
   saves to, and the navigation's placement under the key `:navigation`),
   `navigation_group` (a labelled group of desktop tabs that the navigation
   helper draws, each tab declared with `tab key, label:, href:, permitted:`),
+  `navigation_tab` (a single desktop tab outside any group, declared with
+  `navigation_tab key, label:, href:, permitted:`),
   `current_tab_supplier` (a callable that supplies the key of the declared tab
   the current page belongs to, so the navigation marks it and its group
   active),
@@ -324,6 +326,11 @@ built on ViewComponent; hook it in before building any screen with those helpers
      `href:`, when two tabs share a key, or when a group has no tabs. Drawing
      the declared groups in the layout is done with the navigation helper,
      which belongs to `keystone_ui-develop`.
+   - `navigation_tab key, label:, href:, permitted:` — declares one tab
+     outside any group, such as a Console or Clients tab, in its place among
+     the groups. The navigation helper draws it as a plain link in the top bar
+     and as a plain tab with no group label in the sidebar. A saved `"order"`
+     names it under `"group"` by its label.
    - `current_tab_supplier` — a callable that receives the view and returns the
      key of the declared tab the current page belongs to, or `nil`.
      The navigation shows that tab and its group as active in the top bar and

metadata

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