baldur 0.1.7 → 0.2.3

data/app/views/baldur/components/_theme_toggle.html.erb

@@ -0,0 +1,23 @@
+<%
+  aria_label = local_assigns[:aria_label] || "Toggle theme"
+  extra_classes = local_assigns[:classes]
+  toggle_classes = ["switch", "theme-toggle"].tap do |classes|
+    classes << extra_classes if extra_classes.present?
+  end.join(" ")
+%>
+<label class="<%= toggle_classes %>">
+  <input type="checkbox"
+         data-theme-target="toggle"
+         data-theme-toggle
+         aria-label="<%= aria_label %>" />
+  <span class="switch__track">
+    <span class="switch__icon switch__icon--sun" aria-hidden="true"><%= ui_icon("sun", class_name: "h-4 w-4") %></span>
+    <span class="switch__icon switch__icon--moon" aria-hidden="true"><%= ui_icon("moon", class_name: "h-4 w-4") %></span>
+    <span class="switch__thumb"></span>
+  </span>
+  <span class="icon-button theme-toggle__compact" aria-hidden="true" data-action="click->theme#toggle">
+    <span class="theme-toggle__compact-icon theme-toggle__compact-icon--sun"><%= ui_icon("sun", class_name: "h-5 w-5") %></span>
+    <span class="theme-toggle__compact-icon theme-toggle__compact-icon--moon"><%= ui_icon("moon", class_name: "h-5 w-5") %></span>
+  </span>
+  <span class="sr-only"><%= aria_label %></span>
+</label>

data/app/views/baldur/optional/_auth_page.html.erb

@@ -6,6 +6,12 @@
 
 <div class="<%= auth_shell_classes %>">
   <div class="auth-page__container">
+    <% if local_assigns[:top_rail].present? %>
+      <div class="auth-page__top-rail">
+        <%= local_assigns[:top_rail] %>
+      </div>
+    <% end %>
+
     <div class="auth-page__brand">
       <%= link_to resolved_brand_path, class: "inline-flex items-center justify-center no-underline" do %>
         <%= render "shared/brand_lockup",

data/baldur.gemspec

@@ -1,36 +1,36 @@
-require_relative "lib/baldur/version"
+require_relative 'lib/baldur/version'
 
 Gem::Specification.new do |spec|
-  spec.name        = "baldur"
+  spec.name        = 'baldur'
   spec.version     = Baldur::VERSION
-  spec.authors     = [ "Varun Murkar" ]
-  spec.summary     = "Reusable Rails UI engine for same-stack application interfaces"
-  spec.description = "Baldur packages reusable Rails view helpers, components, styles, and Stimulus controllers."
-  spec.homepage    = "https://github.com/varunmurkar/baldur"
-  spec.license     = "MIT"
+  spec.authors     = ['Varun Murkar']
+  spec.summary     = 'Batteries-included Rails UI engine for the importmap, Stimulus, Tailwind stack'
+  spec.description = 'Baldur helps Rails teams ship polished UI faster with install generators, reusable ui_* helpers, Tailwind components, and Stimulus wiring for apps using Propshaft, importmap-rails, stimulus-rails, and tailwindcss-rails.'
+  spec.homepage    = 'https://github.com/varunmurkar/baldur'
+  spec.license     = 'MIT'
   spec.metadata = {
-    "source_code_uri" => "https://github.com/varunmurkar/baldur",
-    "bug_tracker_uri" => "https://github.com/varunmurkar/baldur/issues",
-    "changelog_uri" => "https://github.com/varunmurkar/baldur/releases",
-    "rubygems_mfa_required" => "true"
+    'source_code_uri' => 'https://github.com/varunmurkar/baldur',
+    'bug_tracker_uri' => 'https://github.com/varunmurkar/baldur/issues',
+    'changelog_uri' => 'https://github.com/varunmurkar/baldur/releases',
+    'rubygems_mfa_required' => 'true'
   }
 
   spec.files = Dir.chdir(__dir__) do
     Dir[
-      "{app,config,lib,script,test}/**/*",
-      "README.md",
-      "TODO.md",
-      "LICENSE",
-      "SECURITY.md",
-      "baldur.gemspec",
-      "Gemfile"
+      '{app,config,lib,script,test}/**/*',
+      'README.md',
+      'TODO.md',
+      'LICENSE',
+      'SECURITY.md',
+      'baldur.gemspec',
+      'Gemfile'
     ].select { |path| File.file?(path) }
   end
 
