recourse 7.8.3 → 7.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 94653dc38ca1c788fce69b9406faddc48c189cefcd9fbe7dbe11e4d87ddc3faf
-  data.tar.gz: c1282266e1e70de6bc5438661f86321e52948dee028baa7128efe4fac4317719
+  metadata.gz: '024485f23e83a52580fa55b3d73f858bf737ab1a2fd5e53819f283aaf29a57e3'
+  data.tar.gz: f1aaa536fd9085f5baa7b54cf9590d0387aa79bc65173a9ab97a853ffacbdbe9
 SHA512:
-  metadata.gz: dbed84f6d5071f7be79cdb87c499c6a9c4ae23ceb74c70390606cfe33652236f38e782ecbae67347c4873b270c23cba660395d2451034202517af60fe9a0a8d6
-  data.tar.gz: e04c3108e911aba9d08555b8d696994cc56df42ee21ee207f96cc0f1cf326491fcd62d867f38953e22c3fdb76e14297a50d22e4444db0bae1c28746a20b546db
+  metadata.gz: bbad80f3cda8598fb3773e8caad5b887aa02354a8dd2ba56f289669ae456a4ebca178830d20900cb0ec95a73c641cf95d9d47698c85654a48abd5a5eaa78214e
+  data.tar.gz: 07daefa230e19c573044eb613716eafa6d347cdeceb19e1d72af511696a458abb3e4771fb2d91f5784adb5e8053ef8f172e6f08dab09b3011acab7f6336b933c

data/CHANGELOG.md

@@ -7,6 +7,27 @@ For more information about changelogs, check [Keep a Changelog](http://keepachan
 
 ## [Unreleased]
 
+## 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

@@ -51,6 +51,14 @@
     </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 %>
+        <i class='bi bi-box-arrow-in-right'></i>
+        <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 %>

data/config/locales/recourse.en.yml

@@ -53,6 +53,7 @@ en:
     deleted_error: "%{model} could not be deleted."
     destroy: Delete
     exit: Exit
+    enter: Sign in
     displaying:
       one: Displaying 1 item
       other: Displaying %{count} items

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,13 @@ 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
+
       # 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.9.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: recourse
 version: !ruby/object:Gem::Version
-  version: 7.8.3
+  version: 7.9.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