rails_site_engine 0.6.2

data/app/helpers/rails_site_engine/application_helper.rb

@@ -0,0 +1,266 @@
+require "uri"
+
+module RailsSiteEngine
+  module ApplicationHelper
+    def site_language
+      I18n.locale.to_s
+    end
+
+    def site_name
+      site_config.dig("site", "name").to_s.strip.presence ||
+        branding_logo_text ||
+        "Website"
+    end
+
+    def branding_logo_text
+      site_config.dig("branding", "logo_text").to_s.strip.presence
+    end
+
+    def brand_label
+      branding_logo_text || site_name
+    end
+
+    def primary_nav_items
+      navigation_items_for("primary")
+    end
+
+    def footer_nav_items
+      navigation_items_for("footer")
+    end
+
+    def nav_link_options(item, data: nil)
+      options = {
+        class: ("menu-active" if item[:active]),
+        target: (item[:external] ? "_blank" : nil),
+        rel: (item[:external] ? "noopener noreferrer" : nil)
+      }.compact
+
+      options[:"aria-current"] = "page" if item[:active]
+      options[:data] = data if data.present?
+      options
+    end
+
+    def primary_cta
+      cta = site_config.dig("branding", "primary_cta")
+      return nil unless cta.is_a?(Hash)
+
+      label = cta["label"].to_s.strip
+      href = resolve_link_href(cta)
+      return nil if label.blank? || href.blank?
+
+      {
+        label: label,
+        href: href,
+        external: external_link?(href)
+      }
+    end
+
+    def contact_channels
+      {
+        phone: site_config.dig("contact", "phone").to_s.strip.presence,
+        email: site_config.dig("contact", "email").to_s.strip.presence
+      }.compact
+    end
+
+    def page_title
+      current_title = current_page&.title.to_s.strip.presence
+      default_title = seo_default_title
+
+      return default_title if current_title.blank?
+      return current_title if default_title.blank? || current_title == default_title
+
+      "#{current_title} | #{default_title}"
+    end
+
+    def page_description
+      current_page&.description.to_s.strip.presence ||
+        site_config.dig("seo", "default_description").to_s.strip.presence
+    end
+
+    def canonical_url
+      "#{request.base_url}#{request.path}"
+    end
+
+    def seo_meta_tags
+      tags = []
+
+      description = page_description
+      og_image = page_og_image
+
+      tags << tag.meta(name: "description", content: description) if description.present?
+      tags << tag.link(rel: "canonical", href: canonical_url)
+
+      tags << tag.meta(property: "og:title", content: page_title)
+      tags << tag.meta(property: "og:description", content: description) if description.present?
+      tags << tag.meta(property: "og:type", content: "website")
+      tags << tag.meta(property: "og:url", content: canonical_url)
+      tags << tag.meta(property: "og:image", content: og_image) if og_image.present?
+
+      tags << tag.meta(name: "twitter:card", content: og_image.present? ? "summary_large_image" : "summary")
+      tags << tag.meta(name: "twitter:title", content: current_page&.twitter_title.to_s.strip.presence || page_title)
+
+      twitter_description = current_page&.twitter_description.to_s.strip.presence || description
+      tags << tag.meta(name: "twitter:description", content: twitter_description) if twitter_description.present?
+      tags << tag.meta(name: "twitter:image", content: og_image) if og_image.present?
+
+      twitter_handle = site_config.dig("seo", "twitter_handle").to_s.strip.presence
+      tags << tag.meta(name: "twitter:site", content: twitter_handle) if twitter_handle.present?
+
+      safe_join(tags.compact, "\n")
+    end
+
+    def local_business_json_ld_tag
+      phone = site_config.dig("contact", "phone").to_s.strip.presence
+      email = site_config.dig("contact", "email").to_s.strip.presence
+      return nil if phone.blank? && email.blank?
+
+      json_ld = {
+        "@context" => "https://schema.org",
+        "@type" => "LocalBusiness",
+        "name" => site_name,
+        "url" => site_base_url || request.base_url
+      }
+
+      json_ld["telephone"] = phone if phone.present?
+      json_ld["email"] = email if email.present?
+
+      content_tag(
+        :script,
+        json_escape(json_ld.to_json).html_safe,
+        type: "application/ld+json"
+      )
+    end
+
+    def engine_stylesheet_link_tag
+      stylesheet_link_tag "rails_site_engine/engine"
+    end
+
+    def app_stylesheet_link_tag
+      return nil unless Rails.application.respond_to?(:assets) && Rails.application.assets&.respond_to?(:resolver)
+
+      candidates = {
+        "app.css" => "app",
+        "application.css" => "application"
+      }
+
+      logical_name = candidates.find { |asset_name, _| Rails.application.assets.resolver.resolve(asset_name).present? }&.last
+      return nil if logical_name.blank?
+
+      stylesheet_link_tag logical_name
+    end
+
+    def resolve_link_href(link_config)
+      return nil unless link_config.is_a?(Hash)
+
+      page_id = link_config["page"].to_s.strip.presence || link_config[:page].to_s.strip.presence
+      if page_id.present?
+        path = content_store.path_for_page(page_id)
+        return path if path.present?
+      end
+
+      link_config["href"].to_s.strip.presence || link_config[:href].to_s.strip.presence
+    end
+
+    def contact_page_path
+      content_store.path_for_page(content_store.contact_page_id) || "/contact"
+    end
+
+    def page_title_visible?(page = current_page)
+      page.present? && page.show_title && page.title.present?
+    end
+
+    def page_lead(page = current_page)
+      page&.lead.to_s.strip.presence
+    end
+
+    def section_heading_tag(section:, page:, index:)
+      section_type = section["type"].to_s.strip
+      return "h1" if section_type == "hero" && index.to_i.zero? && !page.show_title
+
+      "h2"
+    end
+
+    def render_section(section, page:, index:)
+      section = section.is_a?(Hash) ? section : {}
+      type = section["type"].to_s
+      partial = "rails_site_engine/sections/#{type}"
+      heading_tag = section_heading_tag(section: section, page: page, index: index)
+
+      render partial:, locals: { section: section, page: page, heading_tag: heading_tag }
+    rescue ActionView::MissingTemplate
+      Rails.logger.warn("rails_site_engine: unknown section type=#{type.inspect}")
+      return "".html_safe unless Rails.env.development?
+
+      render partial: "rails_site_engine/sections/unknown", locals: { section: section }
+    end
+
+    private
+
+    def navigation_items_for(key)
+      items = site_config.dig("navigation", key)
+      return [] unless items.is_a?(Array)
+
+      items.filter_map do |item|
+        next unless item.is_a?(Hash)
+
+        label = item["label"].to_s.strip
+        href = resolve_link_href(item)
+        next if label.blank? || href.blank?
+
+        {
+          label: label,
+          href: href,
+          active: active_path?(href),
+          external: external_link?(href)
+        }
+      end
+    end
+
+    def active_path?(href)
+      return false unless request
+
+      uri = URI.parse(href)
+      return false if uri.scheme.present? || uri.host.present?
+
+      path = uri.path.to_s.strip
+      return false if path.blank?
+      return request.path == "/" if path == "/"
+
+      request.path == path || request.path.start_with?("#{path}/")
+    rescue URI::InvalidURIError
+      false
+    end
+
+    def external_link?(href)
+      uri = URI.parse(href)
+      uri.scheme.present?
+    rescue URI::InvalidURIError
+      false
+    end
+
+    def site_base_url
+      site_config.dig("site", "base_url").to_s.strip.presence
+    end
+
+    def seo_default_title
+      site_config.dig("seo", "default_title").to_s.strip.presence || site_name
+    end
+
+    def page_og_image
+      image = current_page&.og_image.to_s.strip.presence ||
+        site_config.dig("seo", "default_og_image").to_s.strip.presence
+      return nil if image.blank?
+
+      absolute_url_for(image)
+    end
+
+    def absolute_url_for(url)
+      uri = URI.parse(url)
+      return url if uri.scheme.present?
+
+      "#{request.base_url}#{url.start_with?("/") ? url : "/#{url}"}"
+    rescue URI::InvalidURIError
+      nil
+    end
+  end
+end