-  spec.required_ruby_version = ">= 3.3.0"
+  spec.required_ruby_version = '>= 3.3.0'
 
-  spec.add_dependency "importmap-rails"
-  spec.add_dependency "lucide-rails"
-  spec.add_dependency "rails", ">= 8.1.0"
-  spec.add_dependency "tailwindcss-rails", ">= 4.4.0"
+  spec.add_dependency 'importmap-rails'
+  spec.add_dependency 'lucide-rails'
+  spec.add_dependency 'rails', '>= 7.0.0'
+  spec.add_dependency 'tailwindcss-rails', '>= 4.3.0'
 end

data/config/importmap.rb

@@ -1,2 +1,2 @@
-pin_all_from File.expand_path("../app/assets/javascripts/baldur/controllers", __dir__), under: "baldur/controllers"
-pin_all_from File.expand_path("../app/assets/javascripts/baldur/lib", __dir__), under: "baldur/lib"
+pin_all_from File.expand_path('../app/assets/javascripts/baldur/controllers', __dir__), under: 'baldur/controllers'
+pin_all_from File.expand_path('../app/assets/javascripts/baldur/lib', __dir__), under: 'baldur/lib'

data/lib/baldur/configuration.rb

@@ -10,15 +10,15 @@ module Baldur
     def initialize
       @warning_dependency_resolver = ->(_warning_keys) { [] }
       @dependency_dataset_name_resolver = ->(dataset_key) { dataset_key.to_s.humanize }
-      @unavailable_fallback_message = "Missing metric or raw data required to compute this value."
+      @unavailable_fallback_message = 'Missing metric or raw data required to compute this value.'
       @marketing_brand = {
-        name: "Brand",
-        wordmark: "Brand",
-        logo_src: "/icon.png",
-        logo_alt: "Brand logo"
+        name: 'Brand',
+        wordmark: 'Brand',
+        logo_src: '/icon.png',
+        logo_alt: 'Brand logo'
       }
       @default_google_sign_in_path = nil
-      @theme_storage_key = "baldur.theme"
+      @theme_storage_key = 'baldur.theme'
     end
   end
 end

data/lib/baldur/engine.rb

@@ -2,9 +2,9 @@ module Baldur
   class Engine < ::Rails::Engine
     isolate_namespace Baldur
 
-    initializer "baldur.importmap", before: "importmap" do |app|
-      app.config.importmap.paths << Engine.root.join("config/importmap.rb")
-      app.config.importmap.cache_sweepers << Engine.root.join("app/assets/javascripts")
+    initializer 'baldur.importmap', before: 'importmap' do |app|
+      app.config.importmap.paths << Engine.root.join('config/importmap.rb')
+      app.config.importmap.cache_sweepers << Engine.root.join('app/assets/javascripts')
     end
   end
 end

data/lib/baldur/version.rb

@@ -1,3 +1,3 @@
 module Baldur
-  VERSION = "0.1.7".freeze
+  VERSION = '0.2.3'.freeze
 end

data/lib/baldur.rb

@@ -1,9 +1,9 @@
-require "rails"
-require "lucide-rails"
+require 'rails'
+require 'lucide-rails'
 
-require_relative "baldur/version"
-require_relative "baldur/configuration"
-require_relative "baldur/engine"
+require_relative 'baldur/version'
+require_relative 'baldur/configuration'
+require_relative 'baldur/engine'
 
 module Baldur
   class << self

data/lib/generators/baldur/install/install_generator.rb

@@ -1,12 +1,13 @@
-require "rails/generators"
+require 'rails/generators'
 
 module Baldur
   module Generators
     class InstallGenerator < Rails::Generators::Base
