studio-engine 0.6.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9e4f490c1b36a67d00f603bee9cf9849fd36103fff17a6e348ed98b138f4987
-  data.tar.gz: 5003c6176d386ae82f129b749bd9d914a65e258b40587ff82ec3d7a5c2c3509f
+  metadata.gz: e0dff947db7bda136b0fcca271b86347449fa0d5f259c102ba5fe50e8e29dea8
+  data.tar.gz: 898fb4de879042127da3c85ee072603a8cf4d02125037d13d16793ecc8579e17
 SHA512:
-  metadata.gz: 0ea8405b0e80d57f6d69df6a96dfdb835859e581076b9182d01a88a7b0517f63210835265ce4691549ee0f5c52444cbb504f97e173af4b27a46d99c17c51838c
-  data.tar.gz: '080e131c86404755936a99ae1e41f10a143a32b7401170639ad0251bac7d787c5308bc9cb818db92446576f73b368764c7eef9570764651a015ef295c8e64856'
+  metadata.gz: 91f96cfc96d999ef6ea31aa7d427fb903c538da72470768891dd1e3667d7e5380bf8f931089c24548b9ad844b4c7815e0a9167231dd989c36fd674f04391e831
+  data.tar.gz: dc439df4fc3125f2a98c1511606008f74df5dc869c98a72ca0c4fe6a8ba4e082d093d5093de211e9b6534e280140cb35a6ba31952dc40b667e5fbe5de1b04552

data/CHANGELOG.md

