baldur 0.2.0 → 0.2.3

data/test/install_panel_secondary_generator_test.rb

@@ -1,21 +1,24 @@
-require_relative "test_helper"
-require_relative "../lib/generators/baldur/install_panel_secondary/install_panel_secondary_generator"
+require_relative 'test_helper'
+require_relative '../lib/generators/baldur/install_panel_secondary/install_panel_secondary_generator'
 
 class BaldurInstallPanelSecondaryGeneratorTest < Rails::Generators::TestCase
   tests Baldur::Generators::InstallPanelSecondaryGenerator
-  destination File.expand_path("tmp/install_panel_secondary_generator", __dir__)
+  destination File.expand_path('tmp/install_panel_secondary_generator', __dir__)
   setup :prepare_destination
 
   setup do
-    FileUtils.mkdir_p File.join(destination_root, "app/assets/tailwind")
-    File.write(File.join(destination_root, "app/assets/tailwind/application.css"), "@import \"tailwindcss\";\n@import \"../builds/tailwind/baldur.css\";\n")
+    FileUtils.mkdir_p File.join(destination_root, 'app/assets/tailwind')
+    File.write(File.join(destination_root, 'app/assets/tailwind/application.css'),
+               "@import \"tailwindcss\";\n@import \"../builds/tailwind/baldur.css\";\n")
   end
 
-  test "adds helper and controller without touching the tailwind contract" do
+  test 'adds helper and controller without touching the tailwind contract' do
     run_generator
 
-    assert_file "app/helpers/panel_secondary_helper.rb", /include Baldur::Optional::PanelSecondaryHelper/
-    assert_file "app/javascript/controllers/panel_secondary_controller.js", /export \{ default \} from "baldur\/controllers\/panel_secondary_controller"/
-    assert_equal "@import \"tailwindcss\";\n@import \"../builds/tailwind/baldur.css\";\n", File.read(File.join(destination_root, "app/assets/tailwind/application.css"))
+    assert_file 'app/helpers/panel_secondary_helper.rb', /include Baldur::Optional::PanelSecondaryHelper/
+    assert_file 'app/javascript/controllers/panel_secondary_controller.js',
+                %r{export \{ default \} from "baldur/controllers/panel_secondary_controller"}
+    assert_equal "@import \"tailwindcss\";\n@import \"../builds/tailwind/baldur.css\";\n",
+                 File.read(File.join(destination_root, 'app/assets/tailwind/application.css'))
   end
 end

data/test/marketing_helper_test.rb

@@ -1,4 +1,4 @@
-require_relative "test_helper"
+require_relative 'test_helper'
 
 class BaldurMarketingHelperTest < Minitest::Test
   HelperHost = Struct.new(:config) do
@@ -15,17 +15,17 @@ class BaldurMarketingHelperTest < Minitest::Test
 
   def test_uses_configured_brand_without_host_helper_fallback
     Baldur.config.marketing_brand = {
-      name: "Standalone",
-      wordmark: "Standalone UI",
-      logo_src: "/standalone-logo.svg"
+      name: 'Standalone',
+      wordmark: 'Standalone UI',
+      logo_src: '/standalone-logo.svg'
     }
 
     helper = HelperHost.new(Baldur.config)
     resolved = helper.send(:ui_marketing_configured_brand)
 
-    assert_equal "Standalone", resolved[:name]
-    assert_equal "Standalone UI", resolved[:wordmark]
-    assert_equal "/standalone-logo.svg", resolved[:logo_src]
+    assert_equal 'Standalone', resolved[:name]
+    assert_equal 'Standalone UI', resolved[:wordmark]
+    assert_equal '/standalone-logo.svg', resolved[:logo_src]
   end
 
   def test_returns_empty_brand_hash_when_no_brand_is_configured

data/test/run_all.rb

@@ -1,3 +1,3 @@
-Dir[File.expand_path("*_test.rb", __dir__)].sort.each do |path|
+Dir[File.expand_path('*_test.rb', __dir__)].sort.each do |path|
   require path
 end

data/test/sidebar_helper_test.rb

@@ -1,10 +1,10 @@
-require_relative "test_helper"
+require_relative 'test_helper'
 
-require "action_controller"
+require 'action_controller'
 
 class BaldurSidebarHelperTest < Minitest::Test
   class TestController < ActionController::Base
-    append_view_path File.expand_path("../app/views", __dir__)
+    append_view_path File.expand_path('../app/views', __dir__)
     helper Baldur::UiHelper
     helper Baldur::UiHelperSidebar
   end