-      source_root File.expand_path("templates", __dir__)
+      source_root File.expand_path('templates', __dir__)
 
       CORE_CONTROLLERS = %w[
         accordion
+        confirmation
         date_field
         details_menu
         form_submit
@@ -34,19 +35,19 @@ module Baldur
       ].freeze
 
       def create_ui_helper
-        template "ui_helper.rb", "app/helpers/ui_helper.rb"
+        template 'ui_helper.rb', 'app/helpers/ui_helper.rb'
       end
 
       def create_initializer
-        template "baldur_initializer.rb", "config/initializers/baldur.rb"
+        template 'baldur_initializer.rb', 'config/initializers/baldur.rb'
       end
 
       def create_theme_override
-        template "theme.css", "app/assets/stylesheets/theme.css"
+        template 'theme.css', 'app/assets/stylesheets/theme.css'
       end
 
       def create_fonts_override
-        template "fonts.css", "app/assets/stylesheets/fonts.css"
+        template 'fonts.css', 'app/assets/stylesheets/fonts.css'
       end
 
       def create_controller_shims
@@ -68,9 +69,9 @@ module Baldur
       def add_stylesheet_import
         return unless File.exist?(tailwind_entrypoint_path)
 
-        append_unique_line tailwind_entrypoint_path, "@import \"../stylesheets/fonts.css\";"
-        append_unique_line tailwind_entrypoint_path, "@import \"../builds/tailwind/baldur.css\";"
-        append_unique_line tailwind_entrypoint_path, "@import \"../stylesheets/theme.css\";"
+        append_unique_line tailwind_entrypoint_path, '@import "../stylesheets/fonts.css";'
+        append_unique_line tailwind_entrypoint_path, '@import "../builds/tailwind/baldur.css";'
+        append_unique_line tailwind_entrypoint_path, '@import "../stylesheets/theme.css";'
         ensure_stylesheet_import_order
       end
 
@@ -82,19 +83,19 @@ module Baldur
 
       def ensure_stylesheet_import_order
         source = File.read(tailwind_entrypoint_path)
-        fonts_import = "@import \"../stylesheets/fonts.css\";"
-        tailwind_import = "@import \"tailwindcss\";"
-        baldur_import = "@import \"../builds/tailwind/baldur.css\";"
-        theme_import = "@import \"../stylesheets/theme.css\";"
+        fonts_import = '@import "../stylesheets/fonts.css";'
+        tailwind_import = '@import "tailwindcss";'
+        baldur_import = '@import "../builds/tailwind/baldur.css";'
+        theme_import = '@import "../stylesheets/theme.css";'
         normalized = source.lines.reject { |line| line.strip == fonts_import }.join
         normalized = if normalized.include?(tailwind_import)
-          normalized.sub("#{tailwind_import}\n", "#{fonts_import}\n#{tailwind_import}\n")
-        else
-          "#{fonts_import}\n#{normalized}"
-        end
+                       normalized.sub("#{tailwind_import}\n", "#{fonts_import}\n#{tailwind_import}\n")
+                     else
+                       "#{fonts_import}\n#{normalized}"
+                     end
 
         if normalized.include?(baldur_import) && normalized.include?(theme_import) &&
-            normalized.index(baldur_import) > normalized.index(theme_import)
+           normalized.index(baldur_import) > normalized.index(theme_import)
           normalized = normalized.lines.reject { |line| line.strip == theme_import }.join
           normalized = normalized.sub("#{baldur_import}\n", "#{baldur_import}\n#{theme_import}\n")
         end
@@ -107,7 +108,7 @@ module Baldur
       end
 
       def tailwind_entrypoint
-        "app/assets/tailwind/application.css"
+        'app/assets/tailwind/application.css'
       end
     end
   end

data/lib/generators/baldur/install/templates/baldur_initializer.rb

@@ -1,13 +1,13 @@
-require "baldur"
+require 'baldur'
 
 Baldur.configure do |config|
