studio-engine 0.105.0.rc1 → 0.106.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8d6d2e7f0fd6764c079a422a705446c36254603f9c49c2f7999d5ee31ce9ea3
-  data.tar.gz: eecf186eda2510ddc315ed69346b1d26de64104f0ee01ef8420bbeddc6d87a75
+  metadata.gz: a988ae9e78ea6355954e11d8698fc41f69ea88bd91e4d86c21932625081e4aae
+  data.tar.gz: d8fdbcc944fc672efe43802dea5f4e16b6f14d7950cc731fe8d7b72b69cee8b0
 SHA512:
-  metadata.gz: 8f6b2847809ddf9520d659809f9be964314e784c096ab8caa459862635464cb416a5fbd729c3c16eb8b10bda96efafddc92ce0d6ab64c5c338e0c44074a66a1e
-  data.tar.gz: d64c2f5daadeafb668d574e32ea8db2ee5f6e50136ce9efd34d62526ee5be505c558933d1e253142bff5d42632bba39dc8337f9ed09c338cbfebfb2f8dc5346f
+  metadata.gz: 78ec459d2b0357d17e186dc0d878a2feaa14228855e62fbbe2e9eee000f3a7061c147a277f28851658028697a26959056ac5e4f13ef48dbdb46840135cec125e
+  data.tar.gz: e25bf874a2f3560b3e164ac9d05532052567361aa9220a3c49cf232af7001ee3fbaddedb70a24f0f73873cfc2d936d9561a256e6fbed7f16f256a81fe219bc85

data/CHANGELOG.md

@@ -4,6 +4,24 @@ The format is [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This pro
 
 ## Unreleased
 
+## 0.106.0 — 2026-10-14
+
+### Changed
+
+- **The navbar names the signed-in user by first name.** With
+  `Studio.navbar_user_name` unset, the user nav (and anything else calling
+  `Studio.navbar_user_name_for`) prints the user's `first_name`, else the first
+  word of `name`, else `display_name` whole, as before. A host that configures
+  the setting is unchanged. A user nav with no second row now centres its icon
+  column, so the gear and theme toggle sit level with the name rather than at
+  the top of the bar.
+- **A host can make the name and avatar open the link sidebar.** Define the
+  view helper `studio_account_opens_sidebar?` as true and the account link
+  carries the sidebar's toggle attributes (`data-profile-image-toggle`,
+  `aria-controls`), so `studio/link_sidebar` opens the sidebar on click; the
+  link keeps its href for a click before that script loads. Without the helper
+  the link is unchanged.
+
 ## 0.105.0 — 2026-10-13
 
 ### Added

data/README.md

@@ -624,13 +624,13 @@ end
 
 ### Navbar identity — `Studio.navbar_user_name` and `Studio.sign_in_label`
 
