RubyGems - drive - Versions diffs - 0.1.0 - Mend

drive 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (45) hide show

checksums.yaml +7 -0
data/CHANGELOG.md +6 -0
data/CLAUDE.md +690 -0
data/LICENSE.txt +21 -0
data/README.md +77 -0
data/Rakefile +32 -0
data/STYLE.md +435 -0
data/app/controllers/recourses_controller.rb +96 -0
data/app/javascript/recourse/phone_controller.js +33 -0
data/app/views/layouts/application.html.erb +69 -0
data/app/views/recourses/_breadcrumb.html.erb +18 -0
data/app/views/recourses/_combobox.html.erb +23 -0
data/app/views/recourses/_fields.html.erb +3 -0
data/app/views/recourses/_flash.html.erb +13 -0
data/app/views/recourses/_form.html.erb +9 -0
data/app/views/recourses/_none.html.erb +1 -0
data/app/views/recourses/_row.html.erb +4 -0
data/app/views/recourses/_sidebar.html.erb +10 -0
data/app/views/recourses/_table.html.erb +30 -0
data/app/views/recourses/edit.html.erb +3 -0
data/app/views/recourses/index.html.erb +14 -0
data/app/views/recourses/new.html.erb +3 -0
data/lib/drive.rb +3 -0
data/lib/recourse/controllers.rb +13 -0
data/lib/recourse/engine.rb +27 -0
data/lib/recourse/helpers/cells.rb +44 -0
data/lib/recourse/helpers/comboboxes.rb +33 -0
data/lib/recourse/helpers/constraints.rb +94 -0
data/lib/recourse/helpers/examples.rb +35 -0
data/lib/recourse/helpers/fields.rb +54 -0
data/lib/recourse/helpers/navigation.rb +68 -0
data/lib/recourse/helpers/references.rb +89 -0
data/lib/recourse/helpers.rb +60 -0
data/lib/recourse/icons.rb +21 -0
data/lib/recourse/recoursive.rb +19 -0
data/lib/recourse/routes.rb +14 -0
data/lib/recourse/version.rb +4 -0
data/lib/recourse.rb +31 -0
data/vendor/recourse/bootstrap-icons.min.css +5 -0
data/vendor/recourse/bootstrap.bundle.min.js +9 -0
data/vendor/recourse/bootstrap.min.css +2 -0
data/vendor/recourse/fonts/bootstrap-icons.woff +0 -0
data/vendor/recourse/fonts/bootstrap-icons.woff2 +0 -0
data/vendor/recourse/stimulus.js +2563 -0
metadata +144 -0

data/app/javascript/recourse/phone_controller.js ADDED Viewed

@@ -0,0 +1,33 @@
+import { Controller } from '/recourse/stimulus.js'
+export default class extends Controller {
+  connect() {
+    this.#format(this.element)
+  }
+  down(event) {
+    if (!event.key) { return }
+    if (event.ctrlKey) { return }
+    if (event.metaKey) { return }
+    if (event.key.length > 1) { return }
+    if (/[0-9.]/.test(event.key)) { return }
+    event.preventDefault()
+  }
+  input(event) {
+    if (event.inputType === 'deleteContentBackward') { return }
+    if (/[\d-]{12}/.test(event.target.value)) { event.preventDefault() }
+    this.#format(event.target)
+  }
+  #format(element) {
+    const digits = element.value.replace(/\D/g,'').substring(0, 10)
+    const areaCode = digits.substring(0, 3)
+    const prefix = digits.substring(3, 6)
+    const suffix = digits.substring(6, 10)
+    if (digits.length > 5) { element.value = `${areaCode}-${prefix}-${suffix}` }
+    else if (digits.length > 2) { element.value = `${areaCode}-${prefix}` }
+    else if (digits.length > 0) { element.value = `${areaCode}` }
+  }
+}

data/app/views/layouts/application.html.erb ADDED Viewed

