b4um_generators 0.1.0 → 0.2.7

data/lib/generators/b4um/help/help_generator.rb

@@ -32,6 +32,7 @@ module B4um
 
             - bcrypt for password support
             - Active Storage for image attachments
+            - Home page with root route
             - Hero section
             - Footer
             - Footer sitemap
@@ -46,6 +47,38 @@ module B4um
           b4um installs Active Storage and runs the database migration.
 
 
+          HOME PAGE
+
+          The installer can optionally create a home page.
+
+          During installation, b4um asks:
+
+            Create a home page? (y/n)
+
+          When selected, the controller and action can be configured:
+
+            Home controller [Pages]:
+            Home action [home]:
+
+          Press Enter to use the defaults.
+
+          With the default configuration, b4um creates:
+
+            app/controllers/pages_controller.rb
+            app/views/pages/home.html.erb
+
+          and adds:
+
+            root "pages#home"
+
+          A Home link using root_path is also added to the
+          b4um navigation.
+
+          If the application already has a root route, b4um keeps
+          the existing root route and does not add a new Home
+          navigation link.
+
+
           HERO
 
           The installer can add an optional hero section.
@@ -357,10 +390,10 @@ module B4um
 
           READABLE URL PARAMETERS
 
-          b4um scaffolds can generate readable URLs while keeping
+          b4um can generate readable URLs while keeping
           the database ID in the URL.
 
-          Use:
+          When creating a new scaffold, use:
 
             --param=ATTRIBUTE
 
@@ -368,15 +401,26 @@ module B4um
 
             bin/rails generate b4um:scaffold Article title:string body:text --param=title
 
-          This generates:
+          For an existing model, readable URLs can also be
+          added later with:
+
+            bin/rails generate b4um:readable MODEL ATTRIBUTE
+
+          Example:
+
+            bin/rails generate b4um:readable Product name
+
+          Both variants add a to_param method to the model.
+
+          Example:
 
             def to_param
-              "\#{id} \#{title}".parameterize
+              "\#{id} \#{name}".parameterize
             end
 
           Example URL:
 
-            /articles/17-my-first-article
+            /products/17-macbook-air
 
           The ID remains part of the URL, so the standard Rails
           resource lookup can still be used.
@@ -384,6 +428,14 @@ module B4um
           The readable part of the URL is updated automatically
           when the selected attribute changes.
 
+          The b4um:readable generator requires:
+
+            - An existing model
+            - An existing model attribute
+            - No existing custom to_param method
+
+          Existing to_param methods are not overwritten.
+
 
           PASSWORDS
 
@@ -408,6 +460,113 @@ module B4um
           the selected Gem automatically.
 
 
+          AUTHENTICATION
+
+            bin/rails generate b4um:authentication MODEL
+
+          Adds session-based authentication for an existing model.
+
+          Example:
+
+            bin/rails generate b4um:authentication User
+
+          The authentication model can have any name, for example:
+
+            User
+            Admin
+            Member
+
+          The selected model must:
+
+            - Already exist
+            - Use has_secure_password
+            - Have a password_digest column
+            - Use bcrypt
+
+          Authentication uses an email attribute for login.
+
+          Example:
+
+            bin/rails generate b4um:scaffold User name:string email:string password_digest:string
+            bin/rails generate b4um:authentication User
+
+          The authentication generator adds:
+
+            - Sessions controller
+            - Login form
+            - Login and logout routes
+            - Session-based current account helper
+            - logged_in? helper
+            - require_login helper
+            - Login and logout navigation controls
+
+          The generated helper name follows the selected model.
+
+          For User:
+
+            current_user
+
+          For Admin:
+
+            current_admin
+
+          Existing controllers can optionally be protected with --protect.
+
+          Example:
+
+            bin/rails generate b4um:authentication User --protect=Products
+
+          Multiple controllers can be protected in one run:
+
+            bin/rails generate b4um:authentication User --protect=Products,Articles,Comments
+
+          Protected controllers receive:
+
+            before_action :require_login, except: [:index, :show]
+
+          This keeps index and show publicly accessible while requiring
+          authentication for actions such as new, create, edit, update
+          and destroy.
+
+          For protected b4um resources, authentication also updates
+          the generated interface for logged-out visitors.
+
+          On index pages:
+
+            - New is hidden
+
+          On show pages:
+
+            - Edit is hidden
+            - Destroy is hidden
+            - Back remains visible
+
+          These controls remain available to logged-in users.
+          The controller protection remains the security boundary;
+          hiding the controls only keeps the public interface consistent.
+
+          Additional controllers can be protected later by running the
+          authentication generator again.
+
+          Example:
+
+            bin/rails generate b4um:authentication User --protect=Comments
+
+          Existing authentication helpers, routes and navigation controls
+          are not duplicated on repeated runs.
+
+          All controllers passed to --protect must already exist.
+          If a protected controller cannot be found, the generator stops
+          before changing the application.
+
+          The generator validates its requirements before changing
+          the application and reports missing authentication setup
+          with a suggested b4um scaffold command.
+
+          Repeated generator runs do not duplicate the authentication
+          helpers, routes or navigation controls.
+
+
           ACTIVE STORAGE / IMAGES
 
           Image attachments require Active Storage.