@@ -12,10 +12,10 @@ class BaldurSidebarHelperTest < Minitest::Test
   def setup
     @original_brand = Baldur.config.marketing_brand
     Baldur.config.marketing_brand = {
-      name: "Acme",
-      wordmark: "Acme Ops",
-      logo_src: "/acme.svg",
-      logo_alt: "Acme logo"
+      name: 'Acme',
+      wordmark: 'Acme Ops',
+      logo_src: '/acme.svg',
+      logo_alt: 'Acme logo'
     }
   end
 
@@ -33,16 +33,16 @@ class BaldurSidebarHelperTest < Minitest::Test
               secondary_label: "Admin"
             ) %>
       ERB
-      formats: [ :html ]
+      formats: [:html]
     )
 
     assert_includes html, 'data-controller="sidebar"'
     assert_includes html, 'data-controller="mobile-sidebar"'
-    assert_includes html, "Acme Ops"
+    assert_includes html, 'Acme Ops'
     assert_includes html, 'href="/dashboard"'
     assert_includes html, 'href="/settings"'
     assert_includes html, 'aria-current="page"'
-    assert_includes html, "Admin"
+    assert_includes html, 'Admin'
   end
 
   def test_sidebar_renders_slot_content_and_mobile_fallbacks
@@ -57,13 +57,13 @@ class BaldurSidebarHelperTest < Minitest::Test
           <% end %>
         <% end %>
       ERB
-      formats: [ :html ]
+      formats: [:html]
     )
 
-    assert_includes html, "Tenant Switcher"
-    assert_includes html, "user-menu"
-    assert_includes html, "Sign out"
-    assert_operator html.scan("Tenant Switcher").size, :>=, 2
-    assert_operator html.scan("Sign out").size, :>=, 2
+    assert_includes html, 'Tenant Switcher'
+    assert_includes html, 'user-menu'
+    assert_includes html, 'Sign out'
+    assert_operator html.scan('Tenant Switcher').size, :>=, 2
+    assert_operator html.scan('Sign out').size, :>=, 2
   end
 end

data/test/test_helper.rb

@@ -1,16 +1,16 @@
-ENV["MT_NO_PLUGINS"] = "1"
+ENV['MT_NO_PLUGINS'] = '1'
 
-require "bundler/setup"
-require "minitest/autorun"
-require "rails/generators/test_case"
-require "rails"
-require "lucide-rails"
+require 'bundler/setup'
+require 'minitest/autorun'
+require 'rails/generators/test_case'
+require 'rails'
+require 'lucide-rails'
 
-require_relative "../lib/baldur"
-require_relative "../app/helpers/baldur/render_helper"
-require_relative "../app/helpers/baldur/ui_helper_feedback"
-require_relative "../app/helpers/baldur/ui_helper_unavailable"
-require_relative "../app/helpers/baldur/ui_helper_forms"
-require_relative "../app/helpers/baldur/marketing_helper"
-require_relative "../app/helpers/baldur/ui_helper_sidebar"
-require_relative "../app/helpers/baldur/ui_helper"
+require_relative '../lib/baldur'
+require_relative '../app/helpers/baldur/render_helper'
+require_relative '../app/helpers/baldur/ui_helper_feedback'
+require_relative '../app/helpers/baldur/ui_helper_unavailable'
+require_relative '../app/helpers/baldur/ui_helper_forms'
+require_relative '../app/helpers/baldur/marketing_helper'
+require_relative '../app/helpers/baldur/ui_helper_sidebar'
+require_relative '../app/helpers/baldur/ui_helper'

data/test/theme_toggle_helper_test.rb