@@ -0,0 +1,69 @@
+<!DOCTYPE html>
+<html lang='en'>
+  <head>
+    <meta charset='utf-8'>
+    <title><%= content_for(:title) || 'Recourse' %></title>
+    <meta name='viewport' content='width=device-width, initial-scale=1'>
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+    <%= yield :head %>
+    <link rel='preconnect' href='https://fonts.googleapis.com'>
+    <link rel='preconnect' href='https://fonts.gstatic.com' crossorigin>
+    <link rel='stylesheet' href='https://fonts.googleapis.com/css2?family=Geist+Mono:wght@100..900&family=Geist:wght@100..900&display=swap'>
+    <link rel='stylesheet' href='/recourse/bootstrap.min.css'>
+    <link rel='stylesheet' href='/recourse/bootstrap-icons.min.css'>
+    <script type='module'>
+      import { Application } from '/recourse/stimulus.js'
+      import PhoneController from '/recourse/phone_controller.js'
+      // In the head, and guarded: Turbo re-runs body scripts on every visit, and a
+      // second application would connect every controller twice.
+      if (!window.Stimulus) {
+        window.Stimulus = Application.start()
+        window.Stimulus.register('phone', PhoneController)
+      }
+    </script>
+    <style>
+      :root {
+        --bs-body-font-family: 'Geist', system-ui, sans-serif;
+        --bs-font-mono: 'Geist Mono', ui-monospace, monospace;
+      }
+    </style>
+  </head>
+  <body class='d-flex flex-column min-vh-100'>
+    <nav class='navbar border-bottom'>
+      <div class='container-fluid px-3 justify-content-start'>
+        <%= render 'breadcrumb' %>
+        <%= yield :actions %>
+      </div>
+    </nav>
+    <div class='container-fluid flex-grow-1 d-flex'>
+      <div class='row flex-grow-1'>
+        <aside class='col-auto border-end py-3 px-3 mx-0'>
+          <%= render 'sidebar' %>
+        </aside>
+        <main class='col py-4 px-3'>
+          <%= yield %>
+        </main>
+      </div>
+    </div>
+    <%= render 'flash' %>
+    <script type='module' src='https://cdn.jsdelivr.net/npm/@hotwired/turbo@8.0.23/dist/turbo.es2017-esm.js'></script>
+    <script type='module' src='/recourse/bootstrap.bundle.min.js'></script>
+    <script type='module'>
+      import { Toast } from '/recourse/bootstrap.bundle.min.js'
+      // A toast stays hidden until shown, and only then starts its autohide timer.
+      for (const toast of document.querySelectorAll('.toast')) Toast.getOrCreateInstance(toast).show()
+    </script>
+  </body>
+</html>

data/app/views/recourses/_breadcrumb.html.erb ADDED Viewed

@@ -0,0 +1,18 @@
+<nav aria-label='breadcrumb'>
+  <ol class='breadcrumb mb-0'>
+    <% resource_breadcrumbs.each_with_index do |(title, path), index| %>
+      <% unless index.zero? %>
+        <li class='breadcrumb-divider'></li>
+      <% end %>
+      <% if path %>
+        <li class='breadcrumb-item'>
+          <%= link_to resource_label(title), path, class: 'breadcrumb-link gap-2' %>
+        </li>
+      <% else %>
+        <li class='breadcrumb-item' aria-current='page'>
+          <span class='breadcrumb-link active'><%= title %></span>
+        </li>
+      <% end %>
+    <% end %>
+  </ol>
+</nav>

data/app/views/recourses/_combobox.html.erb ADDED Viewed

