studio-engine 0.5.10 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0817243bffbcd834fd5a3d8f593a420b12d8fba691c48337b68e6661ebbe5d7c'
-  data.tar.gz: 5328f4a61db1c6c8965a0291bf0573a1e71b9e83b29e8eafe0a974b5208a0487
+  metadata.gz: e0dff947db7bda136b0fcca271b86347449fa0d5f259c102ba5fe50e8e29dea8
+  data.tar.gz: 898fb4de879042127da3c85ee072603a8cf4d02125037d13d16793ecc8579e17
 SHA512:
-  metadata.gz: 642c7e82c5576ed3565091922473f6da39d3ab5388d5affb5d6c4a7dda9be7f037dda006e5ead66f61ba711701ad0fbd7cb0038227d102e7fc962a22c0fb888d
-  data.tar.gz: 8457efd67516bc2bcb42bc440cf6ff628c9153be16d0064bb8d3998f21d4c9a4f96e6b15a6978c08d8aa97d0f965a94a368f1a5df734589d4a08b61af60a2e7b
+  metadata.gz: 91f96cfc96d999ef6ea31aa7d427fb903c538da72470768891dd1e3667d7e5380bf8f931089c24548b9ad844b4c7815e0a9167231dd989c36fd674f04391e831
+  data.tar.gz: dc439df4fc3125f2a98c1511606008f74df5dc869c98a72ca0c4fe6a8ba4e082d093d5093de211e9b6534e280140cb35a6ba31952dc40b667e5fbe5de1b04552

data/CHANGELOG.md

@@ -1,9 +1,22 @@
 # Changelog
 
-The format is [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html) — `MAJOR.MINOR.PATCH`. Consumer Rails apps install the released RubyGems package with `gem "studio-engine", "~> 0.5"`; bumping the gem version and updating consumer lockfiles is a release.
+The format is [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html) — `MAJOR.MINOR.PATCH`. Consumer Rails apps install the released RubyGems package with `gem "studio-engine", "~> 0.6"`; bumping the gem version and updating consumer lockfiles is a release.
 
 ## 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
+- Require `tailwindcss-rails ~> 4.5` so Studio apps can move onto the
+  Tailwind CSS v4 build chain together.
+
 ## v0.5.10 (2026-06-15)
 
 ### Added

data/README.md

@@ -8,10 +8,10 @@ Shared Rails engine for McRitchie apps. Provides authentication, error handling,
 
 ```ruby
 # Gemfile — install from RubyGems (recommended)
-gem "studio-engine", "~> 0.5"
+gem "studio-engine", "~> 0.6"
 ```
 
-Then `bundle install`. The current release is **v0.5.10**; 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.5.10**; 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.5.10"
+  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"

data/studio-engine.gemspec

@@ -22,7 +22,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "rails", ">= 7.0", "< 8.0"
-  spec.add_dependency "tailwindcss-rails", "~> 2.7"
+  spec.add_dependency "tailwindcss-rails", "~> 4.5"
   spec.add_dependency "faker", ">= 2.0", "< 4.0"
   spec.add_dependency "solid_queue", ">= 1.0", "< 2.0"
   spec.add_dependency "aws-sdk-s3", "~> 1.218"

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: studio-engine
 version: !ruby/object:Gem::Version
-  version: 0.5.10
+  version: 0.6.1
 platform: ruby
 authors:
 - Alex McRitchie
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-06-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -35,14 +36,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '4.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '4.5'
 - !ruby/object:Gem::Dependency
   name: faker
   requirement: !ruby/object:Gem::Requirement
@@ -176,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
@@ -229,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
@@ -243,6 +246,7 @@ metadata:
   source_code_uri: https://github.com/amcritchie/studio-engine/tree/main
   bug_tracker_uri: https://github.com/amcritchie/studio-engine/issues
   changelog_uri: https://github.com/amcritchie/studio-engine/blob/main/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -257,7 +261,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.9
+rubygems_version: 3.5.11
+signing_key:
 specification_version: 4
 summary: Shared Rails engine providing auth, SSO, error logging, theming, and S3-backed
   image caching