@@ -0,0 +1,119 @@
+require_relative 'test_helper'
+require_relative '../app/helpers/baldur/optional/auth_page_helper'
+
+require 'action_controller'
+
+class BaldurThemeToggleHelperTest < Minitest::Test
+  class TestController < ActionController::Base
+    append_view_path File.expand_path('../app/views', __dir__)
+    helper Baldur::UiHelper
+    helper Baldur::RenderHelper
+  end
+
+  def test_ui_theme_toggle_renders_switch_markup
+    html = TestController.render(
+      inline: '<%= ui_theme_toggle %>',
+      formats: [:html]
+    )
+
+    assert_includes html, 'class="switch theme-toggle"'
+    assert_includes html, 'data-theme-target="toggle"'
+    assert_includes html, 'data-theme-toggle'
+    assert_includes html, 'aria-label="Toggle theme"'
+  end
+
+  def test_ui_theme_toggle_renders_compact_button
+    html = TestController.render(
+      inline: '<%= ui_theme_toggle %>',
+      formats: [:html]
+    )
+
+    assert_includes html, 'data-action="click->theme#toggle"'
+    assert_includes html, 'theme-toggle__compact'
+  end
+
+  def test_ui_theme_toggle_custom_aria_label
+    html = TestController.render(
+      inline: '<%= ui_theme_toggle(aria_label: "Switch appearance") %>',
+      formats: [:html]
+    )
+
+    assert_includes html, 'aria-label="Switch appearance"'
+    refute_includes html, 'aria-label="Toggle theme"'
+  end
+
+  def test_ui_theme_toggle_custom_classes
+    html = TestController.render(
+      inline: '<%= ui_theme_toggle(classes: "my-extra") %>',
+      formats: [:html]
+    )
+
+    assert_includes html, 'my-extra'
+    assert_includes html, 'switch theme-toggle'
+  end
+
+  def test_ui_theme_toggle_renders_sun_and_moon_icons
+    html = TestController.render(
+      inline: '<%= ui_theme_toggle %>',
+      formats: [:html]
+    )
+
+    assert_includes html, 'switch__icon--sun'
+    assert_includes html, 'switch__icon--moon'
+    assert_includes html, 'theme-toggle__compact-icon--sun'
+    assert_includes html, 'theme-toggle__compact-icon--moon'
+  end
+end
+
+class BaldurAuthPageTopRailTest < Minitest::Test
+  FIXTURE_VIEWS = File.expand_path('fixtures', __dir__)
+
+  class TestController < ActionController::Base
+    append_view_path File.expand_path('../app/views', __dir__)
+    append_view_path FIXTURE_VIEWS
+    helper Baldur::UiHelper
+    helper Baldur::Optional::AuthPageHelper
+  end
+
+  def test_auth_page_without_top_rail_omits_element
+    html = TestController.render(
+      inline: <<~ERB,
+        <%= ui_auth_page(title: "Sign in", description: nil) do %>
+          <p>Form here</p>
+        <% end %>
+      ERB
+      formats: [:html]
+    )
+
+    refute_includes html, 'auth-page__top-rail'
+  end
+
+  def test_auth_page_with_top_rail_renders_slot
+    html = TestController.render(
+      inline: <<~ERB,
+        <%= ui_auth_page(title: "Sign in", description: nil, top_rail: "<span>Version 1.0</span>".html_safe) do %>
+          <p>Form here</p>
+        <% end %>
+      ERB
+      formats: [:html]
+    )
+
+    assert_includes html, 'auth-page__top-rail'
+    assert_includes html, 'Version 1.0'
+  end
+
+  def test_auth_page_top_rail_with_theme_toggle
+    html = TestController.render(
+      inline: <<~ERB,
+        <%= ui_auth_page(title: "Sign in", description: nil, top_rail: ui_theme_toggle) do %>
+          <p>Form here</p>
+        <% end %>
+      ERB
+      formats: [:html]
+    )
+
+    assert_includes html, 'auth-page__top-rail'
+    assert_includes html, 'data-theme-target="toggle"'
+    assert_includes html, 'data-action="click->theme#toggle"'
+  end
+end

data/test/tmp/install_generator/app/assets/stylesheets/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/test/tmp/install_generator/config/initializers/baldur.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.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: baldur
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.3
 platform: ruby
 authors:
 - Varun Murkar
@@ -179,6 +179,7 @@ files:
 - app/views/baldur/components/_table_card.html.erb
 - app/views/baldur/components/_table_footer.html.erb
 - app/views/baldur/components/_text_field.html.erb
+- app/views/baldur/components/_theme_toggle.html.erb
 - app/views/baldur/components/_tooltip.html.erb
 - app/views/baldur/marketing/_cta_banner.html.erb
 - app/views/baldur/marketing/_faq_section.html.erb
@@ -209,6 +210,8 @@ files:
 - script/verify_host_install
 - test/confirmation_modal_helper_test.rb
 - test/csp_rendering_test.rb
+- test/engine_css_test.rb
+- test/fixtures/shared/_brand_lockup.html.erb
 - test/gemspec_test.rb
 - test/install_generator_test.rb
 - test/install_panel_secondary_generator_test.rb
@@ -216,6 +219,7 @@ files:
 - test/run_all.rb
 - test/sidebar_helper_test.rb
 - test/test_helper.rb
+- test/theme_toggle_helper_test.rb
 - test/tmp/install_generator/app/assets/stylesheets/fonts.css
 - test/tmp/install_generator/app/assets/stylesheets/theme.css
 - test/tmp/install_generator/app/assets/tailwind/application.css