data/app/javascript/controllers/rails_site_engine/color_mode_controller.js

@@ -0,0 +1,83 @@
+import { Controller } from "@hotwired/stimulus";
+
+export default class extends Controller {
+  static targets = ["darkIcon", "lightIcon", "toggleButton"];
+  static values = {
+    lightTheme: String,
+    darkTheme: String,
+  };
+
+  connect() {
+    if (!this.hasLightThemeValue || !this.hasDarkThemeValue) return;
+
+    this.currentMode = this.resolvedMode();
+    this.applyMode(this.currentMode);
+    this.syncIcons(this.currentMode);
+    this.syncToggleButton(this.currentMode);
+  }
+
+  toggle() {
+    const nextMode = this.currentMode === "dark" ? "light" : "dark";
+    this.setStoredMode(nextMode);
+    this.applyMode(nextMode);
+    this.syncIcons(nextMode);
+    this.syncToggleButton(nextMode);
+    this.currentMode = nextMode;
+  }
+
+  resolvedMode() {
+    return this.getStoredMode() || (this.prefersDark() ? "dark" : "light");
+  }
+
+  applyMode(mode) {
+    const theme = mode === "dark" ? this.darkThemeValue : this.lightThemeValue;
+    document.documentElement.setAttribute("data-theme", theme);
+    document.documentElement.style.colorScheme = mode === "dark" ? "dark" : "light";
+  }
+
+  syncIcons(mode) {
+    if (this.hasLightIconTarget) {
+      this.lightIconTarget.classList.toggle("hidden", mode === "dark");
+    }
+    if (this.hasDarkIconTarget) {
+      this.darkIconTarget.classList.toggle("hidden", mode !== "dark");
+    }
+  }
+
+  syncToggleButton(mode) {
+    if (!this.hasToggleButtonTarget) return;
+
+    const isDark = mode === "dark";
+    this.toggleButtonTarget.setAttribute("aria-pressed", String(isDark));
+    this.toggleButtonTarget.setAttribute(
+      "title",
+      isDark ? "Switch to light mode" : "Switch to dark mode",
+    );
+  }
+
+  prefersDark() {
+    return (
+      typeof window.matchMedia === "function" &&
+      window.matchMedia("(prefers-color-scheme: dark)").matches
+    );
+  }
+
+  storageKey() {
+    return "rse-color-mode";
+  }
+
+  getStoredMode() {
+    try {
+      const value = localStorage.getItem(this.storageKey());
+      return value === "light" || value === "dark" ? value : null;
+    } catch (_) {
+      return null;
+    }
+  }
+
+  setStoredMode(mode) {
+    try {
+      localStorage.setItem(this.storageKey(), mode);
+    } catch (_) {}
+  }
+}

