pagy 7.0.11 → 8.0.1

data/gem/lib/pagy/extras/bootstrap.rb

@@ -0,0 +1,97 @@
+# See the Pagy documentation: https://ddnexus.github.io/pagy/docs/extras/bootstrap
+# frozen_string_literal: true
+
+require 'pagy/extras/js_tools'
+
+class Pagy # :nodoc:
+  # Frontend modules are specially optimized for performance.
+  # The resulting code may not look very elegant, but produces the best benchmarks
+  module BootstrapExtra
+    # Pagination for bootstrap: it returns the html with the series of links to the pages
+    def pagy_bootstrap_nav(pagy, id: nil, classes: 'pagination', aria_label: nil, **vars)
+      id = %( id="#{id}") if id
+      a  = pagy_anchor(pagy)
+
+      html = %(<nav#{id} class="pagy-bootstrap nav" #{nav_aria_label(pagy, aria_label:)}><ul class="#{classes}">#{
+                 bootstrap_prev_html(pagy, a)})
+      pagy.series(**vars).each do |item| # series example: [1, :gap, 7, 8, "9", 10, 11, :gap, 36]
+        html << case item
+                when Integer
+                  %(<li class="page-item">#{a.(item, classes: 'page-link')}</li>)
+                when String
+                  %(<li class="page-item active"><a role="link" class="page-link" aria-current="page" aria-disabled="true">#{
+                      pagy.label_for(item)}</a></li>)
+                when :gap
+                  %(<li class="page-item gap disabled"><a role="link" class="page-link" aria-disabled="true">#{
+                      pagy_t('pagy.gap')}</a></li>)
+                else raise InternalError, "expected item types in series to be Integer, String or :gap; got #{item.inspect}"
+                end
+      end
+      html << %(#{bootstrap_next_html(pagy, a)}</ul></nav>)
+    end
+
+    # Javascript pagination for bootstrap: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_bootstrap_nav_js(pagy, id: nil, classes: 'pagination', aria_label: nil, **vars)
+      sequels = pagy.sequels(**vars)
+      id      = %( id="#{id}") if id
+      a       = pagy_anchor(pagy)
+      tokens  = { 'before'  => %(<ul class="#{classes}">#{bootstrap_prev_html(pagy, a)}),
+                  'a'       => %(<li class="page-item">#{a.(PAGE_TOKEN, LABEL_TOKEN, classes: 'page-link')}</li>),
+                  'current' => %(<li class="page-item active"><a role="link" class="page-link" ) +
+                               %(aria-current="page" aria-disabled="true">#{LABEL_TOKEN}</a></li>),
+                  'gap'     => %(<li class="page-item gap disabled"><a role="link" class="page-link" aria-disabled="true">#{
+                                   pagy_t('pagy.gap')}</a></li>),
+                  'after'   => %(#{bootstrap_next_html pagy, a}</ul>) }
+
+      %(<nav#{id} class="#{'pagy-rjs ' if sequels.size > 1}pagy-bootstrap nav-js" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :nav, tokens, sequels, pagy.label_sequels(sequels))
+        }></nav>)
+    end
+
+    # Javascript combo pagination for bootstrap: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_bootstrap_combo_nav_js(pagy, id: nil, classes: 'pagination', aria_label: nil)
+      id    = %( id="#{id}") if id
+      a     = pagy_anchor(pagy)
+      pages = pagy.pages
+
+      page_input = %(<input name="page" type="number" min="1" max="#{pages}" value="#{pagy.page}" aria-current="page" ) <<
+                   %(style="text-align: center; width: #{pages.to_s.length + 1}rem; padding: 0; ) <<
+                   %(border: none; display: inline-block;" class="page-link active">)
+
+      %(<nav#{id} class="pagy-bootstrap combo-nav-js" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :combo, pagy_url_for(pagy, PAGE_TOKEN))
+        }><ul class="#{classes}">#{
+          bootstrap_prev_html(pagy, a)
+        }<li class="page-item pagy-bootstrap"><label class="page-link">#{
+          pagy_t('pagy.combo_nav_js', page_input:, pages:)
+        }</label></li>#{
+          bootstrap_next_html(pagy, a)
+        }</ul></nav>)
+    end
+
+    private
+
+    def bootstrap_prev_html(pagy, a)
+      if (p_prev = pagy.prev)
+        %(<li class="page-item prev">#{
+            a.(p_prev, pagy_t('pagy.prev'), classes: 'page-link', aria_label: pagy_t('pagy.aria_label.prev'))}</li>)
+      else
+        %(<li class="page-item prev disabled"><a role="link" class="page-link" aria-disabled="true" aria-label="#{
+            pagy_t('pagy.aria_label.prev')}">#{pagy_t('pagy.prev')}</a></li>)
+      end
+    end
+
+    def bootstrap_next_html(pagy, a)
+      if (p_next = pagy.next)
+        %(<li class="page-item next">#{
+            a.(p_next, pagy_t('pagy.next'), classes: 'page-link', aria_label: pagy_t('pagy.aria_label.next'))}</li>)
+      else
+        %(<li class="page-item next disabled"><a role="link" class="page-link" aria-disabled="true" aria-label="#{
+            pagy_t('pagy.aria_label.next')}">#{pagy_t('pagy.next')}</a></li>)
+      end
+    end
+  end
+  Frontend.prepend BootstrapExtra
+end