-  config.unavailable_fallback_message = "Missing metric or raw data required to compute this value."
-  config.theme_storage_key = "baldur.theme"
+  config.unavailable_fallback_message = 'Missing metric or raw data required to compute this value.'
+  config.theme_storage_key = 'baldur.theme'
   config.marketing_brand = {
-    name: "Your Brand",
-    wordmark: "Your Brand",
-    logo_src: "/icon.png",
-    logo_alt: "Your Brand logo"
+    name: 'Your Brand',
+    wordmark: 'Your Brand',
+    logo_src: '/icon.png',
+    logo_alt: 'Your Brand logo'
   }
 
   # Supply host-specific lookups when using unavailable dependency helpers.

data/lib/generators/baldur/install/templates/theme.css

@@ -1,12 +1,36 @@
 /*
  * Host theme overrides.
  *
- * Override only the base palette inputs below. Baldur remains the source of
- * truth for semantic tokens, light/dark role mapping, and component styling.
- * Use `fonts.css` to load font files, then map those loaded families to the
- * font tokens below.
+ * ── Brand inputs ─────────────────────────────────────────
+ * Override the four base palette tokens to rebrand. Baldur
+ * derives all semantic and role tokens from these inputs;
+ * do NOT override the semantic outputs directly.
  *
- * Example:
+ *   --_primary-base   primary actions / CTA
+ *   --_secondary-base sidebar, nav, subdued surfaces
+ *   --_accent-base    highlights, badges, tags
+ *   --_neutral-base   surfaces, text, borders
+ *
+ * Values are oklch(). To pick a color, convert to oklch and
+ * paste the three channels (L C H) — no parens needed:
+ *
+ *   --_primary-base: oklch(0.68 0.16 27);
+ *
+ * ── Semantic tokens ──────────────────────────────────────
+ * Baldur owns all --color-* semantic tokens (e.g. --color-primary,
+ * --color-surface, --color-on-surface). They adapt between
+ * light/dark automatically. Do not override them here.
+ *
+ * ── Font mapping ─────────────────────────────────────────
+ * Load web fonts in fonts.css, then map the loaded families
+ * to the tokens below. Baldur uses --font-body as the default
+ * family for body, heading, and UI text unless overridden.
+ *
+ *   --font-body     body copy
+ *   --font-heading  headings (falls back to --font-body)
+ *   --font-ui       buttons, labels, form text (falls back to --font-body)
+ *
+ * ── Example ──────────────────────────────────────────────
  * :root {
  *   --_primary-base: oklch(0.68 0.16 27);
  *   --_secondary-base: oklch(0.30 0.04 195);
@@ -15,6 +39,8 @@
  *   --font-body: "Geist", "Inter", "Segoe UI", "Helvetica Neue", Arial, system-ui, -apple-system, sans-serif;
  *   --font-heading: var(--font-body);
  *   --font-ui: var(--font-body);
+ *   --font-family: var(--font-body);
+ *   --font-sans: var(--font-body);
  * }
  */
 
@@ -24,4 +50,4 @@
   --font-ui: var(--font-body);
   --font-family: var(--font-body);
   --font-sans: var(--font-body);
-}
+}

data/lib/generators/baldur/install_google_auth/install_google_auth_generator.rb

@@ -1,10 +1,10 @@
-require "rails/generators"
+require 'rails/generators'
 
 module Baldur
   module Generators
     class InstallGoogleAuthGenerator < Rails::Generators::Base
       def create_helper
-        create_file "app/helpers/google_auth_helper.rb", <<~RUBY
+        create_file 'app/helpers/google_auth_helper.rb', <<~RUBY
           module GoogleAuthHelper
             include Baldur::Optional::GoogleAuthHelper
           end

data/lib/generators/baldur/install_panel_right/install_panel_right_generator.rb

@@ -1,5 +1,5 @@
-require "rails/generators"
-require_relative "../install_panel_secondary/install_panel_secondary_generator"
+require 'rails/generators'
+require_relative '../install_panel_secondary/install_panel_secondary_generator'
 
 module Baldur
   module Generators