data/app/javascript/controllers/rails_site_engine/form_submit_controller.js

@@ -0,0 +1,22 @@
+import { Controller } from "@hotwired/stimulus";
+
+export default class extends Controller {
+  static targets = ["submitButton", "submitText", "submittingText"];
+
+  submit() {
+    if (!this.hasSubmitButtonTarget || this.submitButtonTarget.disabled) return;
+
+    this.submitButtonTarget.disabled = true;
+    this.submitButtonTarget.classList.add("btn-disabled");
+    this.submitButtonTarget.setAttribute("aria-busy", "true");
+
+    if (this.hasSubmitTextTarget) {
+      this.submitTextTarget.classList.add("hidden");
+    }
+
+    if (this.hasSubmittingTextTarget) {
+      this.submittingTextTarget.classList.remove("hidden");
+      this.submittingTextTarget.classList.add("inline-flex");
+    }
+  }
+}

data/app/javascript/controllers/rails_site_engine/mobile_nav_controller.js

@@ -0,0 +1,45 @@
+import { Controller } from "@hotwired/stimulus";
+
+export default class extends Controller {
+  static targets = ["panel", "toggleButton"];
+
+  connect() {
+    this.close();
+  }
+
+  toggle() {
+    if (this.isOpen()) {
+      this.close();
+      return;
+    }
+
+    this.open();
+  }
+
+  open() {
+    if (!this.hasPanelTarget) return;
+
+    this.panelTarget.classList.remove("hidden");
+    document.body.classList.add("overflow-hidden");
+    this.setExpanded(true);
+  }
+
+  close() {
+    if (this.hasPanelTarget) {
+      this.panelTarget.classList.add("hidden");
+    }
+
+    document.body.classList.remove("overflow-hidden");
+    this.setExpanded(false);
+  }
+
+  isOpen() {
+    return this.hasPanelTarget && !this.panelTarget.classList.contains("hidden");
+  }
+
+  setExpanded(expanded) {
+    if (!this.hasToggleButtonTarget) return;
+
+    this.toggleButtonTarget.setAttribute("aria-expanded", String(expanded));
+  }
+}