@@ -0,0 +1,23 @@
+<%# locals: (name:, id:, invalid:, feedback:, label:, placeholder:, required:, recourses:) -%>
+<button class='form-control<%= ' is-invalid' if invalid %> combobox-toggle' type='button' id='<%= id %>'
+        data-bs-toggle='combobox' data-bs-name='<%= name %>'
+        data-bs-placeholder='<%= placeholder %>' data-bs-search='true'
+        aria-required='<%= required %>' <%= tag.attributes 'aria-describedby': feedback && "#{id}_error" %>>
+  <span class='combobox-value'><%= placeholder %></span>
+  <i class='bi bi-chevron-down combobox-caret'></i>
+</button>
+<div class='menu'>
+  <div class='combobox-search'>
+    <input type='text' class='form-control combobox-search-input' placeholder='Search…'
+           autocomplete='off' aria-label='Search…'>
+  </div>
+  <% cache recourses do %>
+    <% recourses.each do |recourse| %>
+      <button class='menu-item' type='button' data-bs-value='<%= recourse.id %>'><%= recourse.attributes[label] %></button>
+    <% end %>
+  <% end %>
+  <div class='combobox-no-results d-none'>No results found</div>
+</div>
+<% if feedback -%>
+  <small class='invalid-feedback' id='<%= id %>_error'><%= feedback %></small>
+<% end -%>

data/app/views/recourses/_fields.html.erb ADDED Viewed

@@ -0,0 +1,3 @@
+<% editable_columns.each do |name| -%>
+  <%= field name %>
+<% end -%>

data/app/views/recourses/_flash.html.erb ADDED Viewed

@@ -0,0 +1,13 @@
+<% if flash.any? -%>
+  <div class='toast-container position-fixed bottom-0 end-0 p-3'>
+    <% flash.each do |key, message| -%>
+      <div class='toast <%= flash_theme key %>' role='alert' aria-live='assertive' aria-atomic='true'>
+        <div class='toast-header border-0'>
+          <span class='me-auto'><%= message %></span>
+          <button type='button' class='btn-close' data-bs-dismiss='toast' aria-label='Close'></button>
+        </div>
+        <div class='toast-body d-none'></div>
+      </div>
+    <% end -%>
+  </div>
+<% end -%>

data/app/views/recourses/_form.html.erb ADDED Viewed

@@ -0,0 +1,9 @@
+<% record = local_assigns[resource_key] -%>
+<%= form_with model: record do |form| %>
+  <% @recourse_form = form -%>
+  <div class='row'>
+    <%= render 'fields', resource_key => record %>
+  </div>
+  <%= form.submit class: 'btn btn-solid theme-primary' %>
+<% end %>

data/app/views/recourses/_none.html.erb ADDED Viewed

	@@ -0,0 +1 @@
1	+ <p class='fg-2'>No <%= resources_name.downcase %>.</p>

data/app/views/recourses/_row.html.erb ADDED Viewed

@@ -0,0 +1,4 @@
+<% record = local_assigns[resource_key] -%>
+<% resource_columns.each do |name| -%>
+  <%= column header: reference_title(name, belongs_to_association(name)) do %><%= resource_cell record, name %><% end %>
+<% end -%>

data/app/views/recourses/_sidebar.html.erb ADDED Viewed

@@ -0,0 +1,10 @@
+<ul class='nav flex-column'>
+  <% sidebar_resources.each do |name, title, path| %>
+    <% current = current_resource? name %>
+    <li class='nav-item'>
+      <%= link_to resource_label(title), path,
+                  class: class_names('nav-link', active: current),
+                  aria: { current: ('page' if current) } %>
+    </li>
+  <% end %>
+</ul>

data/app/views/recourses/_table.html.erb ADDED Viewed