data/lib/generators/baldur/install_panel_secondary/install_panel_secondary_generator.rb

@@ -1,10 +1,10 @@
-require "rails/generators"
+require 'rails/generators'
 
 module Baldur
   module Generators
     class InstallPanelSecondaryGenerator < Rails::Generators::Base
       def create_helper
-        create_file "app/helpers/panel_secondary_helper.rb", <<~RUBY
+        create_file 'app/helpers/panel_secondary_helper.rb', <<~RUBY
           module PanelSecondaryHelper
             include Baldur::Optional::PanelSecondaryHelper
           end
@@ -12,7 +12,7 @@ module Baldur
       end
 
       def create_controller_shim
-        create_file "app/javascript/controllers/panel_secondary_controller.js", <<~JS
+        create_file 'app/javascript/controllers/panel_secondary_controller.js', <<~JS
           export { default } from "baldur/controllers/panel_secondary_controller"
         JS
       end

data/script/verify_host_install

@@ -1,24 +1,26 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-ENV["RAILS_ENV"] ||= "development"
+ENV['RAILS_ENV'] ||= 'development'
 
-require File.expand_path("../../../config/environment", __dir__)
+require File.expand_path('../../../config/environment', __dir__)
 
 def assert!(message)
   raise message unless yield
 end
 
 def tailwind_entrypoint
-  Rails.root.join("app/assets/tailwind/application.css")
+  Rails.root.join('app/assets/tailwind/application.css')
 end
 
-puts "Baldur host install smoke check"
+puts 'Baldur host install smoke check'
 puts "Rails root: #{Rails.root}"
 puts "Baldur root: #{Baldur::Engine.root}"
 