@@ -4,6 +4,13 @@ The format is [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This pro
 
 ## Unreleased
 
+## v0.6.1 (2026-06-18)
+
+### Added
+- **`components/emoji_swap` UI primitive** plus shared CSS for nav/sidebar
+  emoji hover and focus transitions, including reduced-motion fallback and
+  aliases for the existing `nav-emoji-*` class names.
+
 ## v0.6.0 (2026-06-16)
 
 ### Changed

data/README.md

@@ -11,7 +11,7 @@ Shared Rails engine for McRitchie apps. Provides authentication, error handling,
 gem "studio-engine", "~> 0.6"
 ```
 
-Then `bundle install`. The current release is **v0.6.0**; see [`CHANGELOG.md`](./CHANGELOG.md) for the history.
+Then `bundle install`. The current release is **v0.6.1**; see [`CHANGELOG.md`](./CHANGELOG.md) for the history.
 
 > Published to RubyGems as of v0.4.0 (2026-05-17). New installs should use the RubyGems form, which the consumer Rails apps (`mcritchie-studio`, `turf-monster`) already use.
 
@@ -20,6 +20,7 @@ Then `bundle install`. The current release is **v0.6.0**; see [`CHANGELOG.md`](.
 - **Authentication**: Passwordless magic-link auth, optional password auth, Google OAuth via OmniAuth, Solana wallet sign-in, and optional one-way SSO patterns
 - **Error handling**: `Studio::ErrorHandling` concern with `rescue_and_log`, `ErrorLog` model with `capture!`, error log viewer at `/error_logs`
 - **Theme system**: Dynamic CSS custom properties generated from 7 role colors (primary, dark, light, success, accent, warning, danger). Dark/light mode toggle. Admin theme editor at `/admin/theme`.
+- **UI primitives**: Shared component partials and CSS primitives such as `components/emoji_swap` for nav/sidebar emoji hover transitions.
 - **Operator tooling**: Shared `studio/banners/environment` banner with Dev Mode + email connector controls, `studio/banners/impersonation`, and an opt-in `Studio::Impersonation` concern for Act As session conventions.
 - **Sluggable concern**: `before_save :set_slug` with `to_param` for human-readable URLs
 - **ThemeSetting model**: Per-app DB overrides with fallback to config defaults
@@ -111,6 +112,19 @@ audit log, enter/exit controller actions, and any app-specific safeguards such
 as binding session-token checks to `true_user` or disabling wallet-only
 privileges while impersonating.
 
+## UI Primitives
+
+Render `components/emoji_swap` inside a link or button with the `group` class to
+slide between two emoji on hover and keyboard focus. The CSS ships through
+`studio_theme_css_tag`, including a reduced-motion fade fallback.
+
+```erb
+<%= link_to root_path, class: "group inline-flex items-center gap-2" do %>
+  <%= render "components/emoji_swap", base: "📊", hover: "✨" %>
+  <span>Dashboard</span>
+<% end %>
+```
+
 ## Overriding Views
 
 This is a non-isolated engine -- app views at the same path automatically override engine views. For example, placing `app/views/sessions/new.html.erb` in the consuming app replaces the engine's login page.

data/app/helpers/studio_theme_helper.rb

@@ -10,6 +10,6 @@ module StudioThemeHelper
       Studio::ThemeResolver.new(colors).to_css
     end
 
-    tag.style(css.html_safe, nonce: content_security_policy_nonce)
+    tag.style("#{css}\n#{Studio::UiPrimitives.css}".html_safe, nonce: content_security_policy_nonce)
   end
 end

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

@@ -0,0 +1,17 @@
+<%# locals: (base:, hover:, aria_label: nil, class_name: nil) %>
+<%
+  wrapper_classes = ["studio-emoji-swap", "flex-shrink-0", local_assigns[:class_name]].compact_blank.join(" ")
+  attrs = { class: wrapper_classes }
+
+  if local_assigns[:aria_label].present?
+    attrs[:role] = "img"
+    attrs["aria-label"] = aria_label
+  else
+    attrs["aria-hidden"] = "true"
+  end
+%>
+
+<%= tag.span(**attrs) do %>
+  <span class="studio-emoji-swap-base" aria-hidden="true"><%= base %></span>
+  <span class="studio-emoji-swap-hover" aria-hidden="true"><%= hover %></span>
+<% end %>

data/lib/studio/ui_primitives.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Studio
+  module UiPrimitives
+    EMOJI_SWAP_CSS = <<~CSS
+      .studio-emoji-swap,
+      .nav-emoji-swap {
+        position: relative;
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        vertical-align: middle;
+        width: 1.5rem;
+        height: 1.25rem;
+        overflow: hidden;
+      }
+
+      .studio-emoji-swap > span,
+      .nav-emoji-swap > span {
+        position: absolute;
+        inset: 0;
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        transition: transform 240ms cubic-bezier(0.34, 1.2, 0.5, 1), opacity 180ms ease;
+      }
+
+      .studio-emoji-swap-base,
+      .nav-emoji-base {
+        transform: translateX(0);
+        opacity: 1;
+      }
+
+      .studio-emoji-swap-hover,
+      .nav-emoji-hover {
+        transform: translateX(-110%);
+        opacity: 0;
+      }
+
+      .group:hover .studio-emoji-swap-base,
+      .group:focus-visible .studio-emoji-swap-base,
+      .group:focus-within .studio-emoji-swap-base,
+      .group:hover .nav-emoji-base,
+      .group:focus-visible .nav-emoji-base,
+      .group:focus-within .nav-emoji-base {
+        transform: translateX(110%);
+        opacity: 0;
+      }
+
+      .group:hover .studio-emoji-swap-hover,
+      .group:focus-visible .studio-emoji-swap-hover,
+      .group:focus-within .studio-emoji-swap-hover,
+      .group:hover .nav-emoji-hover,
+      .group:focus-visible .nav-emoji-hover,
+      .group:focus-within .nav-emoji-hover {
+        transform: translateX(0);
+        opacity: 1;
+      }
+
+      @media (prefers-reduced-motion: reduce) {
+        .studio-emoji-swap > span,
+        .nav-emoji-swap > span {
+          transition: opacity 120ms ease;
+        }
+
+        .studio-emoji-swap-base,
+        .studio-emoji-swap-hover,
+        .nav-emoji-base,
+        .nav-emoji-hover,
+        .group:hover .studio-emoji-swap-base,
+        .group:focus-visible .studio-emoji-swap-base,
+        .group:focus-within .studio-emoji-swap-base,
+        .group:hover .studio-emoji-swap-hover,
+        .group:focus-visible .studio-emoji-swap-hover,
+        .group:focus-within .studio-emoji-swap-hover,
+        .group:hover .nav-emoji-base,
+        .group:focus-visible .nav-emoji-base,
+        .group:focus-within .nav-emoji-base,
+        .group:hover .nav-emoji-hover,
+        .group:focus-visible .nav-emoji-hover,
+        .group:focus-within .nav-emoji-hover {
+          transform: none;
+        }
+      }
+    CSS
+
+    def self.css
+      EMOJI_SWAP_CSS
+    end
+  end
+end

data/lib/studio/version.rb

@@ -1,3 +1,3 @@
 module Studio
-  VERSION = "0.6.0"
+  VERSION = "0.6.1"
 end

data/lib/studio.rb

@@ -2,6 +2,7 @@ require "studio/version"
 require "studio/engine"
 require "studio/color_scale"
 require "studio/theme_resolver"
+require "studio/ui_primitives"
 require "studio/username_generator"
 require "studio/s3"
 require "studio/image_cache"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: studio-engine
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors:
 - Alex McRitchie
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-16 00:00:00.000000000 Z
+date: 2026-06-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -177,6 +177,7 @@ files:
 - app/views/components/_badge.html.erb
 - app/views/components/_card.html.erb
 - app/views/components/_copy_button.html.erb
+- app/views/components/_emoji_swap.html.erb
 - app/views/components/_empty_state.html.erb
 - app/views/components/_google_logo.html.erb
 - app/views/components/_input.html.erb
@@ -230,6 +231,7 @@ files:
 - lib/studio/mail_transport.rb
 - lib/studio/s3.rb
 - lib/studio/theme_resolver.rb
+- lib/studio/ui_primitives.rb
 - lib/studio/username_generator.rb
 - lib/studio/version.rb
 - lib/tasks/studio_email.rake