recourse 7.8.3 → 7.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 94653dc38ca1c788fce69b9406faddc48c189cefcd9fbe7dbe11e4d87ddc3faf
-  data.tar.gz: c1282266e1e70de6bc5438661f86321e52948dee028baa7128efe4fac4317719
+  metadata.gz: a5ba4a5b982928c2ee9ea80e400a2d95c9b59102224902787ea3b3d6b9f4c9a8
+  data.tar.gz: 0d44134228230f5a15f4bc7545df435407518a074ae34299605d90294a93a4bd
 SHA512:
-  metadata.gz: dbed84f6d5071f7be79cdb87c499c6a9c4ae23ceb74c70390606cfe33652236f38e782ecbae67347c4873b270c23cba660395d2451034202517af60fe9a0a8d6
-  data.tar.gz: e04c3108e911aba9d08555b8d696994cc56df42ee21ee207f96cc0f1cf326491fcd62d867f38953e22c3fdb76e14297a50d22e4444db0bae1c28746a20b546db
+  metadata.gz: 7db938770e4ecf06d930a89b965cc9790b2596b6c889be4f0a77cb0fff553739978408c22706da03abb4209964b17f6875b3c6703335e0bc9744d70c213768a1
+  data.tar.gz: b6a11dad45cae5cac88c42890b8551fd2f8a6c527c554672e7fe07221af251c1dbb1b59b35facc89b3c802ff57e1aec6ae01878d49e6424fe2b8d8b772eb85a2

data/CHANGELOG.md

