baldur 0.2.0 → 0.2.4

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

@@ -1,9 +1,9 @@
-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
@@ -35,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
@@ -69,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
 
@@ -83,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
@@ -108,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'

data/test/confirmation_modal_helper_test.rb

@@ -1,10 +1,10 @@
-require_relative "test_helper"
-require "action_controller"
-require_relative "../lib/generators/baldur/install/install_generator"
+require_relative 'test_helper'
+require 'action_controller'
+require_relative '../lib/generators/baldur/install/install_generator'
 
 class BaldurConfirmationModalHelperTest < 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::RenderHelper
   end
@@ -24,7 +24,7 @@ class BaldurConfirmationModalHelperTest < Minitest::Test
     assert_includes html, 'data-modal-selector-value="#test-modal"'
     assert_includes html, 'data-modal="true"'
     assert_includes html, 'aria-hidden="true"'
-    assert_includes html, "Modal content"
+    assert_includes html, 'Modal content'
     assert_includes html, 'class="fixed inset-0 z-50'
   end
 
@@ -38,8 +38,8 @@ class BaldurConfirmationModalHelperTest < Minitest::Test
       formats: [:html]
     )
 
-    assert_includes html, "my-extra-class"
-    assert_includes html, "Custom"
+    assert_includes html, 'my-extra-class'
+    assert_includes html, 'Custom'
   end
 
   def test_ui_confirmation_modal_renders_basic_structure
@@ -57,9 +57,9 @@ class BaldurConfirmationModalHelperTest < Minitest::Test
     assert_includes html, 'id="delete-modal"'
     assert_includes html, 'id="delete-dialog"'
     assert_includes html, 'data-controller="modal"'
-    assert_includes html, "Delete item?"
-    assert_includes html, "Confirm"
-    assert_includes html, "Cancel"
+    assert_includes html, 'Delete item?'
+    assert_includes html, 'Confirm'
+    assert_includes html, 'Cancel'
     assert_includes html, 'data-modal-close="true"'
   end
 
@@ -76,8 +76,8 @@ class BaldurConfirmationModalHelperTest < Minitest::Test
       formats: [:html]
     )
 
-    assert_includes html, "color-error"
-    assert_includes html, "Discard collection?"
+    assert_includes html, 'color-error'
+    assert_includes html, 'Discard collection?'
   end
 
   def test_ui_confirmation_modal_default_tone_no_icon
@@ -92,8 +92,8 @@ class BaldurConfirmationModalHelperTest < Minitest::Test
       formats: [:html]
     )
 
-    refute_includes html, "color-error"
-    assert_includes html, "Proceed?"
+    refute_includes html, 'color-error'
+    assert_includes html, 'Proceed?'
   end
 
   def test_ui_confirmation_modal_danger_tone_sets_danger_button_variant
@@ -109,7 +109,7 @@ class BaldurConfirmationModalHelperTest < Minitest::Test
       formats: [:html]
     )
 
-    assert_includes html, "button--error"
+    assert_includes html, 'button--error'
   end
 
   def test_ui_confirmation_modal_default_tone_sets_primary_button_variant
@@ -124,8 +124,8 @@ class BaldurConfirmationModalHelperTest < Minitest::Test
       formats: [:html]
     )
 
-    assert_includes html, "button--filled"
-    refute_includes html, "button--error"
+    assert_includes html, 'button--filled'
+    refute_includes html, 'button--error'
   end
 
   def test_ui_confirmation_modal_with_type_to_confirm
@@ -149,15 +149,17 @@ class BaldurConfirmationModalHelperTest < Minitest::Test
       formats: [:html]
     )
 
-    assert_includes html, "modal confirmation"
-    assert_includes html, "confirmation-case-sensitive-value"
+    assert_includes html, 'modal confirmation'
+    assert_includes html, 'confirmation-case-sensitive-value'
     assert_includes html, 'data-confirmation-target="input"'
     assert_includes html, 'data-confirmation-target="submit"'
-    assert_includes html, "confirmation#validate"
-    assert_includes html, "Type confirm to continue"
-    assert_includes html, "This permanently removes all data."
-    assert_includes html, "Flush All Data"
-    assert_includes html, "Confirm"
+    assert_includes html, 'confirmation#validate'
+    assert_includes html, 'Type confirm to continue'
+    assert_includes html, 'This permanently removes all data.'
+    assert_includes html, 'Flush All Data'
+    assert_includes html, 'Confirm'
+    assert_includes html, 'field text-field'
+    assert_includes html, 'field__label'
   end
 
   def test_ui_confirmation_modal_type_to_confirm_disables_submit
@@ -176,8 +178,8 @@ class BaldurConfirmationModalHelperTest < Minitest::Test
       formats: [:html]
     )
 
-    assert_includes html, "disabled"
-    assert_includes html, "Type DELETE"
+    assert_includes html, 'disabled'
+    assert_includes html, 'Type DELETE'
   end
 
   def test_ui_confirmation_modal_type_to_confirm_case_insensitive
@@ -196,9 +198,9 @@ class BaldurConfirmationModalHelperTest < Minitest::Test
       formats: [:html]
     )
 
