recourse 4.6.4 → 4.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f86ea378ae4d23917b6c4cecde438da5c1bf741e4c958b8faa7eb6f0869682e
-  data.tar.gz: 338cd85ccd70e4585e7c50fcc51d4046806c1edcb24a3da34f2035d5db95d16e
+  metadata.gz: ba211bbbb2cad39fb435db7af8c982733056778da14b2617ed01616d7b471643
+  data.tar.gz: 3b847c74cb62a88425a882a839fc6d264581ab3f7e8aed661f53e03b184a12ed
 SHA512:
-  metadata.gz: fc45f09204ee74db4be05e77f2e301d4a3212a8ecfeda0aa4921039d6171e50f0fadc60d5799ebb77311a2ed3a67c8da1143c354124344f9b2c2a9cd3b5e787d
-  data.tar.gz: 73f916a5b82b6def467de274e5b94243ea78be8e48bb6c8d79b3bc7887842d0be2bce6a8522ff72c206d5c7b8de47ce4804bb48e1e6042985e7978e2fb2e0b54
+  metadata.gz: 7ba31e2730714820fa039e61ba649fc91e3b944b01703ded5c4a006b52068b0b5dc8997f667481994adb4d4fb4370660b3d2eed5fa0bb882d8307a44b0bc82ab
+  data.tar.gz: 99f83b13ef7fb727d140dcb6fbd44a3abb160fd10b2bd21d441fa4cb609e985463b66e044047503acdb69375645c8dc408ab2559d4faa00d62416a8dea95a9a9

data/CHANGELOG.md

@@ -5,6 +5,26 @@ 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
+
 ## 4.6.4 - 2026-09-08
 
 * [Fix] On a phone the arrows that put the words back reload the page outright: the visit 4.6.1 made to the same address was morphed in place under an index's refresh metas, and Safari drew the sidebar's entries one over the next all the same

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/limits.rb

@@ -1,9 +1,9 @@
 # Reopened for how much of a table a page shows at once.
 module Recourse
-  # Rows to a page, in the order the menu offers them: pagy's own default, and the one
-  # step up for a reader scanning a table rather than reading it. Named once — the
-  # controller checks a cookie against this list, and the menu is drawn from it.
-  LIMITS = [20, 100].freeze
+  # Rows to a page, in the order the menu offers them: a screenful for a reader reading
+  # a table, and the one step up for a reader scanning it. Named once — the controller
+  # checks a cookie against this list, and the menu is drawn from it.
+  LIMITS = [15, 100].freeze
 
   # Where a reader's chosen page size is kept in their browser. A cookie rather than
   # local storage, which the scheme is kept in: pagy runs on the server, and a cookie

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

metadata

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