@@ -0,0 +1,30 @@
+<%# locals: (recourses:, pagy:) %>
+<% cache recourses do %>
+  <div class='table-responsive'>
+    <table class='table caption-top table-hover align-middle sm:table-stacked'>
+      <thead>
+        <tr>
+          <% @recourse_headers = true %>
+          <%= render 'row', resource_key => nil %>
+          <%= column header: 'Actions' %>
+        </tr>
+      </thead>
+      <tbody>
+        <% @recourse_headers = false %>
+        <% recourses.each do |recourse| %>
+          <tr>
+            <%= render 'row', resource_key => recourse %>
+            <%= column header: 'Actions' do %><%= edit_resource_link recourse %><% end %>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+<% end %>
+<% if pagy %>
+  <div class='d-flex align-items-center'>
+    <div class='ps-2 flex-grow-1'><%== pagy.info_tag.gsub(/of (\d*?) in total/) { "of #{number_with_delimiter $1} in total" } %></div>
+    <div class='pe-2'><%== pagy.series_nav(:bootstrap, classes: 'pagination mb-0') if pagy.last > 1 %></div>
+  </div>
+<% end %>

data/app/views/recourses/edit.html.erb ADDED Viewed

@@ -0,0 +1,3 @@
+<% content_for :title, resource_record_label %>
+<%= render 'form', resource_key => resource_record %>

data/app/views/recourses/index.html.erb ADDED Viewed

@@ -0,0 +1,14 @@
+<% content_for :title, resources_name %>
+<% if (new_path = new_resource_path) %>
+  <% content_for :actions do %>
+    <%= link_to "Add #{resource_name}", new_path,
+                class: 'btn theme-primary btn-sm btn-outline ms-3' %>
+  <% end %>
+<% end %>
+<% if @resources.blank? %>
+  <%= render 'none' %>
+<% else %>
+  <%= render 'table', recourses: @resources, pagy: @pagy %>
+<% end %>

data/app/views/recourses/new.html.erb ADDED Viewed

@@ -0,0 +1,3 @@
+<% content_for :title, "New #{resource_name}" %>
+<%= render 'form', resource_key => resource_record %>

data/lib/drive.rb ADDED Viewed

@@ -0,0 +1,3 @@
+# Entry point named after the gem, so `require 'drive'` reaches the library that
+# still calls itself Recourse — which is what Bundler does for a gem of this name.
+require_relative 'recourse'

data/lib/recourse/controllers.rb ADDED Viewed

@@ -0,0 +1,13 @@
+module Recourse
+  # Defines the controller classes a host app has not written for itself.
+  module Controllers
+    # Creates a controller for the named resource unless the host app has one.
+    def self.define_missing(name)
+      class_name = "#{name.to_s.camelize}Controller"
+      # const_defined? is true for a Zeitwerk autoload, so files on disk count too.
+      return if Object.const_defined? class_name
+      Object.const_set class_name, Class.new(RecoursesController)
+    end
+  end
+end

data/lib/recourse/engine.rb ADDED Viewed

@@ -0,0 +1,27 @@
+# rails/engine alone raises NoMethodError: railtie.rb calls delegate_missing_to too early.
+require 'rails'
+require_relative 'routes'
+module Recourse
+  # Hooks the gem into a host app's boot so its controllers and views are found.
+  class Engine < ::Rails::Engine
+    # Prefix the gem answers for with a file. `Rack::Static` matches on
+    # `start_with?`, so dropping the slash would swallow `/recourses` itself.
+    STATIC_URLS = %w[/recourse/].freeze
+    # Initializers all run before routes are drawn, so `recourses` exists in time.
+    initializer 'recourse.routes' do
+      ActionDispatch::Routing::Mapper.include Routes
+    end
+    # Serves what a page needs, since a host may run no asset pipeline at all. The
+    # prefix keeps its slash: without it `/recourses` would be served as a file.
+    # Vendored files answer first and cascade, so our own JavaScript shares the URL.
+    initializer 'recourse.assets' do |app|
+      app.middleware.use Rack::Static, urls: STATIC_URLS, root: Engine.root.join('vendor'),
+                                       cascade: true
+      app.middleware.use Rack::Static, urls: STATIC_URLS, root: Engine.root.join('app/javascript')
+    end
+  end
+end

data/lib/recourse/helpers/cells.rb ADDED Viewed