@@ -7,6 +7,37 @@ For more information about changelogs, check [Keep a Changelog](http://keepachan
 
 ## [Unreleased]
 
+## 7.10.0 - 2026-09-26
+
+* [FEATURE] The sidebar's foot says what each icon does
+
+  The moon, the sun, the way in and the way out each open a tooltip to the right, away
+  from the sidebar's edge, the way a column's icon opens one above it: `Dark theme`,
+  `Light theme`, `Sign in` and `Sign out`. A host that answers `exit_name` with whoever is
+  signed in earns `Sign out N-100L`. The words are `recourse.dark_theme`, `light_theme`,
+  `sign_out` and `sign_out_as` in the locale.
+
+## 7.9.0 - 2026-09-26
+
+* [FEATURE] A pin or an area on a map leads to its row's page
+
+  Each point is sent as `[lat, lng, href, title]` and each place as `[id, href, title]`: the
+  record's own page wherever one is routed, and its label. bh's map controller makes a pin
+  or an area with an `href` clickable, following it through Turbo. Needs the bh that reads
+  these shapes: an older one still draws points, but takes a place's whole triple for its
+  ID and draws nothing, which is why this release requires bh 6.10.
+
+* [FEATURE] A route named `enter` earns the sidebar a way in
+
+  The mirror of `exit`: `get 'session/new', to: 'sessions#new', as: :enter` draws a
+  `Sign in` link beside the toggle, to wherever the host signs people in. A host that
+  signs people in shows one or the other by answering `enter?` and `exit?` itself.
+
+* [FEATURE] A bookmarks Proc answering nil draws no bookmark column
+
+  A visitor who never signed in has nowhere to keep a row, so `Recourse.bookmarks =
+  -> { Current.user&.bookmarks }` leaves them without the squares rather than raising.
+
 ## 7.8.3 - 2026-09-21
 
 * [FIX] A delete button in a table row is no taller than the row

data/README.md

@@ -78,8 +78,8 @@ draws the route a dragged row reports its place to, and `retrievable: true` draw
 one a `Retrieve` button on the table posts to, for rows that came from somewhere else.
 Both are refused on a resource with no `index`, since there is nowhere for either to
 stand. The [routes guide](https://claudiob.github.io/recourse/guides/routes.html) has
-the rest: namespaces, the defaults a nested resource takes, and the `exit` route that
-earns the sidebar a log-out button.
+the rest: namespaces, the defaults a nested resource takes, and the `enter` and `exit`
+routes that earn the sidebar a sign-in link and a log-out button.
 
 ## Step 2. Enhance your models
 
@@ -211,7 +211,8 @@ Recourse.bookmarks = -> { Keepsake.where agent: Current.agent }
 
 A Proc rather than a relation, because at boot the viewer is nobody. Every model with a
 `has_many` at that class then opens its table with a square to keep a row by, and kept
-rows come first. A model that cannot hold a bookmark gets no column.
+rows come first. A model that cannot hold a bookmark gets no column, and neither does a
+visitor the Proc answers nil for — somebody who never signed in has nowhere to keep one.
 
 <img width="3824" height="1220" alt="Image" src="https://github.com/user-attachments/assets/d1db4adb-0b5c-4e41-8bb6-cf72a35288f0" />
 

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

@@ -11,7 +11,8 @@
 
   <%# The foot of the sidebar: a reader's own say in how the page looks and, where the
       host drew a route named `exit`, the way out beside it — a button, since ending a
-      session is never a GET. Each takes half the row and centers its icon in it, so the
+      session is never a GET. Each icon says what it does in a tooltip that opens to the right,
+      away from the sidebar's edge. Each takes half the row and centers its icon in it, so the
       toggle alone sits in the middle and the two together sit at a quarter and at three
       quarters. Which side of the fold the foot lands on is the layout's business, and so
       is which of the two mode icons shows — the mode may be the system's, which only CSS
@@ -40,21 +41,29 @@
       <%= tag.button type: 'button', class: 'nav-link border-0 bg-transparent',
                      data: scheme_data do %>
         <span class='recourse-scheme-light'>
-          <i class='bi bi-moon-fill'></i>
+          <%= tag.i class: 'bi bi-moon-fill', data: tooltip_data(t('recourse.dark_theme'), placement: 'right') %>
           <span class='recourse-foot-word'><%= t 'recourse.darken' %></span>
         </span>
         <span class='recourse-scheme-dark'>
-          <i class='bi bi-sun-fill'></i>
+          <%= tag.i class: 'bi bi-sun-fill', data: tooltip_data(t('recourse.light_theme'), placement: 'right') %>
           <span class='recourse-foot-word'><%= t 'recourse.lighten' %></span>
         </span>
       <% end %>
     </div>
     <%# Submitted by the browser rather than by Turbo: a log out ends with a redirect to
         wherever the host signs people in, which is another origin a fetch cannot follow. -%>
+    <%# The way in, where the host drew a route named `enter`: a link, since what it
+        leads to is a form rather than a change. -%>
+    <% if enter? %>
+      <%= link_to enter_path, class: 'nav-link border-0 bg-transparent' do %>
+        <%= tag.i class: 'bi bi-box-arrow-in-right', data: tooltip_data(t('recourse.enter'), placement: 'right') %>
+        <span class='recourse-foot-word'><%= t 'recourse.enter' %></span>
+      <% end %>
+    <% end %>
     <% if exit? %>
       <%= button_to exit_path, method: :delete, class: 'nav-link border-0 bg-transparent',
                     form: { data: { turbo: false } } do %>
-        <i class='bi bi-box-arrow-right'></i>
+        <%= tag.i class: 'bi bi-box-arrow-right', data: tooltip_data(exit_tooltip, placement: 'right') %>
         <span class='recourse-foot-word'><%= t 'recourse.exit' %></span>
       <% end %>
     <% end %>

data/config/locales/recourse.en.yml

@@ -47,12 +47,16 @@ en:
     create: Create
     created: "%{record} was created."
     created_error: "%{model} could not be created."
+    dark_theme: Dark theme
     darken: Dark
     delete: Delete %{model}
     deleted: "%{model} was deleted."
     deleted_error: "%{model} could not be deleted."
     destroy: Delete
     exit: Exit
+    sign_out: Sign out
+    sign_out_as: "Sign out %{name}"
+    enter: Sign in
     displaying:
       one: Displaying 1 item
       other: Displaying %{count} items
@@ -66,6 +70,7 @@ en:
     items:
       one: 1 item
       other: "%{count} items"
+    light_theme: Light theme
     lighten: Light
     missing_model: You declared `recourses :%{name}` in your routes file, but this app
       has no %{model} model.

data/lib/recourse/bookmarks.rb

@@ -17,7 +17,8 @@ module Recourse
   # would run a host's Proc long before there is a request for it to read.
   def self.bookmarks? = !@declared_bookmarks.nil?
 
-  # The viewer's bookmarks, resolved for this request.
+  # The viewer's bookmarks, resolved for this request, or nil where the Proc answered
+  # nil: nobody is looking whose rows could be kept, a visitor who never signed in.
   def self.bookmarks
     bookmarks = @declared_bookmarks
     bookmarks = bookmarks.call if bookmarks.respond_to? :call
@@ -28,10 +29,11 @@ module Recourse
   # How a model's bookmarks point back at it: its own `has_many` at the bookmark
   # class, which is both the opt-in and everything needed to write one. A model that
   # cannot hold a bookmark has not declared one, so it gets no column.
+  # And none for a viewer the Proc named nobody, who has nowhere to keep a row.
   def self.bookmarks_for(model)
     return unless bookmarks?
 
-    klass = bookmarks.klass
+    klass = bookmarks&.klass or return
     model.reflect_on_all_associations(:has_many).find { |one| one.klass == klass }
   end
 

data/lib/recourse/helpers/maps.rb

@@ -15,23 +15,38 @@ module Recourse
       end
 
       # The places, with the layer they are areas on — pins where the model is no geography
-      # — or the points, where a model keeps no place.
+      # — or the points, where a model keeps no place. Each carries where its row leads and
+      # what it is called, so a pin or an area is clicked through to the record the way the
+      # row's own link in the table is.
       def map_rows(recourses)
         return { map_points_value: map_points(recourses) } unless Recourse.placed? resource_model
 
         {
           map_boundary_value: Recourse.boundary(resource_model)&.to_s&.upcase,
-          map_places_value: recourses.filter_map { |one| one.attributes[Recourse::PLACE_COLUMN] },
+          map_places_value: map_places(recourses),
         }
       end
 
-      # Only a row with both halves is a point; one with either missing is nowhere.
+      # Each place as `[id, href, title]`, for a row that names one.
+      def map_places(recourses)
+        recourses.filter_map do |one|
+          place = one.attributes[Recourse::PLACE_COLUMN]
+          [place, *map_lead(one)] if place
+        end
+      end
+
+      # Each point as `[lat, lng, href, title]`. Only a row with both halves is a point; one
+      # with either missing is nowhere.
       def map_points(recourses)
         recourses.filter_map do |one|
           point = one.attributes.values_at(*Recourse::POINT_COLUMNS)
-          point.map(&:to_f) if point.all?
+          [*point.map(&:to_f), *map_lead(one)] if point.all?
         end
       end
+
+      # Where a row's pin leads, the record's own page wherever one is routed, and what the
+      # pin says on hover: nothing to lead to where no page is.
+      def map_lead(record) = [resource_action_path(:show, record), Recourse.record_title(record)]
     end
   end
 end

data/lib/recourse/helpers/sidebars.rb

@@ -10,6 +10,22 @@ module Recourse
       # convention, and its helper existing is what the sidebar asks.
       def exit? = respond_to? :exit_path
 
+      # And the way in, its mirror: a route named `enter` — `resource :session, only:
+      # :new, as: :enter`, or a `get` of the host's own — earns a link beside the toggle
+      # to wherever the host signs people in. A link rather than a button, since asking
+      # for a form to sign in with changes nothing. Whether a viewer who already signed
+      # in still sees it is the host's to say, by answering this for them.
+      def enter? = respond_to? :enter_path
+
+      # Who is signed in, as the way out names them: `Sign out N-100L`. Nil, as it is where
+      # the host does not say, leaves the tooltip at `Sign out`.
+      def exit_name = nil
+
+      # What the way out's tooltip says.
+      def exit_tooltip
+        exit_name.present? ? t('recourse.sign_out_as', name: exit_name) : t('recourse.sign_out')
+      end
+
       # Sidebar entries as [name, title, path, key], in the order routes.rb declares
       # them, `key` being where in the title the letter that reaches it sits.
       def sidebar_resources

data/lib/recourse/version.rb

@@ -1,4 +1,4 @@
 module Recourse
   # Version of the gem, read by the gemspec and by hosts checking compatibility.
-  VERSION = '7.8.3'
+  VERSION = '7.10.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: recourse
 version: !ruby/object:Gem::Version
-  version: 7.8.3
+  version: 7.10.0
 platform: ruby
 authors:
 - claudiob
@@ -43,14 +43,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '6.7'
+        version: '6.10'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '6.7'
+        version: '6.10'
 - !ruby/object:Gem::Dependency
   name: pagy
   requirement: !ruby/object:Gem::Requirement