recourse 4.6.5 → 4.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cde158b6a70e0ab5fcabba26ecf536b2ec53965727b1a1534bd31ff71c581feb
-  data.tar.gz: f0e4917f3d7a165fc8754a92b148d541e7496e043fbf155f73a2ea29c5f1cc3d
+  metadata.gz: ba211bbbb2cad39fb435db7af8c982733056778da14b2617ed01616d7b471643
+  data.tar.gz: 3b847c74cb62a88425a882a839fc6d264581ab3f7e8aed661f53e03b184a12ed
 SHA512:
-  metadata.gz: 433bd7b0bb4f43bb6427b215be3a7585bba1c2256132f99a2b8f3bddb492689a64d30ff2b451c7fd55c563e5b3b3fc38867cb294a20752838b67e6be69cc043c
-  data.tar.gz: 6854c771a18f8b0b48d7157bb1d3fd1d4247d1d890112c02217640c3182eaca7d276d1de27e68a4153e7813b577c3099ff60fd0711fae5bb244295318f0958c4
+  metadata.gz: 7ba31e2730714820fa039e61ba649fc91e3b944b01703ded5c4a006b52068b0b5dc8997f667481994adb4d4fb4370660b3d2eed5fa0bb882d8307a44b0bc82ab
+  data.tar.gz: 99f83b13ef7fb727d140dcb6fbd44a3abb160fd10b2bd21d441fa4cb609e985463b66e044047503acdb69375645c8dc408ab2559d4faa00d62416a8dea95a9a9