data/app/javascript/rails_site_engine/application.js

@@ -0,0 +1,8 @@
+import { Application } from "@hotwired/stimulus";
+import { eagerLoadControllersFrom } from "@hotwired/stimulus-loading";
+
+const application = Application.start();
+application.debug = false;
+window.Stimulus = application;
+
+eagerLoadControllersFrom("rails_site_engine/controllers", application);

data/app/jobs/rails_site_engine/application_job.rb

@@ -0,0 +1,4 @@
+module RailsSiteEngine
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/mailers/rails_site_engine/application_mailer.rb

@@ -0,0 +1,6 @@
+module RailsSiteEngine
+  class ApplicationMailer < ::ActionMailer::Base
+    default from: -> { ENV.fetch("DEFAULT_FROM_EMAIL", "no-reply@example.com") }
+    layout "mailer"
+  end
+end

data/app/mailers/rails_site_engine/contact_mailer.rb

@@ -0,0 +1,25 @@
+module RailsSiteEngine
+  class ContactMailer < ApplicationMailer
+    def notify
+      contact_message = params.fetch(:contact_message)
+      site_config = params.fetch(:site_config, {})
+
+      recipient =
+        site_config.dig("contact", "recipient_email").to_s.strip.presence ||
+          ENV["CONTACT_RECIPIENT_EMAIL"].to_s.strip.presence
+      raise "Missing content/site.yml key: contact.recipient_email" if recipient.blank?
+
+      business_name = site_config.dig("site", "name").to_s.strip
+      subject = business_name.present? ? "New inquiry — #{business_name}" : "New inquiry"
+
+      @contact_message = contact_message
+      @site_config = site_config
+
+      mail(
+        to: recipient,
+        reply_to: @contact_message.email,
+        subject: subject
+      )
+    end
+  end
+end

data/app/models/rails_site_engine/application_record.rb

@@ -0,0 +1,5 @@
+module RailsSiteEngine
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/rails_site_engine/contact_message.rb

@@ -0,0 +1,16 @@
+module RailsSiteEngine
+  class ContactMessage
+    include ActiveModel::Model
+
+    attr_accessor :name, :email, :phone, :message, :website
+
+    validates :name, presence: true
+    validates :email, presence: true, format: { with: URI::MailTo::EMAIL_REGEXP }
+    validates :message, presence: true
+    validates :website, absence: true
+
+    def honeypot_triggered?
+      website.to_s.strip.present?
+    end
+  end
+end