@@ -436,6 +595,52 @@ module B4um
 
             bin/rails generate b4um:scaffold Gallery title:string images:attachments
 
+          Attachments can also be added later to an existing
+          b4um resource.
+
+          Single attachment:
+
+            bin/rails generate b4um:attachment MODEL ATTACHMENT
+
+          Example:
+
+            bin/rails generate b4um:attachment Admin avatar
+
+          This adds:
+
+            has_one_attached :avatar
+
+          Multiple attachments:
+
+            bin/rails generate b4um:attachment MODEL ATTACHMENT --multiple
+
+          Example:
+
+            bin/rails generate b4um:attachment Product images --multiple
+
+          This adds:
+
+            has_many_attached :images
+
+          When the corresponding b4um files exist, the attachment
+          generator also updates:
+
+            - The existing model
+            - The existing b4um form
+            - The controller parameters
+            - The existing b4um resource partial
+
+          Multiple attachments additionally support:
+
+            - Adding new images without replacing existing images
+            - Removing individual existing images
+            - Multiple image preview
+            - Image gallery with lightbox navigation
+
+          Repeated generator runs do not duplicate existing
+          attachment setup.
+
+
           Image features:
 
             - Active Storage integration

data/lib/generators/b4um/infinite_scroll/infinite_scroll_generator.rb

@@ -121,6 +121,37 @@ module B4um
         )
       end
 