data/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 For more information about changelogs, check [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 4.7.0 - 2026-09-11
+
+* [Feature] The toast after a create or an update names the record and links it to its page
+
+  `Blue Crew was updated.` rather than `Team was updated.`, with the label led to the
+  record's show page where the routes drew one, so a reader can go and look the row over.
+  The words are the label the model picked, or the model's own name where a record says
+  nothing. A rejected write and a delete still name the model. A host asserting the old
+  wording in its own tests updates the sentence.
+
+* [Feature] The first click on a heading sorts the table downward, and the second turns it back up
+
+  The newest, the most and the latest are what a reader clicks a heading to find, and
+  ascending put them on the last page. A host asserting a heading's `asc` link in its
+  own tests now reads `desc`.
+
 ## 4.6.5 - 2026-09-09
 
 * [Fix] A table opens at 15 rows a page rather than 20; the 100-row page stays

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

@@ -5,14 +5,24 @@ module Recourse
   module Landing
   private
 
-    # What a write says once it has landed: the message, and the row it landed on where
-    # one survives, for the page to mark while that message stands.
+    # What a write says once it has landed: the message, and the record it landed on
+    # where one survives, for the page to mark and lead to while that message stands.
     def wrote(message, record = nil)
       flash.notice = message
-      flash[Recourse::WRITTEN] = Recourse.row_id record if record
+      flash[Recourse::WRITTEN] = written record if record
       redirect_to written_url, status: :see_other
     end
 
+    # What the page is told about that record: the row to mark, the words the message
+    # calls it by, and its own page where the routes drew one — nil where they did not,
+    # so the words stay words. String keys: the flash rides the session as JSON.
+    def written(record)
+      shown = Recourse.routed? controller_path, 'show'
+      url = url_for(action: :show, id: record, only_path: true) if shown
+
+      { 'row' => Recourse.row_id(record), 'label' => Recourse.record_title(record), 'url' => url }
+    end
+
     # What a rejected write does instead: the form again, with the message over it and
     # the errors beside the fields that earned them.
     def rejected(record, page, message)

data/app/controllers/recourse/base_controller.rb

@@ -36,12 +36,11 @@ module Recourse
     def create
       record = assign resource_class.new
       record.assign_attributes resource_params
-      model = human_name
 
       if create_resource record
-        wrote t('recourse.created', model: model), record
+        wrote t('recourse.created', record: Recourse.record_title(record)), record
       else
-        rejected record, :new, t('recourse.created_error', model: model)
+        rejected record, :new, t('recourse.created_error', model: human_name)
       end
     end
 
@@ -54,7 +53,7 @@ module Recourse
     # Saves changes to a record, then shows the index again or says what turned it down.
     def update
       if update_resource @recourse
-        wrote t('recourse.updated', model: human_name), @recourse
+        wrote t('recourse.updated', record: Recourse.record_title(@recourse)), @recourse
       else
         rejected @recourse, :edit, t('recourse.updated_error', model: human_name)
       end

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

@@ -3,7 +3,8 @@
       page snapshot on every Back, announcing a save that happened a page ago. -%>
   <%# The row a write landed on rides here rather than on a toast: this exists once
       per page, `hidden.bs.toast` bubbles up to it from whichever toast hides, and
-      `data-turbo-temporary` already takes the whole thing away on a Back. -%>
+      `data-turbo-temporary` already takes the whole thing away on a Back. The same
+      key carries the record's words and its page, which the notice below links. -%>
   <div class='toast-container position-fixed bottom-0 end-0 p-3' data-turbo-temporary
        <%= tag.attributes data: written_data %>>
     <%# Every key here becomes a toast, whoever invented it — so the one carrying the
@@ -16,7 +17,7 @@
            data-controller='toast'
            data-action='mouseenter->toast#stopTimer mouseleave->toast#startTimer focusin->toast#stopTimer focusout->toast#startTimer'>
         <div class='toast-header border-0'>
-          <span class='me-auto'><%= message %></span>
+          <span class='me-auto'><%= written_message key, message %></span>
           <button type='button' class='btn-close' data-bs-dismiss='toast' aria-label='Close'></button>
         </div>
         <div class='toast-body d-none'></div>

data/config/locales/recourse.en.yml

@@ -20,7 +20,7 @@ en:
     clear: Clear search
     compact: Compact
     create: Create
-    created: "%{model} was created."
+    created: "%{record} was created."
     created_error: "%{model} could not be created."
     darken: Dark
     delete: Delete %{model}
@@ -65,7 +65,7 @@ en:
       blue. It cannot be %{color}."
     unknown_theme: "`Recourse.theme` is one of %{themes}, or nil for Bootstrap's own
       palette. It cannot be %{theme}."
-    updated: "%{model} was updated."
+    updated: "%{record} was updated."
     updated_error: "%{model} could not be updated."
     unset: None
     deletion:

data/lib/recourse/helpers/flashes.rb

@@ -0,0 +1,36 @@
+module Recourse
+  module Helpers
+    # What a flash message is drawn as: its toast's theme, the row it marks, and the
+    # words it leads somewhere.
+    module Flashes
+      # Bootstrap theme for each flash key, so a notice and an alert read apart.
+      FLASH_THEMES = { 'notice' => 'theme-success', 'alert' => 'theme-danger' }
+
+    private
+
+      # Theme for one flash entry, falling back to a neutral one for a host's key.
+      def flash_theme(key)
+        FLASH_THEMES.fetch key.to_s, 'theme-primary'
+      end
+
+      # What marks the row a write just landed on, and nothing at all on a page no write
+      # brought about — which is every page but the one after a create or an update.
+      def written_data
+        written = flash[Recourse::WRITTEN]
+
+        { controller: 'written', written_row_value: written['row'] } if written.present?
+      end
+
+      # The message with the record it names led to that record's page, where a write
+      # landed on one the routes can show. Spliced around the label rather than rebuilt,
+      # so the flash keeps the plain sentence for whoever else reads it.
+      def written_message(key, message)
+        written = flash[Recourse::WRITTEN]
+        return message unless key.to_s == 'notice' && written&.dig('url')
+
+        before, label, after = message.partition written['label']
+        safe_join [before, label.presence && link_to(label, written['url']), after]
+      end
+    end
+  end
+end

data/lib/recourse/helpers/parents.rb

@@ -58,15 +58,9 @@ module Recourse
       end
 
       def parent_title(parent)
-        # A label is not always words: a numeric one is spoken as a string —
-        # `truncate` has no patience for an Integer — and where a record says
-        # nothing at all, the model's own name stands in, as the delete warning's
-        # title already does.
-        label = parent.attributes[parent.class.recourse_label.to_s]
-
-        # Forty characters of the label, no more: a record named by an address or a
+        # Forty characters of the title, no more: a record named by an address or a
         # sentence would otherwise walk the crumb into the navbar's search form.
-        truncate label.presence&.to_s || parent.class.model_name.human, length: 40
+        truncate Recourse.record_title(parent), length: 40
       end
 
       # One of the parent's own pages, or nil where the host drew no route to it —

data/lib/recourse/helpers/sorts.rb

@@ -10,13 +10,17 @@ module Recourse
       # allows that, and the plain title everywhere else. Only the header row draws
       # the link, so the `data-cell` on every other row stays readable text.
       #
+      # The first click sorts descending, the second back up: the newest, the most
+      # and the latest are what a reader clicks a heading to find.
+      #
       # Named apart from Ransack's `sort_link`, which it calls: sharing the name
       # would take that helper away from every view this gem's controllers render.
       def sort_header(column, title = nil)
         title ||= sort_title column
         return title unless @recourse_headers && sortable_column?(column)
 
-        sort_link resource_search, column.to_sym, hide_indicator: true, page: nil do
+        sort_link resource_search, column.to_sym,
+                  hide_indicator: true, page: nil, default_order: :desc do
           safe_join [title, sort_caret(column)].compact, ' '
         end
       end

data/lib/recourse/helpers.rb

@@ -14,6 +14,7 @@ require_relative 'helpers/details'
 require_relative 'helpers/examples'
 require_relative 'helpers/fields'
 require_relative 'helpers/filters'
+require_relative 'helpers/flashes'
 require_relative 'helpers/formats'
 require_relative 'helpers/inputs'
 require_relative 'helpers/kinds'
@@ -43,7 +44,7 @@ module Recourse
     include Actions, Bookmarks, Buttons, Cards,
             Cells, Choices, Colors, Comboboxes, Constraints, Counters, Deletions, Densities,
             Details,
-            Examples, Fields, Filters, Formats, Inputs, Kinds, Limits,
+            Examples, Fields, Filters, Flashes, Formats, Inputs, Kinds, Limits,
             Names, Navigation, Parents, Pictures, References, Refreshes,
             Routing,
             Resources, Rows, Searches, Shortcuts, Sidebars, Sorts, Tabs, Themes,
@@ -55,24 +56,8 @@ module Recourse
     # show page alone — `.recourse-values` in the layout draws it.
     ROW = 'recourse-row pb-2 mb-3 lg:col-6'
 
-    # Bootstrap theme for each flash key, so a notice and an alert read apart.
-    FLASH_THEMES = { 'notice' => 'theme-success', 'alert' => 'theme-danger' }
-
-    # Theme for one flash entry, falling back to a neutral one for a host's key.
-    def flash_theme(key)
-      FLASH_THEMES.fetch key.to_s, 'theme-primary'
-    end
-
   private
 
-    # What marks the row a write just landed on, and nothing at all on a page no write
-    # brought about — which is every page but the one after a create or an update.
-    def written_data
-      row = flash[Recourse::WRITTEN]
-
-      { controller: 'written', written_row_value: row } if row.present?
-    end
-
     # `?q=anything` arrives as a String, which has no parameters to read — the
     # same test `Recourse::Search` makes, spelled the same way.
     def query_params

data/lib/recourse/titles.rb

@@ -50,6 +50,14 @@ module Recourse
 
       lower ? downcase(title) : title
     end
+
+    # What one record is called: its label, spoken as a string — a numeric one is not
+    # words — or the model's own name where it says nothing at all.
+    def record_title(record)
+      label = record.attributes[record.class.recourse_label.to_s]
+
+      label.presence&.to_s || record.class.model_name.human
+    end
   end
 
   extend Titles

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 = '4.6.5'
+  VERSION = '4.7.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: recourse
 version: !ruby/object:Gem::Version
-  version: 4.6.5
+  version: 4.7.0
 platform: ruby
 authors:
 - claudiob
@@ -208,6 +208,7 @@ files:
 - lib/recourse/helpers/examples.rb
 - lib/recourse/helpers/fields.rb
 - lib/recourse/helpers/filters.rb
+- lib/recourse/helpers/flashes.rb
 - lib/recourse/helpers/formats.rb
 - lib/recourse/helpers/inputs.rb
 - lib/recourse/helpers/kinds.rb