@@ -0,0 +1,44 @@
+module Recourse
+  module Helpers
+    # Helpers for the cells of a table and the fields of a form.
+    module Cells
+      # How a time reads on a page, e.g. 'Aug 4 at 03:47pm EDT'.
+      TIME_FORMAT = '%b %-d at %I:%M%P %Z'
+      # Columns the table shows: every attribute that is not encrypted.
+      def resource_columns
+        resource_model.column_names - Array(resource_model.encrypted_attributes).map(&:to_s)
+      end
+      # Columns a form offers, the same list `create` permits.
+      def editable_columns
+        Recourse.editable_columns resource_model
+      end
+      # Heading for a column, which a host app can translate like any attribute.
+      def resource_column_title(column)
+        resource_model.human_attribute_name column
+      end
+      # Value for one cell, formatted according to what the column holds.
+      def resource_cell(resource, column)
+        association = belongs_to_association column
+        return reference_cell resource, association if association
+        value = resource.attributes[column]
+        return time_tag value, value.strftime(TIME_FORMAT) if value.is_a? Time
+        return number_to_phone value if column == 'phone'
+        value
+      end
+      # One cell: a heading in the header row, the block's output in every other.
+      def column(header:, **, &)
+        return tag.th(header, scope: :col, **) if @recourse_headers
+        tag.td(capture(&), 'data-cell': header, **)
+      end
+    end
+  end
+end

data/lib/recourse/helpers/comboboxes.rb ADDED Viewed

@@ -0,0 +1,33 @@
+module Recourse
+  module Helpers
+    # The menu a foreign key offers when its label is too long to be typed.
+    module Comboboxes
+      # A combobox of labels. The query fetches the two columns the menu shows and
+      # nothing else, and the errors are its own work: `field_error_proc` only ever
+      # sees the tags a form builder drew, and this is a partial.
+      def combobox(form, column, association)
+        messages = errors_on column
+        label = association.klass.recourse_label
+        render 'recourses/combobox', name: form.field_name(column),
+                                     id: form.field_id(column),
+                                     invalid: messages.any?,
+                                     feedback: messages.to_sentence.upcase_first.presence,
+                                     label: label.to_s,
+                                     placeholder: combobox_placeholder(column, association),
+                                     required: required?(resource_model, column),
+                                     recourses: combobox_options(association.klass, label)
+      end
+    private
+      def combobox_options(klass, label)
+        klass.select(:id, label).order label
+      end
+      def combobox_placeholder(column, association)
+        placeholder(resource_model, column, nil) ||
+          "Select a #{association.klass.model_name.human}…"
+      end
+    end
+  end
+end

data/lib/recourse/helpers/constraints.rb ADDED Viewed