-Two words the navbar says about the viewer. Both defaults render the navbar
-byte-identical to before, so an app that sets neither sees no change. Rules:
-`lib/studio/navbar_identity.rb`.
+Two words the navbar says about the viewer. The name defaults to the user's
+first name: the `first_name` column, else the first word of `name`, else
+`display_name` whole. Rules: `lib/studio/navbar_identity.rb`.
 
 ```ruby
 Studio.configure do |config|
-  # The signed-in name in components/_user_nav. nil (the default) is display_name.
+  # The signed-in name in components/_user_nav. nil (the default) is the first name.
   config.navbar_user_name = :player_name                        # a method on the user
   # config.navbar_user_name = ->(user, view) { user.player_name } # or a callable
 

data/app/views/components/_user_nav.html.erb

@@ -78,8 +78,10 @@
         defaults to min-width auto, and without it this column refuses to
         shrink below balance + icons. On a 320px phone with a balance the
         reserved column is 147px, and a column that will not give pushed the
-        avatar 17px past the screen edge (e2e/header_phone_width.spec.js). %>
-    <div class="flex-1 min-w-0">
+        avatar 17px past the screen edge (e2e/header_phone_width.spec.js).
+        It is a centred flex column, so with no second row the icons sit level
+        with the name and avatar rather than at the top of the bar. %>
+    <div class="flex-1 min-w-0 flex flex-col justify-center" data-nav-tools>
       <%# Div 1 (Bigger): balance + icons. %>
       <div class="flex items-center gap-2 leading-none" :style="'padding: 0 6px;' + ($store.devMode ? 'background: cornflowerblue;' : '')">
         <%= studio_nav_slot.call(balance_slot, balance_html) %>
@@ -207,8 +209,22 @@
         column beside it is what gives way. So the name cannot truncate by
         flex shrinking: from md up its box carries a max width instead, and
         the name ellipsizes inside it. The avatar is aria-hidden: the name is
-        the link's accessible name. %>
+        the link's accessible name.
+
+        A host whose link sidebar heads with the profile can make the link open
+        the sidebar instead, by defining studio_account_opens_sidebar? as true
+        (a view helper; the engine defines none, so every other host keeps the
+        link). The link then carries the sidebar's toggle attributes and
+        studio/link_sidebar claims its click; the href stays, so a click before
+        that script loads still reaches the account page. %>
     <% account_classes = "group flex items-center gap-2 flex-shrink-0" %>
+    <% account_toggle =
+         if studio_nav_destination && respond_to?(:studio_account_opens_sidebar?) && studio_account_opens_sidebar?
+           { "data-profile-image-toggle": "", "aria-controls": "studio-link-sidebar studio-link-sidebar-mobile",
+             "aria-haspopup": "dialog", ":aria-expanded": "$store.sidebars && $store.sidebars.linkTreeOpen ? 'true' : 'false'" }
+         else
+           {}
+         end %>
     <% account_inner = capture do %>
       <span class="sr-only md:not-sr-only md:max-w-40"><span class="block truncate text-right text-heading font-semibold text-base leading-none transition<%= " group-hover:text-primary" if studio_nav_destination %>" data-nav-name><%= Studio.navbar_user_name_for(current_user, self) %></span></span>
       <span class="flex-shrink-0 flex items-center" aria-hidden="true">
@@ -216,7 +232,7 @@
       </span>
     <% end %>
     <% if studio_nav_destination %>
-      <%= link_to account_inner, studio_nav_destination, class: "#{account_classes} hover:opacity-80 transition", "data-nav-account": "", "x-bind:style": "$store.devMode && 'background: lightgreen'" %>
+      <%= link_to account_inner, studio_nav_destination, class: "#{account_classes} hover:opacity-80 transition", "data-nav-account": "", "x-bind:style": "$store.devMode && 'background: lightgreen'", **account_toggle %>
     <% else %>
       <span class="<%= account_classes %>" data-nav-account x-bind:style="$store.devMode && 'background: lightgreen'"><%= account_inner %></span>
     <% end %>

data/lib/studio/navbar_identity.rb

@@ -7,7 +7,8 @@
 #
 # Studio.navbar_user_name is one of:
 #
-#   nil                     the default: user.display_name, as before
+#   nil                     the default: the user's first name (first_name, else
+#                           the first word of name), else user.display_name
 #   :player_name            a method called on the user ("player_name" works too)
 #   ->(user, view) { ... }  a callable; a one-argument callable gets the user only
 #
@@ -32,7 +33,7 @@ module Studio
 
     def user_name(user, view = nil, config: Studio.navbar_user_name)
       fallback = user.display_name # outside the rescue: the default path is not ours to swallow
-      return fallback if config.nil?
+      return first_name(user) || fallback if config.nil?
 
       begin
         text = plain_text(configured_name(config, user, view))
@@ -62,6 +63,16 @@ module Studio
       @reported_lock.synchronize { @reported.clear }
     end
 
+    # The default name: the first_name column, else the first word of name; nil
+    # when the host has neither, and the caller prints display_name. display_name
+    # itself is never split: a host may build it from a username or an email.
+    def first_name(user)
+      given = plain_text(user.first_name) if user.respond_to?(:first_name)
+      return given unless given.to_s.empty?
+
+      plain_text(user.name).split.first if user.respond_to?(:name)
+    end
+
     def configured_name(config, user, view)
       return user.public_send(config.to_sym) unless config.respond_to?(:call)
 

data/lib/studio/version.rb

@@ -1,3 +1,3 @@
 module Studio
-  VERSION = "0.105.0.rc1"
+  VERSION = "0.106.0.rc1"
 end

data/lib/studio.rb

@@ -223,7 +223,7 @@ module Studio
 
   # ---- Navbar identity ----
   # The name the signed-in user nav prints, and the signed-out button's label.
-  # Both defaults render the navbar byte-identical to before. The engine has no
+  # The name defaults to the user's first name. The engine has no
   # I18n catalogue, so the label is plain config rather than a locale key.
   # The label also words the engine's auth pages (lib/studio/auth_labels.rb).
   # Rules: lib/studio/navbar_identity.rb.
@@ -232,7 +232,8 @@ module Studio
   #   config.navbar_user_name = ->(user, view) { user.player_name }   # or a callable
   #   config.sign_in_label    = "Sign in"
   #
-  # nil means user.display_name. A method or callable that raises, or answers
+  # nil means the first name (first_name, else the first word of name), else
+  # user.display_name. A method or callable that raises, or answers
   # blank, falls back to display_name; a raise is reported once, never a 500.
   mattr_reader :navbar_user_name, default: nil
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: studio-engine
 version: !ruby/object:Gem::Version
-  version: 0.105.0.rc1
+  version: 0.106.0.rc1
 platform: ruby
 authors:
 - Alex McRitchie
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-13 00:00:00.000000000 Z
+date: 2026-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails