recourse 7.5.0 → 7.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28a482b8977d87fe680f8b1bff7502998e09202d1c5e95364746cc01b9c92596
-  data.tar.gz: a8fdb47ce0906854dd0164ac638d8d43155ca9d5561b3f47641c100b326113bf
+  metadata.gz: f8e518ee85484be8de5cc4a1533a9b8677d97417706a8c93210a02b2ad067040
+  data.tar.gz: 98e1b1f4173a12c8935783d5194715affd66ebfd33de377b0010c86352be83c4
 SHA512:
-  metadata.gz: b03910594792d293f48c138e3ebc186527fa8e08b4784a8c45924479290342ff83776775d508222b7b127b4d7dad5d19f24c5d6b08e9ad46df8be6aff418bfc3
-  data.tar.gz: e6951d50584a7d913f575caeaa4e141d842e990902abee2326e65080b382587ec416cdedc73bf136265a3d5902374b3b5250546c1cdddd7d0513b5b4a16bdd86
+  metadata.gz: 11c62eca29bcd4fdd171ff3d1fe2f5829b41ff0d4d057cff38a8c24749b5bb8d610962906746ba828e6163d7ad0ac89bb0e7a5a1ef44b84250967b95e4173708
+  data.tar.gz: f4801d3c52a5228fe075f50940fd01833c81966c232b17e0d093dffda29d0b75f93e73cf91d13fdf05a9a55bd41e7adaad2c84653d8a5f5b79fe7102c8146458

data/CHANGELOG.md

@@ -7,6 +7,28 @@ For more information about changelogs, check [Keep a Changelog](http://keepachan
 
 ## [Unreleased]
 
+## 7.6.1 - 2026-09-20
+
+* [FIX] The three write seams are marked `@api private`
+
+  `create_resource`, `update_resource` and `destroy_resource` are how the gem writes a
+  record, not a shelf for a host to reach. A host with something of its own to do on a
+  write writes the action.
+
+  The comment over `destroy_resource` still described the `destroy!` it stopped being in
+  7.2.0, and said the opposite of what it now does.
+
+## 7.6.0 - 2026-09-20
+
+* [CHANGE] The layout titles the page, so a host template cannot lose it
+
+  The four templates each set `content_for :title`, so a host writing one of its own —
+  which is the whole point of the gem drawing the rest — left the tab reading `Recourse`.
+  The title is chrome like the trail beside it, and the layout works it out from the same
+  place: what the trail ends with, the resource it is of where the record names nothing,
+  and the app's own name where neither answers. `content_for :title` still wins where a
+  host sets one.
+
 ## 7.5.0 - 2026-09-20
 
 * [FEATURE] A model may word its own deletion

data/app/controllers/concerns/recourse/attachment_writing.rb

@@ -9,17 +9,20 @@ module Recourse
 
     # A new record, then the files that came with it, in one transaction: a record
     # half-saved is worse than one not saved.
+    # @api private
     def create_resource(record)
       record.transaction { super && attach_submitted_files(record) }
     end
 
-    # The same for one that already exists.
+    # A record that already exists, then the files that came with it.
+    # @api private
     def update_resource(record)
       super && attach_submitted_files(record)
     end
 
     # On a page of what a record has attached, the row between the two goes and the
     # file stays for whatever else points at it; everywhere else the record itself goes.
+    # @api private
     def destroy_resource(record)
       return super unless attachment_reflection
 

data/app/controllers/concerns/recourse/reference_resolution.rb

@@ -7,14 +7,16 @@ module Recourse
 
     # A new record, unless a typed label named more than one row, which is answered on
     # the form rather than by writing a guess.
+    # @api private
     def create_resource(record)
       return false if ambiguous_references? record
 
       record.save
     end
 
-    # The same for one that already exists. The parameters are read before the refusal
-    # is asked about, since reading them is what notices an ambiguous label.
+    # A record that already exists, under the same refusal. The parameters are read
+    # before it is asked about, since reading them is what notices an ambiguous label.
+    # @api private
     def update_resource(record)
       attributes = resource_params
       return false if ambiguous_references? record
@@ -22,8 +24,9 @@ module Recourse
       record.update attributes
     end
 
-    # And the record gone. `destroy!`, so a callback that stops one says so rather than
-    # leaving the page claiming it worked.
+    # The record gone, or false where a callback refused to give it up, which the page
+    # says where the row still is.
+    # @api private
     def destroy_resource(record) = record.destroy
 
     # A foreign key whose label is typed arrives as that label, so it is looked up

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

@@ -2,7 +2,7 @@
 <html lang='en'>
   <head>
     <meta charset='utf-8'>
-    <title><%= content_for(:title) || 'Recourse' %></title>
+    <title><%= content_for(:title) || page_title %></title>
     <meta name='viewport' content='width=device-width, initial-scale=1'>
     <meta name='color-scheme' content='light dark'>
     <%# A refresh Turbo is sent morphs the page in place and keeps the scroll; without these it

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

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

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

@@ -1,5 +1,3 @@
-<% content_for :title, resources_name %>
-
 <% if (new_path = new_resource_path) %>
   <% content_for :actions do %>
     <%= link_to t('recourse.add', model: resource_name), new_path,

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

@@ -1,3 +1 @@
-<% content_for :title, t('recourse.new', model: resource_name) %>
-
 <%= render 'form', resource_key => resource_record %>

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

@@ -1,5 +1,3 @@
-<% content_for :title, resource_record_label %>
-
 <%# Nothing to read out where the host found no record: a singular resource is reached
     with no id, so the one it stands for is one it may not have yet, and the page says so
     rather than reading attributes off nothing. -%>

data/lib/recourse/helpers/breadcrumbs.rb

@@ -46,6 +46,14 @@ module Recourse
         safe_join [tag.i(class: "bi bi-#{icon}"), word], ' '
       end
 
+      # What the tab calls this page: what the trail ends with, the resource it is of
+      # where the record names nothing, and the app's own name where neither answers.
+      def page_title
+        breadcrumb_leaf.presence || breadcrumb_name.presence || app_name
+      end
+
+      def app_name = Rails.application.class.module_parent_name
+
       # Only a page beneath the index names itself, and names what it is showing.
       def breadcrumb_leaf
         case controller.action_name

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.5.0'
+  VERSION = '7.6.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: recourse
 version: !ruby/object:Gem::Version
-  version: 7.5.0
+  version: 7.6.1
 platform: ruby
 authors:
 - claudiob