@@ -0,0 +1,94 @@
+module Recourse
+  module Helpers
+    # Turns a model's validators into the HTML that constrains a form field.
+    module Constraints
+      # Shown for a field whose shape has one canonical example.
+      SAMPLE_PLACEHOLDERS = { 'phone' => '555-555-5555', 'email' => 'michael@example.com' }.freeze
+      # What the browser checks where the typed shape differs from the stored one: a
+      # phone is ten digits in the database but is typed with its separators.
+      DISPLAY_PATTERNS = { 'phone' => '[2-9]\d{2}-[2-9]\d{2}-\d{4}' }.freeze
+      # Hands a phone field to the Stimulus controller that types its separators.
+      PHONE_CONTROLLER = {
+        controller: 'phone', action: 'keydown->phone#down input->phone#input',
+      }.freeze
+      # Browser-side constraints, every one read from the validators of `model` —
+      # which is the page's model unless a field asks about another one's attribute.
+      def field_html(column, type = nil, model = resource_model)
+        key = (type || column).to_s
+        pattern = DISPLAY_PATTERNS[key] || column_pattern(model, column)
+        {
+          maxlength: length_option(model, column, :maximum),
+          minlength: length_option(model, column, :minimum), pattern:,
+          title: title(key, pattern), placeholder: placeholder(model, column, type),
+          inputmode: (:numeric if numeric? model, column, pattern),
+          required: (true if required? model, column),
+          data: (PHONE_CONTROLLER if key == 'phone'),
+        }.compact
+      end
+    private
+      # The canonical sample where the field has one, so the title agrees with the
+      # placeholder; otherwise a shape read off the pattern itself.
+      def title(key, pattern)
+        return unless pattern
+        "Please match the format #{SAMPLE_PLACEHOLDERS[key] || pattern_example(pattern)}"
+      end
+      def length_option(model, column, bound)
+        length_options(model, column).values_at(bound, :is).compact.first
+      end
+      def length_options(model, column)
+        validator(model, column, ActiveModel::Validations::LengthValidator)&.options || {}
+      end
+      # An HTML pattern is anchored already, so \A and \z come off the Ruby one.
+      def column_pattern(model, column)
+        shape = validator model, column, ActiveModel::Validations::FormatValidator
+        regexp = shape&.options&.dig :with
+        return unless regexp
+        regexp.source.delete_prefix('\A').delete_suffix '\z'
+      end
+      # An explicit type states what the field is, so it picks the sample; without
+      # one a required field shows the shape it expects and an optional one says so.
+      def placeholder(model, column, type)
+        sample = SAMPLE_PLACEHOLDERS[(type || column).to_s]
+        return sample if sample && (type || required?(model, column))
+        'Optional' unless required? model, column
+      end
+      # A belongs_to validates its association, not the column, so both are asked.
+      def required?(model, column)
+        presence_validated?(model, column) ||
+          presence_validated?(model, column.delete_suffix('_id'))
+      end
+      def presence_validated?(model, attribute)
+        validator(model, attribute, ActiveModel::Validations::PresenceValidator).present?
+      end
+      def numeric?(model, column, pattern)
+        digits_only?(pattern) ||
+          validator(model, column, ActiveModel::Validations::NumericalityValidator).present?
+      end
+      # `\d` carries a letter, so it has to go before looking for real ones.
+      def digits_only?(pattern)
+        pattern.present? && !pattern.gsub('\d', '').match?(/[A-Za-z]/)
+      end
+      def validator(model, attribute, kind)
+        model.validators_on(attribute).find { |one| one.is_a? kind }
+      end
+    end
+  end
+end

data/lib/recourse/helpers/examples.rb ADDED Viewed