+      def update_table_partial
+        index_content = File.read(
+          File.join(destination_root, index_view_path)
+        )
+
+        return unless index_content.match?(
+          /render\s+["']table["']/
+        )
+
+        path = File.join(
+          "app/views",
+          file_name.pluralize,
+          "_table.html.erb"
+        )
+
+        full_path = File.join(destination_root, path)
+
+        return unless File.exist?(full_path)
+
+        content = File.read(full_path)
+
+        return if content.include?(%(<tbody id="#{plural_table_name}">))
+        return unless content.include?("<tbody>")
+
+        gsub_file(
+          path,
+          "<tbody>",
+          %(<tbody id="#{plural_table_name}">)
+        )
+      end
+
       private
 
       def paginated_collection

data/lib/generators/b4um/infinite_scroll/templates/infinite_scroll_controller.js

@@ -7,21 +7,32 @@ export default class extends Controller {
   }
 
   connect() {
-    this.observer = new IntersectionObserver((entries) => {
-      if (entries.some((entry) => entry.isIntersecting)) {
-        this.loadMore()
-      }
-    })
+    this.loading = false
+    this.check = this.check.bind(this)
+
+    window.addEventListener('scroll', this.check, { passive: true })
+    window.addEventListener('resize', this.check)
 
-    this.observer.observe(this.element)
+    this.check()
   }
 
   disconnect() {
-    this.observer?.disconnect()
+    window.removeEventListener('scroll', this.check)
+    window.removeEventListener('resize', this.check)
+  }
+
+  check() {
+    if (!this.hasNextUrlValue || !this.nextUrlValue || this.loading) return
+
+    const rect = this.element.getBoundingClientRect()
+
+    if (rect.top <= window.innerHeight + 300) {
+      this.loadMore()
+    }
   }
 
   async loadMore() {
-    if (!this.hasNextUrlValue || this.loading) return
+    if (!this.hasNextUrlValue || !this.nextUrlValue || this.loading) return
 
     this.loading = true
 
@@ -51,7 +62,6 @@ export default class extends Controller {
       if (nextSentinel?.dataset.infiniteScrollNextUrlValue) {
         this.nextUrlValue = nextSentinel.dataset.infiniteScrollNextUrlValue
       } else {
-        this.observer.disconnect()
         this.element.remove()
       }
     } finally {

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

@@ -71,6 +71,104 @@ module B4um
         say "  Active Storage database tables created."
       end
 
+      def install_home_page
+        unless yes?("Create a home page? (y/n)")
+          say "  Home page skipped."
+          return
+        end
+
+        @home_controller = ask(
+          "Home controller [Pages]:"
+        ).presence || "Pages"
+
+        @home_action = ask(
+          "Home action [home]:"
+        ).presence || "home"
+
+        controller_name = @home_controller.underscore
+        action_name = @home_action.underscore
+
+        controller_path = File.join(
+          "app/controllers",
+          "#{controller_name}_controller.rb"
+        )
+
+        view_path = File.join(
+          "app/views",
+          controller_name,
+          "#{action_name}.html.erb"
+        )
+
+        full_controller_path = File.join(
+          destination_root,
+          controller_path
+        )
+
+        full_view_path = File.join(
+          destination_root,
+          view_path
+        )
+
+        unless File.exist?(full_controller_path)
+          create_file(
+            controller_path,
+            <<~RUBY
+              class #{@home_controller.camelize}Controller < ApplicationController
+                def #{action_name}
+                end
+              end
+            RUBY
+          )
+        end
+
+        unless File.exist?(full_view_path)
+          create_file(
+            view_path,
+            <<~ERB
+              <% content_for :title, "#{action_name.humanize}" %>
+
+              <div class="page-header">
+                <h1>#{action_name.humanize}</h1>
+              </div>
+
+              <div class="b4um-grid">
+                <section class="b4um-card b4um-card--full">
+                  <h2 class="b4um-card__title">
+                    #{action_name.humanize}
+                  </h2>
+
+                  <p class="b4um-card__text">
+                    Add your content here.
+                  </p>
+                </section>
+              </div>
+            ERB
+          )
+        end
+
+        routes_path = File.join(
+          destination_root,
+          "config/routes.rb"
+        )
+
+        routes = File.read(routes_path)
+
+        if routes.match?(/^\s*root\b/)
+          say "  Root route already exists; keeping existing root route."
+          @home_navigation_enabled = false
+        else
+          route(
+            %(root "#{controller_name}##{action_name}")
+          )
+
+          @home_navigation_enabled = true
+        end
+
+        @home_page_installed = true
+
+        say "  Home page installed."
+      end
+
       def create_stylesheet
         copy_file "b4um.css", "app/assets/stylesheets/b4um.css"
 
@@ -190,8 +288,49 @@ module B4um
       end
 
       def copy_navigation
+        navigation_path = "app/views/shared/_navigation.html.erb"
+
         copy_file "_navigation.html.erb",
-                  "app/views/shared/_navigation.html.erb"
+                  navigation_path
+
+        return unless @home_page_installed
+        return unless @home_navigation_enabled
+
+        full_navigation_path = File.join(
+          destination_root,
+          navigation_path
+        )
+
+        navigation = File.read(full_navigation_path)
+        marker = "<%# B4UM_NAVIGATION_LINKS %>"
+
+        return unless navigation.include?(marker)
+
+        controller_name = @home_controller.underscore
+        action_name = @home_action.underscore
+
+        return if navigation.include?("root_path")
+
+        indented_marker = "      #{marker}"
+
+        home_link = <<~ERB.chomp
+          <%= navigation_link_to "#{action_name.humanize}",
+                                 root_path,
+                                 controller: :#{controller_name},
+                                 action: :#{action_name} %>
+
+          #{marker}
+        ERB
+
+        indented_home_link = home_link.lines.map do |line|
+          line.strip.empty? ? line : "      #{line}"
+        end.join
+
+        gsub_file(
+          navigation_path,
+          indented_marker,
+          indented_home_link
+        )
       end
 
       def copy_navigation_controller
@@ -366,7 +505,7 @@ module B4um
           '<main class="container">',
           <<~ERB.chomp
             <main class="container">
-                  <%= render "shared/hero" if request.path == root_path %>
+                  <%= render "shared/hero" if respond_to?(:root_path) && request.path == root_path %>
           ERB
         )
       end

data/lib/generators/b4um/install/templates/b4um/forms.css

@@ -417,12 +417,20 @@
 
 .form-field--rich-text {
   display: grid;
-  grid-template-columns: 1fr;
+  grid-template-columns: minmax(0, 1fr);
+
+  width: 100%;
+  min-width: 0;
+  max-width: 100%;
 }
 
 .form-field--rich-text trix-toolbar {
   grid-row: 1;
 
+  width: 100%;
+  min-width: 0;
+  max-width: 100%;
+
   position: sticky;
   top: 61px;
   z-index: 10;
@@ -496,6 +504,15 @@
   color: var(--b4um-text);
 }
 
+.form-field--rich-text .form-textarea,
+.form-field--rich-text trix-editor {
+  width: 100%;
+  min-width: 0;
+  max-width: 100%;
+
+  box-sizing: border-box;
+}
+
 .form-field--rich-text .form-textarea {
   grid-row: 2;
 }
@@ -686,6 +703,18 @@
   border-radius: var(--b4um-radius);
 }
 
+/* -------------------------------------------------------
+   Rich Text Attachments – responsive
+------------------------------------------------------- */
+
+@media (max-width: 700px) {
+  .trix-content .attachment-gallery,
+  .trix-content .attachment-gallery--2,
+  .trix-content .attachment-gallery--4 {
+    grid-template-columns: 1fr;
+  }
+}
+
 .trix-content action-text-attachment[content-type='vnd.rubyonrails.horizontal-rule.html'] {
   display: block;
   width: 100%;
@@ -922,3 +951,134 @@
 
   opacity: 1;
 }
+/* -------------------------------------------------------
+   Responsive Rich Text
+------------------------------------------------------- */
+
+@media (max-width: 640px) {
+  .form-field--rich-text trix-toolbar {
+    overflow: visible;
+  }
+
+  /*
+   * Nur die Button-Zeile scrollt horizontal.
+   * Die Dialoge liegen außerhalb dieses Scrollcontainers
+   * und können deshalb vollständig sichtbar werden.
+   */
+  .form-field--rich-text trix-toolbar .trix-button-row {
+    display: flex;
+    flex-wrap: nowrap;
+    align-items: center;
+    justify-content: flex-start;
+
+    width: 100%;
+    max-width: 100%;
+
+    gap: 4px;
+
+    overflow-x: auto;
+    overflow-y: hidden;
+
+    -webkit-overflow-scrolling: touch;
+    scrollbar-width: none;
+  }
+
+  .form-field--rich-text trix-toolbar .trix-button-row::-webkit-scrollbar {
+    display: none;
+  }
+
+  .form-field--rich-text trix-toolbar .trix-button-group {
+    flex: 0 0 auto;
+
+    margin: 0;
+  }
+
+  .form-field--rich-text trix-toolbar .trix-button {
+    flex: 0 0 auto;
+
+    margin: 0;
+  }
+
+  /*
+   * Trix-Dialoge gehören NICHT zum horizontalen
+   * Scrollbereich der Buttons.
+   */
+  .form-field--rich-text trix-toolbar .trix-dialogs {
+    position: relative;
+
+    width: 100%;
+
+    overflow: visible;
+  }
+
+  .form-field--rich-text trix-toolbar .trix-dialog {
+    left: 0;
+    right: auto;
+
+    max-width: 100%;
+
+    box-sizing: border-box;
+  }
+
+  /*
+   * Link-Dialog nutzt auf kleinen Displays
+   * die komplette verfügbare Toolbarbreite.
+   */
+  .form-field--rich-text trix-toolbar .trix-dialog--link {
+    width: 100%;
+  }
+
+  /*
+   * H1–H6 bleiben kompakt nebeneinander.
+   */
+  .form-field--rich-text trix-toolbar .trix-dialog--heading {
+    width: max-content;
+    max-width: 100%;
+
+    margin-left: 0;
+  }
+
+  .form-field--rich-text trix-toolbar .trix-dialog--heading .trix-dialog__link-fields {
+    width: auto;
+  }
+
+  .form-field--rich-text trix-toolbar .trix-dialog--heading .trix-button-group {
+    display: flex;
+    flex-wrap: nowrap;
+
+    width: auto;
+    margin: 0;
+  }
+
+  /*
+   * Farbpalette ebenfalls vollständig innerhalb
+   * der verfügbaren Breite darstellen.
+   */
+  .form-field--rich-text trix-toolbar .trix-dialog--color {
+    width: max-content;
+    max-width: 100%;
+  }
+
+  .form-field--rich-text trix-editor .attachment-gallery,
+  .form-field--rich-text trix-editor .attachment-gallery--2,
+  .form-field--rich-text trix-editor .attachment-gallery--4 {
+    grid-template-columns: 1fr;
+  }
+}
+
+.form-field--rich-text trix-toolbar .trix-button--icon {
+  height: 1.98em;
+}
+
+.form-field--rich-text trix-toolbar .trix-button-group--container-tools .trix-button {
+  height: 2.6em;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+
+@media (max-width: 768px) {
+  trix-toolbar .trix-button--icon {
+    height: 2em;
+  }
+}