baldur 0.1.7 → 0.2.3

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/app/javascript/controllers/confirmation_controller.js

@@ -0,0 +1 @@
+export { default } from "baldur/controllers/confirmation_controller"

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.1.7
+  version: 0.2.3
 platform: ruby
 authors:
 - Varun Murkar
@@ -43,30 +43,31 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 8.1.0
+        version: 7.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 8.1.0
+        version: 7.0.0
 - !ruby/object:Gem::Dependency
   name: tailwindcss-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.4.0
+        version: 4.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.4.0
-description: Baldur packages reusable Rails view helpers, components, styles, and
-  Stimulus controllers.
+        version: 4.3.0
+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.
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -78,6 +79,7 @@ files:
 - TODO.md
 - app/assets/javascripts/baldur/controllers/accordion_controller.js
 - app/assets/javascripts/baldur/controllers/alert_controller.js
+- app/assets/javascripts/baldur/controllers/confirmation_controller.js
 - app/assets/javascripts/baldur/controllers/date_field_controller.js
 - app/assets/javascripts/baldur/controllers/details_menu_controller.js
 - app/assets/javascripts/baldur/controllers/form_submit_controller.js
@@ -111,6 +113,7 @@ files:
 - app/assets/stylesheets/baldur/application/components/card.css
 - app/assets/stylesheets/baldur/application/components/chart.css
 - app/assets/stylesheets/baldur/application/components/chip.css
+- app/assets/stylesheets/baldur/application/components/confirmation.css
 - app/assets/stylesheets/baldur/application/components/dialog.css
 - app/assets/stylesheets/baldur/application/components/forms.css
 - app/assets/stylesheets/baldur/application/components/layout.css
@@ -157,12 +160,14 @@ files:
 - app/views/baldur/components/_card.html.erb
 - app/views/baldur/components/_chart_card.html.erb
 - app/views/baldur/components/_checkbox.html.erb
+- app/views/baldur/components/_confirmation_modal.html.erb
 - app/views/baldur/components/_date_field.html.erb
 - app/views/baldur/components/_google_sign_in_button.html.erb
 - app/views/baldur/components/_kebab_menu.html.erb
 - app/views/baldur/components/_kpi.html.erb
 - app/views/baldur/components/_menu_select.html.erb
 - app/views/baldur/components/_modal.html.erb
+- app/views/baldur/components/_modal_host.html.erb
 - app/views/baldur/components/_pagination.html.erb
 - app/views/baldur/components/_segmented_buttons.html.erb
 - app/views/baldur/components/_settings_nav.html.erb
@@ -174,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
@@ -202,7 +208,10 @@ files:
 - lib/generators/baldur/install_panel_right/install_panel_right_generator.rb
 - lib/generators/baldur/install_panel_secondary/install_panel_secondary_generator.rb
 - 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
@@ -210,11 +219,13 @@ 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
 - test/tmp/install_generator/app/helpers/ui_helper.rb
 - test/tmp/install_generator/app/javascript/controllers/accordion_controller.js
+- test/tmp/install_generator/app/javascript/controllers/confirmation_controller.js
 - test/tmp/install_generator/app/javascript/controllers/date_field_controller.js
 - test/tmp/install_generator/app/javascript/controllers/details_menu_controller.js
 - test/tmp/install_generator/app/javascript/controllers/form_submit_controller.js
@@ -264,5 +275,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.6
 specification_version: 4
-summary: Reusable Rails UI engine for same-stack application interfaces
+summary: Batteries-included Rails UI engine for the importmap, Stimulus, Tailwind
+  stack
 test_files: []