-    assert_includes html, "confirmation-case-sensitive-value"
-    refute_includes html, "case-sensitive-value=\"true\""
-    assert_includes html, "case-sensitive-value=&quot;false&quot;"
+    assert_includes html, 'confirmation-case-sensitive-value'
+    refute_includes html, 'case-sensitive-value="true"'
+    assert_includes html, 'case-sensitive-value=&quot;false&quot;'
   end
 
   def test_ui_confirmation_modal_without_type_to_confirm_has_no_confirmation_controller
@@ -214,7 +216,8 @@ class BaldurConfirmationModalHelperTest < Minitest::Test
     )
 
     assert_includes html, 'data-controller="modal"'
-    refute_includes html, "confirmation"
+    refute_includes html, 'confirmation'
+    refute_includes html, 'field text-field'
   end
 
   def test_ui_confirmation_modal_custom_labels
@@ -231,11 +234,11 @@ class BaldurConfirmationModalHelperTest < Minitest::Test
       formats: [:html]
     )
 
-    assert_includes html, "Discard"
-    assert_includes html, "Go back"
+    assert_includes html, 'Discard'
+    assert_includes html, 'Go back'
   end
 
   def test_install_generator_includes_confirmation_controller
-    assert_includes Baldur::Generators::InstallGenerator::CORE_CONTROLLERS, "confirmation"
+    assert_includes Baldur::Generators::InstallGenerator::CORE_CONTROLLERS, 'confirmation'
   end
-end
+end

data/test/csp_rendering_test.rb

@@ -1,22 +1,22 @@
-require_relative "test_helper"
+require_relative 'test_helper'
 
-require "action_controller"
+require 'action_controller'
 
 class BaldurCspRenderingTest < 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::UiHelperForms
   end
 
   def test_tooltip_renders_without_inline_style_attribute
     html = TestController.render(
-      partial: "baldur/components/tooltip",
+      partial: 'baldur/components/tooltip',
       locals: {
-        text: "Info",
-        content: "Tooltip body",
+        text: 'Info',
+        content: 'Tooltip body',
         show_icon: true,
-        icon: "circle-help",
+        icon: 'circle-help',
         variant: :link,
         wrapper_class: nil,
         trigger_class: nil,
@@ -31,26 +31,26 @@ class BaldurCspRenderingTest < Minitest::Test
 
   def test_date_field_renders_hidden_native_input_class_without_inline_style
     html = TestController.render(
-      partial: "baldur/components/date_field",
+      partial: 'baldur/components/date_field',
       locals: {
-        wrapper_classes: "field date-field",
-        label: "Due date",
+        wrapper_classes: 'field date-field',
+        label: 'Due date',
         supporting_text: nil,
         display_input_options: {
-          id: "due-date-display",
-          class: "text-field__control date-field__display",
-          type: "text",
-          name: "due_date"
+          id: 'due-date-display',
+          class: 'text-field__control date-field__display',
+          type: 'text',
+          name: 'due_date'
         },
         native_input_options: {
-          id: "due-date-native",
-          class: "date-field__native date-field__native--hidden",
-          type: "date",
-          tabindex: "-1"
+          id: 'due-date-native',
+          class: 'date-field__native date-field__native--hidden',
+          type: 'date',
+          tabindex: '-1'
         },
-        toggle_label: "Open date picker",
-        icon_name: "calendar",
-        support_id: "due-date-support"
+        toggle_label: 'Open date picker',
+        icon_name: 'calendar',
+        support_id: 'due-date-support'
       }
     )
 

data/test/engine_css_test.rb

@@ -0,0 +1,36 @@
+require_relative 'test_helper'
+
+class EngineCssTest < Minitest::Test
+  def engine_css_path
+    Baldur::Engine.root.join('app/assets/tailwind/baldur/engine.css')
+  end
+
+  def test_engine_css_exists
+    assert engine_css_path.exist?, "engine.css missing at #{engine_css_path}"
+  end
+
+  def test_source_paths_resolve_to_app_helpers_and_views
+    skip('engine.css not found') unless engine_css_path.exist?
+
+    source = engine_css_path.read
+
+    %w[helpers views].each do |dir|
+      assert_includes source, "@source \"../../../#{dir}\"",
+                      "engine.css @source for #{dir} must resolve from app/assets/tailwind/baldur/ → app/#{dir}\n" \
+                      "Expected: @source \"../../../#{dir}\"\n" \
+                      "Got: check #{engine_css_path}"
+    end
+  end
+
+  def test_source_paths_do_not_use_shallow_relative
+    skip('engine.css not found') unless engine_css_path.exist?
+
+    source = engine_css_path.read
+
+    %w[helpers views].each do |dir|
+      refute_includes source, "@source \"../../#{dir}\"",
+                      "engine.css uses shallow @source \"../../#{dir}\" which resolves to app/assets/tailwind/#{dir} (nonexistent)\n" \
+                      "Must use \"../../../#{dir}\" to reach app/#{dir}"
+    end
+  end
+end

data/test/fixtures/shared/_brand_lockup.html.erb

@@ -0,0 +1 @@
+<div class="brand-lockup"><span>Brand</span></div>