data/gem/lib/pagy/extras/bulma.rb

@@ -0,0 +1,89 @@
+# See the Pagy documentation: https://ddnexus.github.io/pagy/docs/extras/bulma
+# frozen_string_literal: true
+
+require 'pagy/extras/js_tools'
+
+class Pagy # :nodoc:
+  # Frontend modules are specially optimized for performance.
+  # The resulting code may not look very elegant, but produces the best benchmarks
+  module BulmaExtra
+    # Pagination for bulma: it returns the html with the series of links to the pages
+    def pagy_bulma_nav(pagy, id: nil, classes: 'pagy-bulma nav pagination is-centered', aria_label: nil, **vars)
+      id = %( id="#{id}") if id
+      a  = pagy_anchor(pagy)
+
+      html = %(<nav#{id} class="#{classes}" #{nav_aria_label(pagy, aria_label:)}>)
+      html << bulma_prev_next_html(pagy, a)
+      html << %(<ul class="pagination-list">)
+      pagy.series(**vars).each do |item| # series example: [1, :gap, 7, 8, "9", 10, 11, :gap, 36]
+        html << case item
+                when Integer
+                  %(<li>#{a.(item, pagy.label_for(item), classes: 'pagination-link')}</li>)
+                when String
+                  %(<li><a role="link" class="pagination-link is-current" aria-current="page" aria-disabled="true">#{
+                      pagy.label_for(item)}</a></li>)
+                when :gap
+                  %(<li><span class="pagination-ellipsis">#{pagy_t 'pagy.gap'}</span></li>)
+                else raise InternalError, "expected item types in series to be Integer, String or :gap; got #{item.inspect}"
+                end
+      end
+      html << %(</ul></nav>)
+    end
+
+    # Javascript pagination for bulma: it returns a nav with a data-pagy attribute used by the Pagy.nav javascript
+    def pagy_bulma_nav_js(pagy, id: nil, classes: 'pagy-bulma nav-js pagination is-centered', aria_label: nil, **vars)
+      sequels = pagy.sequels(**vars)
+      id      = %( id="#{id}") if id
+      a       = pagy_anchor(pagy)
+      tokens = { 'before'  => %(#{bulma_prev_next_html(pagy, a)}<ul class="pagination-list">),
+                 'a'       => %(<li>#{a.(PAGE_TOKEN, LABEL_TOKEN, classes: 'pagination-link')}</li>),
+                 'current' => %(<li><a role="link" class="pagination-link is-current" aria-current="page" aria-disabled="true">#{
+                                  LABEL_TOKEN}</a></li>),
+                 'gap'     => %(<li><span class="pagination-ellipsis">#{pagy_t 'pagy.gap'}</span></li>),
+                 'after'   => '</ul>' }
+
+      %(<nav#{id} class="#{'pagy-rjs ' if sequels.size > 1}#{classes}" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :nav, tokens, sequels, pagy.label_sequels(sequels))
+        }></nav>)
+    end
+
+    # Javascript combo pagination for bulma: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_bulma_combo_nav_js(pagy, id: nil, classes: 'pagy-bulma combo-nav-js pagination is-centered', aria_label: nil)
+      id    = %( id="#{id}") if id
+      a     = pagy_anchor(pagy)
+      pages = pagy.pages
+
+      page_input = %(<input name="page" type="number" min="1" max="#{pages}" value="#{pagy.page}" aria-current="page") <<
+                   %(style="text-align: center; width: #{pages.to_s.length + 1}rem; height: 1.7rem; margin:0 0.3rem; ) <<
+                   %(border: none; border-radius: 4px; padding: 0; font-size: 1.1rem; color: white; background-color: #485fc7;">)
+
+      %(<nav#{id} class="#{classes}" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :combo, pagy_url_for(pagy, PAGE_TOKEN))
+        }>#{
+          bulma_prev_next_html(pagy, a)
+        }<ul class="pagination-list"><li class="pagination-link"><label>#{
+           pagy_t('pagy.combo_nav_js', page_input:, pages:)
+        }</label></li></ul></nav>)
+    end
+
+    private
+
+    def bulma_prev_next_html(pagy, a)
+      html = if (p_prev = pagy.prev)
+               a.(p_prev, pagy_t('pagy.prev'), classes: 'pagination-previous', aria_label: pagy_t('pagy.aria_label.prev'))
+             else
+               %(<a role="link" class="pagination-previous" disabled aria-disabled="true" aria-label="#{
+                   pagy_t('pagy.aria_label.prev')}">#{pagy_t 'pagy.prev'}</a>)
+             end
+      html << if (p_next = pagy.next)
+                a.(p_next, pagy_t('pagy.next'), classes: 'pagination-next', aria_label: pagy_t('pagy.aria_label.next'))
+              else
+                %(<a role="link" class="pagination-next" disabled aria-disabled="true" aria-label="#{
+                    pagy_t('pagy.aria_label.next')}">#{pagy_t('pagy.next')}</a>)
+              end
+    end
+  end
+  Frontend.prepend BulmaExtra
+end

data/gem/lib/pagy/extras/foundation.rb

@@ -0,0 +1,93 @@
+# See the Pagy documentation: https://ddnexus.github.io/pagy/docs/extras/foundation
+# frozen_string_literal: true
+
+require 'pagy/extras/js_tools'
+
+class Pagy # :nodoc:
+  # Frontend modules are specially optimized for performance.
+  # The resulting code may not look very elegant, but produces the best benchmarks
+  module FoundationExtra
+    # Pagination for Foundation: it returns the html with the series of links to the pages
+    def pagy_foundation_nav(pagy, id: nil, aria_label: nil, **vars)
+      id = %( id="#{id}") if id
+      a  = pagy_anchor(pagy)
+
+      html = +%(<nav#{id} class="pagy-foundation-nav" #{
+                  nav_aria_label(pagy, aria_label:)}><ul class="pagination"> #{
+                  foundation_prev_html(pagy, a)})
+      pagy.series(**vars).each do |item| # series example: [1, :gap, 7, 8, "9", 10, 11, :gap, 36]
+        html << case item
+                when Integer
+                  %(<li>#{a.(item)}</li>)
+                when String
+                  %(<li class="current" role="link" aria-current="page" aria-disabled="true">#{pagy.label_for(item)}</li>)
+                when :gap
+                  %(<li class="ellipsis gap"></li>)
+                else
+                  raise InternalError, "expected item types in series to be Integer, String or :gap; got #{item.inspect}"
+                end
+      end
+      html << %(#{foundation_next_html(pagy, a)}</ul></nav>)
+    end
+
+    # Javascript pagination for foundation: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_foundation_nav_js(pagy, id: nil, aria_label: nil, **vars)
+      sequels = pagy.sequels(**vars)
+      id      = %( id="#{id}") if id
+      a       = pagy_anchor(pagy)
+      tokens  = { 'before'  => %(<ul class="pagination">#{foundation_prev_html pagy, a}),
+                  'a'       => %(<li>#{a.(PAGE_TOKEN, LABEL_TOKEN)}</li>),
+                  'current' => %(<li class="current" role="link" aria-current="page" aria-disabled="true">#{LABEL_TOKEN}</li>),
+                  'gap'     => %(<li class="ellipsis gap"></li>),
+                  'after'   => %(#{foundation_next_html pagy, a}</ul>) }
+
+      %(<nav#{id} class="#{'pagy-rjs ' if sequels.size > 1}pagy-foundation-nav-js" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :nav, tokens, sequels, pagy.label_sequels(sequels))
+        }></nav>)
+    end
+
+    # Javascript combo pagination for Foundation: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_foundation_combo_nav_js(pagy, id: nil, aria_label: nil)
+      id    = %( id="#{id}") if id
+      a     = pagy_anchor(pagy)
+      pages = pagy.pages
+
+      page_input = %(<input name="page" type="number" min="1" max="#{pages}" value="#{pagy.page}" aria-current="page" ) <<
+                   %(style="text-align: center; width: #{pages.to_s.length + 1}rem; ) <<
+                   %(height: 1.5rem; padding: .5rem; margin: 0 .4rem; font-size: .875rem;" class="current">)
+
+      %(<nav#{id} class="pagy-foundation-combo-nav-js" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :combo, pagy_url_for(pagy, PAGE_TOKEN))
+        }><ul class="pagination">#{
+          foundation_prev_html(pagy, a)
+        }<li style="padding: 0 .3rem"><label style="display: flex; align-items: center; white-space: nowrap">#{
+          pagy_t('pagy.combo_nav_js', page_input:, pages:)
+        }</label></li>#{
+          foundation_next_html(pagy, a)
+        }</ul></nav>)
+    end
+
+    private
+
+    def foundation_prev_html(pagy, a)
+      if (p_prev = pagy.prev)
+        %(<li class="prev">#{a.(p_prev, pagy_t('pagy.prev'), aria_label: pagy_t('pagy.aria_label.prev'))}</li>)
+      else
+        %(<li class="prev disabled" role="link" aria-disabled="true" #{
+            pagy_t('pagy.aria_label.prev')}>#{pagy_t('pagy.prev')}</li>)
+      end
+    end
+
+    def foundation_next_html(pagy, a)
+      if (p_next = pagy.next)
+        %(<li class="next">#{a.(p_next, pagy_t('pagy.next'), aria_label: pagy_t('pagy.aria_label.next'))}</li>)
+      else
+        %(<li class="next disabled" role="link" aria-disabled="true" #{
+             pagy_t('pagy.aria_label.next')}>#{pagy_t('pagy.next')}</li>)
+      end
+    end
+  end
+  Frontend.prepend FoundationExtra
+end

data/{lib → gem/lib}/pagy/extras/items.rb

@@ -1,7 +1,7 @@
 # See the Pagy documentation: https://ddnexus.github.io/pagy/docs/extras/items
 # frozen_string_literal: true
 
-require 'pagy/extras/frontend_helpers'
+require 'pagy/extras/js_tools'
 
 class Pagy # :nodoc:
   DEFAULT[:items_param] = :items
@@ -33,27 +33,30 @@ class Pagy # :nodoc:
 
     # Additions for the Frontend module
     module FrontendAddOn
-      ITEMS_PLACEHOLDER = '__pagy_items__'
+      ITEMS_TOKEN = '__pagy_items__'
 
       # Return the items selector HTML. For example "Show [20] items per page"
-      def pagy_items_selector_js(pagy, pagy_id: nil, item_name: nil, item_i18n_key: nil)
+      def pagy_items_selector_js(pagy, id: nil, item_name: nil)
         return '' unless pagy.vars[:items_extra]
 
-        p_id           = %( id="#{pagy_id}") if pagy_id
-        p_vars         = pagy.vars
-        p_items        = p_vars[:items]
-        p_vars[:items] = ITEMS_PLACEHOLDER
-        url_token      = pagy_url_for(pagy, PAGE_TOKEN)
-        p_vars[:items] = p_items # restore the items
-
-        html  = +%(<span#{p_id} class="pagy pagy-items-selector-js" #{pagy_data(pagy, :selector, pagy.from, url_token)}>)
-        input = %(<input name="items" type="number" min="1" max="#{p_vars[:max_items]}" value="#{
-                    p_items}" style="padding: 0; text-align: center; width: #{p_items.to_s.length + 1}rem;">)
-        html << pagy_t('pagy.items_selector_js',
-                       item_name: item_name || pagy_t(item_i18n_key || p_vars[:item_i18n_key], count: p_items),
-                       items_input: input,
-                       count: p_items)
-        html << %(</span>)
+        id           = %( id="#{id}") if id
+        vars         = pagy.vars
+        items        = vars[:items]
+        vars[:items] = ITEMS_TOKEN
+        url_token    = pagy_url_for(pagy, PAGE_TOKEN)
+        vars[:items] = items # restore the items
+
+        items_input = %(<input name="items" type="number" min="1" max="#{vars[:max_items]}" value="#{
+                         items}" style="padding: 0; text-align: center; width: #{items.to_s.length + 1}rem;">)
+
+        %(<span#{id} class="pagy items-selector-js" #{
+            pagy_data(pagy, :selector, pagy.from, url_token)
+          }><label>#{
+            pagy_t('pagy.items_selector_js',
+                   item_name: item_name || pagy_t('pagy.item_name', count: items),
+                   items_input:,
+                   count: items)
+          }</label></span>)
       end
     end
     Frontend.prepend ItemsExtra::FrontendAddOn

data/{lib/pagy/extras/frontend_helpers.rb → gem/lib/pagy/extras/js_tools.rb}

@@ -4,7 +4,7 @@ class Pagy # :nodoc:
   DEFAULT[:steps] = false # default false will use {0 => @vars[:size]}
 
   # Private module documented in the main classes
-  module FrontendHelpers
+  module JSTools
     # Additions for the Pagy class
     module PagyAddOn
       # `Pagy` instance method used by the `pagy*_nav_js` helpers.

data/gem/lib/pagy/extras/materialize.rb

@@ -0,0 +1,97 @@
+# See the Pagy documentation: https://ddnexus.github.io/pagy/docs/extras/materialize
+# frozen_string_literal: true
+
+require 'pagy/extras/js_tools'
+
+class Pagy # :nodoc:
+  # Frontend modules are specially optimized for performance.
+  # The resulting code may not look very elegant, but produces the best benchmarks
+  module MaterializeExtra
+    # Pagination for materialize: it returns the html with the series of links to the pages
+    def pagy_materialize_nav(pagy, id: nil, aria_label: nil, **vars)
+      id = %( id="#{id}") if id
+      a  = pagy_anchor(pagy)
+
+      html = +%(<div#{id} class="pagy-materialize nav pagination" role="navigation" #{
+                  nav_aria_label(pagy, aria_label:)}><ul class="pagination">#{
+                  materialize_prev_html(pagy, a)})
+      pagy.series(**vars).each do |item| # series example: [1, :gap, 7, 8, "9", 10, 11, :gap, 36]
+        html << case item
+                when Integer
+                  %(<li class="waves-effect">#{a.(item)}</li>)
+                when String
+                  %(<li class="active"><a role="link" aria-current="page" aria-disabled="true">#{pagy.label_for(item)}</a></li>)
+                when :gap
+                  %(<li class="gap disabled"><a role="link" aria-disabled="true">#{pagy_t 'pagy.gap'}</a></li>)
+                else
+                  raise InternalError, "expected item types in series to be Integer, String or :gap; got #{item.inspect}"
+                end
+      end
+      html << %(#{materialize_next_html(pagy, a)}</ul></div>)
+    end
+
+    # Javascript pagination for materialize: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_materialize_nav_js(pagy, id: nil, aria_label: nil, **vars)
+      sequels = pagy.sequels(**vars)
+      id      = %( id="#{id}") if id
+      a = pagy_anchor(pagy)
+
+      tokens = { 'before' => %(<ul class="pagination">#{materialize_prev_html pagy, a}),
+                 'a'      => %(<li class="waves-effect">#{a.(PAGE_TOKEN, LABEL_TOKEN)}</li>),
+                 'current' => %(<li class="active"><a role="link" aria-current="page" aria-disabled="true">#{
+                                  LABEL_TOKEN}</a></li>),
+                 'gap'    => %(<li class="gap disabled"><a role="link" aria-disabled="true">#{pagy_t 'pagy.gap'}</a></li>),
+                 'after'  => %(#{materialize_next_html pagy, a}</ul>) }
+
+      %(<div#{id} class="#{'pagy-rjs ' if sequels.size > 1}pagy-materialize nav-js" role="navigation" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :nav, tokens, sequels, pagy.label_sequels(sequels))
+        }></div>)
+    end
+
+    # Javascript combo pagination for materialize: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_materialize_combo_nav_js(pagy, id: nil, aria_label: nil)
+      id    = %( id="#{id}") if id
+      a     = pagy_anchor(pagy)
+      pages = pagy.pages
+
+      page_input = %(<input name="page" type="number" min="1" max="#{pages}" value="#{pagy.page}" aria-current="page" ) <<
+                   %(style="text-align: center; width: #{pages.to_s.length + 1}rem; height: 1.5rem; font-size: 1.2rem; ) <<
+                   %(border: none; border-radius: 2px; color: white; background-color: #ee6e73;" class="browser-default">)
+
+      %(<ul#{id} class="pagy-materialize combo-nav-js pagination" role="navigation" style="padding-right: 0;" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :combo, pagy_url_for(pagy, PAGE_TOKEN))
+        }>#{
+          materialize_prev_html(pagy, a)
+        }<li style="vertical-align: -webkit-baseline-middle;"><label style="font-size: 1.2rem;">#{
+          pagy_t('pagy.combo_nav_js', page_input:, pages:)
+        }</label></li>#{
+          materialize_next_html(pagy, a)
+        }</ul>)
+    end
+
+    private
+
+    def materialize_prev_html(pagy, a)
+      if (p_prev = pagy.prev)
+        %(<li class="waves-effect prev">#{
+        a.(p_prev, '<i class="material-icons">chevron_left</i>', aria_label: pagy_t('pagy.aria_label.prev'))}</li>)
+      else
+        %(<li class="prev disabled"><a role="link" aria-disabled="true" aria-label="#{
+            pagy_t('pagy.aria_label.prev')}"><i class="material-icons">chevron_left</i></a></li>)
+      end
+    end
+
+    def materialize_next_html(pagy, a)
+      if (p_next = pagy.next)
+        %(<li class="waves-effect next">#{
+            a.(p_next, '<i class="material-icons">chevron_right</i>', aria_label: pagy_t('pagy.aria_label.next'))}</li>)
+      else
+        %(<li class="next disabled"#><a role="link" aria-disabled="true" aria-label="#{
+            pagy_t('pagy.aria_label.next')}><i class="material-icons">chevron_right</i></a></li>)
+      end
+    end
+  end
+  Frontend.prepend MaterializeExtra
+end

data/gem/lib/pagy/extras/pagy.rb

@@ -0,0 +1,82 @@
+# See the Pagy documentation: https://ddnexus.github.io/pagy/docs/extras/pagy
+# frozen_string_literal: true
+
+require 'pagy/extras/js_tools'
+
+class Pagy # :nodoc:
+  # Frontend modules are specially optimized for performance.
+  # The resulting code may not look very elegant, but produces the best benchmarks
+  module PagyExtra
+    # pagy_nav is defined in the Frontend itself
+    # Javascript pagination: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_nav_js(pagy, id: nil, aria_label: nil, **vars)
+      sequels = pagy.sequels(**vars)
+      id      = %( id="#{id}") if id
+      a       = pagy_anchor(pagy)
+      tokens  = { 'before'  => prev_a(pagy, a),
+                  'a'       => a.(PAGE_TOKEN, LABEL_TOKEN),
+                  'current' => %(<a class="current" role="link" aria-current="page" aria-disabled="true">#{
+                                   LABEL_TOKEN}</a>),
+                  'gap'     => %(<a class="gap" role="link" aria-disabled="true">#{pagy_t('pagy.gap')}</a>),
+                  'after'   => next_a(pagy, a) }
+
+      %(<nav#{id} class="#{'pagy-rjs ' if sequels.size > 1}pagy nav-js" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :nav, tokens, sequels, pagy.label_sequels(sequels))
+        }></nav>)
+    end
+
+    # Javascript combo pagination: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_combo_nav_js(pagy, id: nil, aria_label: nil)
+      id    = %( id="#{id}") if id
+      a     = pagy_anchor(pagy)
+      pages = pagy.pages
+
+      page_input = %(<input name="page" type="number" min="1" max="#{pages}" value="#{pagy.page}" aria-current="page" ) <<
+                   %(style="text-align: center; width: #{pages.to_s.length + 1}rem; padding: 0;">)
+
+      %(<nav#{id} class="pagy combo-nav-js" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :combo, pagy_url_for(pagy, PAGE_TOKEN))}>#{
+          prev_a(pagy, a)
+        }<label>#{
+          pagy_t('pagy.combo_nav_js', page_input:, pages:)
+        }</label>#{
+          next_a(pagy, a)
+        }</nav>)
+    end
+
+    # Return the previous page URL string or nil
+    def pagy_prev_url(pagy, absolute: false)
+      pagy_url_for(pagy, pagy.prev, absolute:) if pagy.prev
+    end
+
+    # Return the next page URL string or nil
+    def pagy_next_url(pagy, absolute: false)
+      pagy_url_for(pagy, pagy.next, absolute:) if pagy.next
+    end
+
+    # Return the enabled/disabled previous page anchor tag
+    def pagy_prev_a(pagy, text: pagy_t('pagy.prev'), aria_label: pagy_t('pagy.aria_label.prev'))
+      a = pagy_anchor(pagy)
+      prev_a(pagy, a, text:, aria_label:)
+    end
+
+    # Return the enabled/disabled next page anchor tag
+    def pagy_next_a(pagy, text: pagy_t('pagy.next'), aria_label: pagy_t('pagy.aria_label.prev'))
+      a = pagy_anchor(pagy)
+      next_a(pagy, a, text:, aria_label:)
+    end
+
+    # Conditionally return the previous page link tag
+    def pagy_prev_link(pagy, absolute: false)
+      %(<link href="#{pagy_url_for(pagy, pagy.prev, absolute:)}"/>) if pagy.prev
+    end
+
+    # Conditionally return the next page link tag
+    def pagy_next_link(pagy, absolute: false)
+      %(<link href="#{pagy_url_for(pagy, pagy.next, absolute:)}"/>) if pagy.next
+    end
+  end
+  Frontend.prepend PagyExtra
+end

data/gem/lib/pagy/extras/semantic.rb

@@ -0,0 +1,91 @@
+# See the Pagy documentation: https://ddnexus.github.io/pagy/docs/extras/semantic
+# frozen_string_literal: true
+
+require 'pagy/extras/js_tools'
+
+class Pagy # :nodoc:
+  # Frontend modules are specially optimized for performance.
+  # The resulting code may not look very elegant, but produces the best benchmarks
+  module SemanticExtra
+    # Pagination for semantic: it returns the html with the series of links to the pages
+    def pagy_semantic_nav(pagy, id: nil, aria_label: nil, **vars)
+      id = %( id="#{id}") if id
+      a  = pagy_anchor(pagy)
+
+      html = %(<div#{id} role="navigation" class="pagy-semantic nav ui pagination menu" #{
+                 nav_aria_label(pagy, aria_label:)}>#{semantic_prev_html(pagy, a)})
+      pagy.series(**vars).each do |item| # series example: [1, :gap, 7, 8, "9", 10, 11, :gap, 36]
+        html << case item
+                when Integer
+                  a.(item, pagy.label_for(item), classes: 'item')
+                when String
+                  %(<a role="link" class="item active" aria-current="page" aria-disabled="true">#{pagy.label_for(item)}</a>)
+                when :gap
+                  %(<div class="disabled item">#{pagy_t 'pagy.gap'}</div>)
+                else
+                  raise InternalError, "expected item types in series to be Integer, String or :gap; got #{item.inspect}"
+                end
+      end
+      html << %(#{semantic_next_html(pagy, a)}</div>)
+    end
+
+    # Javascript pagination for semantic: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_semantic_nav_js(pagy, id: nil, aria_label: nil, **vars)
+      sequels = pagy.sequels(**vars)
+      id      = %( id="#{id}") if id
+      a       = pagy_anchor(pagy)
+      tokens  = { 'before'  => semantic_prev_html(pagy, a),
+                  'a'       => a.(PAGE_TOKEN, LABEL_TOKEN, classes: 'item'),
+                  'current' => %(<a role="link" class="item active" aria-current="page" aria-disabled="true">#{LABEL_TOKEN}</a>),
+                  'gap'     => %(<div class="disabled item">#{pagy_t('pagy.gap')}</div>),
+                  'after'   => semantic_next_html(pagy, a) }
+
+      %(<div#{id} class="#{'pagy-rjs ' if sequels.size > 1}pagy-semantic nav-js ui pagination menu" role="navigation" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :nav, tokens, sequels, pagy.label_sequels(sequels))
+        }></div>)
+    end
+
+    # Combo pagination for semantic: it returns a nav with a data-pagy attribute used by the pagy.js file
+    def pagy_semantic_combo_nav_js(pagy, id: nil, aria_label: nil)
+      id    = %( id="#{id}") if id
+      a     = pagy_anchor(pagy)
+      pages = pagy.pages
+
+      page_input = %(<input name="page" type="number" min="1" max="#{pages}" value="#{pagy.page}" aria-current="page") <<
+                   %(style="text-align: center; width: #{pages.to_s.length + 1}rem; padding: 0; margin: 0 0.3rem">)
+
+      %(<div#{id} class="pagy-semantic combo-nav-js ui compact menu" role="navigation" #{
+          nav_aria_label(pagy, aria_label:)} #{
+          pagy_data(pagy, :combo, pagy_url_for(pagy, PAGE_TOKEN))
+        }>#{
+          semantic_prev_html(pagy, a)
+        }<div class="item"><label>#{
+          pagy_t('pagy.combo_nav_js', page_input:, pages:)
+        }</label></div> #{
+          semantic_next_html(pagy, a)
+        }</div>)
+    end
+
+    private
+
+    def semantic_prev_html(pagy, a)
+      if (p_prev = pagy.prev)
+        a.(p_prev, pagy_t('pagy.prev'), classes: 'item', aria_label: pagy_t('pagy.aria_label.prev'))
+      else
+        %(<div class="item disabled" role="a" aria-disabled="true" aria-label="#{
+            pagy_t('pagy.aria_label.prev')}">#{pagy_t('pagy.prev')}</div>)
+      end
+    end
+
+    def semantic_next_html(pagy, a)
+      if (p_next = pagy.next)
+        a.(p_next, pagy_t('pagy.next'), classes: 'item', aria_label: pagy_t('pagy.aria_label.next'))
+      else
+        %(<div class="item disabled" role="link" aria-disabled="true" aria=label="#{
+            pagy_t('pagy.aria_label.prev')}">#{pagy_t('pagy.next')}</div>)
+      end
+    end
+  end
+  Frontend.prepend SemanticExtra
+end

data/gem/lib/pagy/extras/trim.rb

@@ -0,0 +1,29 @@
+# See the Pagy documentation: https://ddnexus.github.io/pagy/docs/extras/trim
+# frozen_string_literal: true
+
+class Pagy # :nodoc:
+  DEFAULT[:trim_extra] = true   # extra enabled by default
+
+  # Remove the page=1 param from the first page link
+  module TrimExtra
+    # Override the original pagy_a_proc.
+    # Call the pagy_trim method for page 1 if the trim_extra is enabled
+    def pagy_anchor(pagy)
+      a_proc = super(pagy)
+      return a_proc unless pagy.vars[:trim_extra]
+
+      lambda do |page, text = pagy.label_for(page), **opts|
+        a = +a_proc.(page, text, **opts)
+        return a unless page.to_s == '1'
+
+        pagy_trim(pagy, a) # in method for isolated testing
+      end
+    end
+
+    # Remove the the :page_param param from the first page anchor
+    def pagy_trim(pagy, a)
+      a.sub!(/[?&]#{pagy.vars[:page_param]}=1\b(?!&)|\b#{pagy.vars[:page_param]}=1&/, '')
+    end
+  end
+  Frontend.prepend TrimExtra
+end