@@ -0,0 +1,35 @@
+module Recourse
+  module Helpers
+    # Reads an example of an accepted value off the pattern that accepts it.
+    module Examples
+      # One token of a pattern and the `{n}` that may repeat it, so `\d{5}` reads
+      # as a single digit five times over rather than as five separate characters.
+      # `\d`, a bracket class and a literal are all it knows; nothing else is used.
+      PATTERN_TOKENS = /(\\d|\[[^\]]*\]|[^{])(?:\{(\d+),?\d*\})?/
+      # A token that is a bracket class, so `[2-9]` counts as one rather than five.
+      CLASS_TOKEN = /\A\[/
+      # First character a bracket class offers, past the bracket and any negation.
+      CLASS_SAMPLE = /[^\[^]/
+      # What the pattern accepts, so a field can name the shape it wants instead of
+      # only reporting that what was typed is wrong.
+      def pattern_example(pattern)
+        tokens = pattern.scan PATTERN_TOKENS
+        tokens.map { |token, count| pattern_sample(token) * (count || 1).to_i }.join
+      end
+    private
+      def pattern_sample(token)
+        case token
+        when '\d' then '0'
+        when CLASS_TOKEN then token[CLASS_SAMPLE]
+        else token
+        end
+      end
+    end
+  end
+end

data/lib/recourse/helpers/fields.rb ADDED Viewed

@@ -0,0 +1,54 @@
+module Recourse
+  module Helpers
+    # Chooses the form field a column deserves, and labels it.
+    module Fields
+      # One labelled field in the form's grid. `label:` overrides the heading and
+      # `type:` overrides the input the column would otherwise have chosen.
+      def field(name, **options)
+        column = name.to_s
+        label = options.fetch :label, reference_title(column, belongs_to_association(column))
+        tag.div class: 'mb-3 lg:col-6' do
+          safe_join [@recourse_form.label(column, label, class: 'form-label'),
+                     resource_field(@recourse_form, column, type: options[:type])]
+        end
+      end
+      # A field typed by what the column holds, not merely a text box.
+      def resource_field(form, column, type: nil)
+        association = belongs_to_association column
+        return reference_field form, column, association if association
+        # Rails mirrors `maxlength` into `size`, which would shrink the box to it.
+        options = { class: 'form-control', size: nil }.merge field_html(column, type)
+        return form.text_field column, **options, type: type if type
+        return form.password_field column, **options if encrypted_column? column
+        return form.email_field column, **options if column == 'email'
+        return form.color_field column, **options if column == 'color'
+        dated_field form, column, **options
+      end
+    private
+      def dated_field(form, column, **)
+        case attribute_type column
+        when :date then form.date_field column, **
+        when :time then form.time_field column, **
+        when :datetime then form.datetime_local_field column, **
+        else form.text_field column, **
+        end
+      end
+      def encrypted_column?(column)
+        Array(resource_model.encrypted_attributes).map(&:to_s).include? column
+      end
+      # The model's own attribute type, so an `attribute` override still counts.
+      def attribute_type(column)
+        resource_model.type_for_attribute(column).type
+      end
+    end
+  end
+end

data/lib/recourse/helpers/navigation.rb ADDED Viewed

@@ -0,0 +1,68 @@
+module Recourse
+  module Helpers
+    # Helpers for the navbar and the sidebar.
+    module Navigation
+      # Trail to the current page as [title, path] pairs; a nil path is this page.
+      def resource_breadcrumbs
+        leaf = breadcrumb_leaf
+        return [[resources_name, nil]] unless leaf
+        [[resources_name, url_for(action: :index)], [leaf, nil]]
+      end
+      # Pencil linking to a record's edit page, or nothing when there is not one.
+      def edit_resource_link(record)
+        path = edit_resource_path record
+        return unless path
+        link_to tag.i(class: 'bi bi-pencil-square'), path, aria: { label: 'Edit' }
+      end
+      # Path to this resource's new page, or nil when there is not one to link to.
+      def new_resource_path
+        return unless controller.class.action_methods.include? 'new'
+        return unless routed? controller.controller_path, 'new'
+        url_for action: :new
+      end
+      # Label for a link to a resource: its icon, then its title.
+      def resource_label(title)
+        icon = NAVIGATION_ICONS.fetch title, FALLBACK_ICON
+        safe_join [tag.i(class: "bi bi-#{icon}"), title], ' '
+      end
+      # Sidebar entries as [name, title, path], in the order routes.rb declares them.
+      def sidebar_resources
+        Recourse.declared.filter_map do |name|
+          next unless routed? name, 'index'
+          [name, name.humanize, url_for(controller: "/#{name}", action: :index)]
+        end
+      end
+      # True when a sidebar entry names the resource the page is showing.
+      def current_resource?(name)
+        name == controller.controller_name
+      end
+    private
+      # Only a page beneath the index names itself, and names what it is showing.
+      def breadcrumb_leaf
+        case controller.action_name
+        when 'new', 'create' then "New #{resource_name}"
+        when 'edit', 'update' then resource_record_label
+        end
+      end
+      def edit_resource_path(record)
+        return unless controller.class.action_methods.include? 'edit'
+        return unless routed? controller.controller_path, 'edit'
+        url_for action: :edit, id: record
+      end
+    end
+  end
+end