-assert!("Expected Baldur importmap path to be registered") do
-  Rails.application.config.importmap.paths.any? { |path| path.to_s.end_with?("/config/importmap.rb") && path.to_s.include?("/baldur/") }
+assert!('Expected Baldur importmap path to be registered') do
+  Rails.application.config.importmap.paths.any? do |path|
+    path.to_s.end_with?('/config/importmap.rb') && path.to_s.include?('/baldur/')
+  end
 end
 
 %w[
@@ -33,34 +35,34 @@ end
   assert!("Missing generated shim: #{relative_path}") { path.exist? }
 end
 
-assert!("Expected ui_button helper to be available") do
+assert!('Expected ui_button helper to be available') do
   ApplicationController.helpers.respond_to?(:ui_button)
 end
 
-button_html = ApplicationController.helpers.ui_button(label: "Verify", href: "/")
-assert!("ui_button did not render expected markup") do
-  button_html.include?("button") || button_html.include?("<a")
+button_html = ApplicationController.helpers.ui_button(label: 'Verify', href: '/')
+assert!('ui_button did not render expected markup') do
+  button_html.include?('button') || button_html.include?('<a')
 end
 
-modal_html = ApplicationController.helpers.ui_modal(id: "verify-modal", title: "Verify") { "Body".html_safe }
-assert!("ui_modal did not render expected markup") do
-  modal_html.include?("dialog") || modal_html.include?("modal")
+modal_html = ApplicationController.helpers.ui_modal(id: 'verify-modal', title: 'Verify') { 'Body'.html_safe }
+assert!('ui_modal did not render expected markup') do
+  modal_html.include?('dialog') || modal_html.include?('modal')
 end
-assert!("ui_modal did not render body content") do
-  modal_html.include?("Body")
+assert!('ui_modal did not render body content') do
+  modal_html.include?('Body')
 end
 
-card_html = ApplicationController.helpers.ui_card(title: "Verify", body: "Card body")
-assert!("ui_card did not render body content") do
-  card_html.include?("Card body")
+card_html = ApplicationController.helpers.ui_card(title: 'Verify', body: 'Card body')
+assert!('ui_card did not render body content') do
+  card_html.include?('Card body')
 end
 
 top_nav_html = ApplicationController.helpers.ui_marketing_top_nav(
-  links: [ { label: "Pricing", href: "/pricing", class: "nav-link" } ],
-  primary_action: { label: "Verify", href: "/", variant: :primary }
+  links: [{ label: 'Pricing', href: '/pricing', class: 'nav-link' }],
+  primary_action: { label: 'Verify', href: '/', variant: :primary }
 )
-assert!("ui_marketing_top_nav did not render expected markup") do
-  top_nav_html.include?("marketing-top-nav") && top_nav_html.include?("Pricing")
+assert!('ui_marketing_top_nav did not render expected markup') do
+  top_nav_html.include?('marketing-top-nav') && top_nav_html.include?('Pricing')
 end
 
 assert!("Expected Tailwind entrypoint at #{tailwind_entrypoint}") do
@@ -77,35 +79,61 @@ tailwind_source = tailwind_entrypoint.read
   assert!("Missing Tailwind integration line: #{line}") { tailwind_source.include?(line) }
 end
 
-host_fonts = Rails.root.join("app/assets/stylesheets/fonts.css")
+host_fonts = Rails.root.join('app/assets/stylesheets/fonts.css')
 assert!("Expected host font override scaffold at #{host_fonts}") do
   host_fonts.exist?
 end
 
-host_theme = Rails.root.join("app/assets/stylesheets/theme.css")
+host_theme = Rails.root.join('app/assets/stylesheets/theme.css')
 assert!("Expected host theme override scaffold at #{host_theme}") do
   host_theme.exist?
 end
 
-assert!("Expected host fonts import before Tailwind in the entrypoint") do
+assert!('Expected host fonts import before Tailwind in the entrypoint') do
   tailwind_source.index('@import "../stylesheets/fonts.css";') <
     tailwind_source.index('@import "tailwindcss";')
 end
 
-assert!("Expected host theme override import after the Baldur import") do
+assert!('Expected host theme override import after the Baldur import') do
   tailwind_source.index('@import "../builds/tailwind/baldur.css";') <
     tailwind_source.index('@import "../stylesheets/theme.css";')
 end
 
-assert!("Expected Tailwind entrypoint to stop hard-coding Geist font imports") do
+assert!('Expected Tailwind entrypoint to stop hard-coding Geist font imports') do
   !tailwind_source.include?('family=Geist:wght@100..900')
 end
 
+engine_css = Baldur::Engine.root.join('app/assets/tailwind/baldur/engine.css')
+if engine_css.exist?
+  engine_source = engine_css.read
+  %w[helpers views].each do |dir|
+    assert!("Expected @source for #{dir} with correct depth (../../../#{dir}) in engine.css") do
+      engine_source.include?("@source \"../../../#{dir}\"")
+    end
+  end
+end
+
 if ApplicationController.helpers.respond_to?(:ui_panel_secondary)
-  panel_html = ApplicationController.helpers.ui_panel_secondary(id: "verify-panel", title: "Panel", trigger_label: "Open") { "Body".html_safe }
-  assert!("ui_panel_secondary did not render expected markup") do
-    panel_html.include?("panel-secondary")
+  panel_html = ApplicationController.helpers.ui_panel_secondary(id: 'verify-panel', title: 'Panel',
+                                                                trigger_label: 'Open') do
+    'Body'.html_safe
+  end
+  assert!('ui_panel_secondary did not render expected markup') do
+    panel_html.include?('panel-secondary')
+  end
+end
+
+compiled_css_path = Rails.root.join('app/assets/builds/tailwind/application.css')
+if compiled_css_path.exist?
+  compiled_css = compiled_css_path.read
+  %w[px-6 py-4 uppercase tracking-wide font-semibold].each do |utility|
+    assert!("Expected Baldur utility .#{utility} in compiled CSS — engine @source paths may be misconfigured") do
+      compiled_css.include?(".#{utility}")
+    end
   end
+else
+  warn "WARNING: Compiled Tailwind CSS not found at #{compiled_css_path}; skipping utility-class checks."
+  warn 'Run `bundle exec rails tailwindcss:build` then re-run this check.'
 end
 
-puts "Smoke check passed"
+puts 'Smoke check passed'