data/app/views/layouts/mailer.html.erb

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+    <style>
+      /* Email styles need to be inline */
+    </style>
+  </head>
+
+  <body>
+    <%= yield %>
+  </body>
+</html>

data/app/views/layouts/mailer.text.erb

@@ -0,0 +1 @@
+<%= yield %>

data/app/views/layouts/rails_site_engine/application.html.erb

@@ -0,0 +1,54 @@
+<!DOCTYPE html>
+<html
+  lang="<%= site_language %>"
+  data-theme="<%= theme.daisyui_theme %>"
+  <% if theme.daisyui_dark_mode_enabled? %>
+    data-controller="rails-site-engine--color-mode"
+    data-rails-site-engine--color-mode-light-theme-value="<%= theme.daisyui_light_theme %>"
+    data-rails-site-engine--color-mode-dark-theme-value="<%= theme.daisyui_dark_theme %>"
+  <% end %>
+>
+  <head>
+    <title><%= page_title %></title>
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+
+    <%= seo_meta_tags %>
+    <%= local_business_json_ld_tag %>
+    <%= yield :head %>
+
+    <%= engine_stylesheet_link_tag %>
+    <%= app_stylesheet_link_tag %>
+    <%= javascript_importmap_tags "rails_site_engine/application" if respond_to?(:javascript_importmap_tags) %>
+  </head>
+
+  <body class="min-h-screen bg-base-100 text-base-content">
+    <a
+      href="#main-content"
+      class="sr-only fixed left-4 top-4 z-50 rounded-btn bg-base-content px-4 py-2 text-base-100 focus:not-sr-only"
+    >
+      <%= t("rails_site_engine.a11y.skip_to_main") %>
+    </a>
+
+    <header class="sticky top-0 z-40 border-b border-base-200 bg-base-100/95 backdrop-blur">
+      <%= render "rails_site_engine/shared/navbar" %>
+    </header>
+
+    <main id="main-content" class="mx-auto w-full max-w-6xl px-4 py-8 lg:py-10" tabindex="-1">
+      <%= render "rails_site_engine/shared/flash" %>
+      <%= yield %>
+    </main>
+
+    <%= render "rails_site_engine/shared/footer" %>
+
+    <% if (cta = primary_cta).present? %>
+      <div class="pointer-events-none fixed inset-x-0 bottom-4 z-40 px-4 lg:hidden">
+        <div class="pointer-events-auto mx-auto max-w-6xl">
+          <%= link_to cta[:label], cta[:href], class: "btn btn-primary btn-block shadow-lg", target: (cta[:external] ? "_blank" : nil), rel: (cta[:external] ? "noopener noreferrer" : nil) %>
+        </div>
+      </div>
+    <% end %>
+  </body>
+</html>

data/app/views/rails_site_engine/contact_mailer/notify.text.erb

@@ -0,0 +1,9 @@
+New inquiry
+
+Name: <%= @contact_message.name %>
+Email: <%= @contact_message.email %>
+Phone: <%= @contact_message.phone %>
+
+Message:
+<%= @contact_message.message %>
+

data/app/views/rails_site_engine/contacts/new.html.erb

@@ -0,0 +1 @@
+<%= render template: "rails_site_engine/pages/show" %>

data/app/views/rails_site_engine/pages/show.html.erb

@@ -0,0 +1,15 @@
+<% if page_title_visible?(current_page) || page_lead(current_page).present? %>
+  <header class="mb-10">
+    <% if page_title_visible?(current_page) %>
+      <h1 class="text-3xl font-bold tracking-tight sm:text-4xl"><%= current_page.title %></h1>
+    <% end %>
+
+    <% if page_lead(current_page).present? %>
+      <p class="mt-4 max-w-3xl text-lg text-base-content/80"><%= page_lead(current_page) %></p>
+    <% end %>
+  </header>
+<% end %>
+
+<% current_page.sections.each_with_index do |section, index| %>
+  <%= render_section(section, page: current_page, index: index) %>
+<% end %>