pagy 5.2.3 → 5.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 500b8bfdb84150bd2ec01036eb55b53eeadcb1b0ab1fdc0721cee5fdf7fed46e
-  data.tar.gz: 9a75dbbf42e34e1ef12106e4a567acb408d22600fdb34fd42137a4b0dd61c8f3
+  metadata.gz: 78c55595ac8caaa34c73688103333dc62e9ebb395696725e7c305e5ace3d7f42
+  data.tar.gz: 3e259f8f72025fc7955fb6107920be08025539d5178e5c4c714173d26aa05da1
 SHA512:
-  metadata.gz: 7ee826ffb154387f67275568fef53b557e6b16879017a0658701999bfcb34934322a1c645aa26afc599fa7fc2fbc69743878582d8d5f0d21054609610d49e578
-  data.tar.gz: c0334539b13212ac107aaabab36d2a00460682693e75bab9519b320b2446942a8340f191542cab531ef0de6f9af2df3baf9d74a77b2f2c7154178954428b9616
+  metadata.gz: fede5003b2a686ee972d7dd93a80b5221704518212adb8faa7b133c309b2ece0094f3fbe72575fb4e29b706a819f5dc447fc6f3a89b4c3fe202e23542dfee310
+  data.tar.gz: 15840445b0afa7e343c9f0f4ad196b847cb564d8d2a5da56b94a9a59ac348731fc6bb104c282343f77654a0d07090dd501957e751c843c88de208779581dbbae

data/lib/config/pagy.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Pagy initializer file (5.2.3)
+# Pagy initializer file (5.5.0)
 # Customize only what you really need and notice that Pagy works also without any of the following lines.
 # Should you just cherry pick part of this file, please maintain the require-order of the extras
 
@@ -22,6 +22,7 @@
 # See https://ddnexus.github.io/pagy/api/pagy#other-variables
 # Pagy::DEFAULT[:size]       = [1,4,4,1]                       # default
 # Pagy::DEFAULT[:page_param] = :page                           # default
+# The :params can be also set as a lambda e.g ->(params){ params.exclude('useless').merge!('custom' => 'useful') }
 # Pagy::DEFAULT[:params]     = {}                              # default
 # Pagy::DEFAULT[:fragment]   = '#fragment'                     # example
 # Pagy::DEFAULT[:link_extra] = 'data-remote="true"'            # example
@@ -39,17 +40,30 @@
 # See https://ddnexus.github.io/pagy/extras/array
 # require 'pagy/extras/array'
 
-# Calendar extra: Paginate a collection by calendar Time unit (year, month, week or day)
+# Calendar extra: Add pagination filtering by calendar time unit (Year, Month, Week Day)
 # See https://ddnexus.github.io/pagy/extras/calendar
 # require 'pagy/extras/calendar'
-# Pagy::DEFAULT[:local_minmax] = []          # Min and max local Time period must be set by the user (better not not as default)
-# Pagy::DEFAULT[:unit]         = :month      # Time unit allowed %i[year month week day]
-# Pagy::DEFAULT[:week_offset]  = 0           # Day offset from Sunday (0: Sunday; 1: Monday;... 6: Saturday)
-# Pagy::DEFAULT[:order]         = :asc        # Time direction of pagination
-# Pagy::DEFAULT[:year_format]  = '%Y'        # strftime format for :year unit
-# Pagy::DEFAULT[:month_format] = '%Y-%m'     # strftime format for :month unit
-# Pagy::DEFAULT[:week_format]  = '%Y-%W'     # strftime format for :week unit
-# Pagy::DEFAULT[:day_format]   = '%Y-%m-%d'  # strftime format for :day unit
+# Default for each unit
+# Pagy::Calendar::Year::DEFAULT[:order]   = :asc        # Time direction of pagination
+# Pagy::Calendar::Year::DEFAULT[:format]  = '%Y'        # strftime format
+#
+# Pagy::Calendar::Month::DEFAULT[:order]  = :asc        # Time direction of pagination
+# Pagy::Calendar::Month::DEFAULT[:format] = '%Y-%m'     # strftime format
+#
+# Pagy::Calendar::Week::DEFAULT[:order]   = :asc        # Time direction of pagination
+# Pagy::Calendar::Week::DEFAULT[:format]  = '%Y-%W'     # strftime format
+# Pagy::Calendar::Week::DEFAULT[:offset]  = 0           # Day offset from Sunday (0: Sunday; 1: Monday;... 6: Saturday)
+#
+# Pagy::Calendar::Day::DEFAULT[:order]    = :asc        # Time direction of pagination
+# Pagy::Calendar::Day::DEFAULT[:format]   = '%Y-%m-%d'  # strftime format
+#
+# Uncomment the following block, if you need calendar localization without using the I18n extra
+# module LocalizePagyCalendar
+#   def localize(time, opts)
+#     ::I18n.l(time, **opts)
+#   end
+# end
+# Pagy::Calendar.prepend LocalizePagyCalendar
 
 # Countless extra: Paginate without any count, saving one query per rendering
 # See https://ddnexus.github.io/pagy/extras/countless
@@ -218,6 +232,5 @@
 # Pagy::DEFAULT[:i18n_key] = 'pagy.item_name'   # default
 
 
-# When you are done setting your own defaults freeze it,
-# so it will not changed accidentally
+# When you are done setting your own default freeze it, so it will not get changed accidentally
 Pagy::DEFAULT.freeze

data/lib/javascripts/pagy.js

@@ -1,9 +1,11 @@
 // See the Pagy documentation: https://ddnexus.github.io/pagy/extras#javascript
 
+// This code should be OK also with very old browsers
+
 // Container of the whole pagy stuff
 function Pagy(){}
 
-Pagy.version = '5.2.3'
+Pagy.version = '5.5.0'
 
 // Used by the waitForMe function
 Pagy.delay = 100
@@ -23,10 +25,11 @@ Pagy.init =
 
 // Power the pagy*_nav_js helpers
 Pagy.nav =
-  function(pagyEl, tags, sequels, trimParam) {
-    var lastWidth,
-        pageREg = new RegExp(/__pagy_page__/g),
-        widths  = []
+  function(pagyEl, tags, sequels, label_sequels, trimParam ) {
+    label_sequels = (label_sequels === null) ? sequels : label_sequels
+    var widths = [], lastWidth,
+        fill   = function(string, item, label) { return string.replace(/__pagy_page__/g, item)
+                                                              .replace(/__pagy_label__/g, label) }
     for (var width in sequels) {
       if (sequels.hasOwnProperty(width)) { widths.push(parseInt(width, 10)) }
     }
@@ -40,13 +43,15 @@ Pagy.nav =
         }
         if (width !== lastWidth) {
           var html   = tags.before,
-              series = sequels[width]
+              series = sequels[width],
+              labels = label_sequels[width]
           for (i = 0, len = series.length; i < len; i++) {
-            var item = series[i]
-            if (typeof(trimParam) === 'string' && item === 1) { html += Pagy.trim(tags.link.replace(pageREg, item), trimParam) }
-            else if (typeof(item) === 'number') { html += tags.link.replace(pageREg, item) }
+            var item  = series[i],
+                label = labels[i]
+            if (typeof(trimParam) === 'string' && item === 1) { html += Pagy.trim(fill(tags.link, item, label), trimParam) }
+            else if (typeof(item) === 'number') { html += fill(tags.link, item, label) }
             else if (item === 'gap') { html += tags.gap }
-            else if (typeof(item) === 'string') { html += tags.active.replace(pageREg, item) }
+            else if (typeof(item) === 'string') { html += fill(tags.active, item, label) }
           }
           html += tags.after
           this.insertAdjacentHTML('afterbegin', html)

data/lib/pagy/calendar/day.rb

@@ -0,0 +1,29 @@
+# See Pagy::Countless API documentation: https://ddnexus.github.io/pagy/api/calendar
+# frozen_string_literal: true
+
+class Pagy # :nodoc:
+  class Calendar # :nodoc:
+    # Calendar day subclass
+    class Day < Calendar
+      DEFAULT = { order:  :asc,      # rubocop:disable Style/MutableConstant
+                  format: '%Y-%m-%d' }
+
+      protected
+
+      # Setup the calendar variables
+      def setup_unit_vars
+        super
+        @initial = new_time(@starting.year, @starting.month, @starting.day)
+        @final   = new_time(@ending.year, @ending.month, @ending.day) + DAY
+        @pages   = @last = (@final - @initial).to_i / DAY
+        @from    = time_for(@page)
+        @to      = @from + DAY
+      end
+
+      # Time for the page
+      def time_for(page)
+        @initial + (snap(page) * DAY)
+      end
+    end
+  end
+end

data/lib/pagy/calendar/month.rb

@@ -0,0 +1,44 @@
+# See Pagy::Countless API documentation: https://ddnexus.github.io/pagy/api/calendar
+# frozen_string_literal: true
+
+class Pagy # :nodoc:
+  class Calendar # :nodoc:
+    # Calendar month subclass
+    class Month < Calendar
+      DEFAULT = { order:  :asc,      # rubocop:disable Style/MutableConstant
+                  format: '%Y-%m' }
+
+      protected
+
+      # Setup the calendar variables
+      def setup_unit_vars
+        super
+        @initial = new_time(@starting.year, @starting.month)
+        @final   = bump_month(@ending)
+        @pages   = @last = months(@final) - months(@initial)
+        @from    = time_for(@page)
+        @to      = bump_month(@from)
+      end
+
+      # Time for the page
+      def time_for(page)
+        bump_month(@initial, snap(page))
+      end
+
+      private
+
+      # Months in local time
+      def months(time)
+        (time.year * 12) + time.month
+      end
+
+      # Add 1 or more months to local time
+      def bump_month(time, months = 1)
+        months += months(time)
+        year  = months / 12
+        month = months % 12
+        month.zero? ? new_time(year - 1, 12) : new_time(year, month)
+      end
+    end
+  end
+end

data/lib/pagy/calendar/week.rb

@@ -0,0 +1,39 @@
+# See Pagy::Countless API documentation: https://ddnexus.github.io/pagy/api/calendar
+# frozen_string_literal: true
+
+class Pagy # :nodoc:
+  class Calendar # :nodoc:
+    # Calendar week subclass
+    class Week < Calendar
+      DEFAULT = { order:  :asc,      # rubocop:disable Style/MutableConstant
+                  format: '%Y-%W',
+                  offset: 0 }
+
+      protected
+
+      # Setup the calendar variables
+      def setup_unit_vars
+        setup_vars(offset: 0)
+        super
+        @initial = week_start(@starting)
+        @final   = week_start(@ending) + WEEK
+        @pages   = @last = (@final - @initial).to_i / WEEK
+        @from    = time_for(@page)
+        @to      = @from + WEEK
+      end
+
+      # Time for the page
+      def time_for(page)
+        @initial + (snap(page) * WEEK)
+      end
+
+      private
+
+      # Return the start of the week for local time
+      def week_start(time)
+        start = time - (((time.wday - @offset) * DAY) % WEEK)
+        new_time(start.year, start.month, start.day)
+      end
+    end
+  end
+end

data/lib/pagy/calendar/year.rb

@@ -0,0 +1,29 @@
+# See Pagy::Countless API documentation: https://ddnexus.github.io/pagy/api/calendar
+# frozen_string_literal: true
+
+class Pagy # :nodoc:
+  class Calendar # :nodoc:
+    # Calendar year subclass
+    class Year < Calendar
+      DEFAULT = { order:  :asc,      # rubocop:disable Style/MutableConstant
+                  format: '%Y' }
+
+      protected
+
+      # Setup the calendar variables
+      def setup_unit_vars
+        super
+        @initial = new_time(@starting.year)
+        @final   = new_time(@ending.year + 1)
+        @pages   = @last = @final.year - @initial.year
+        @from    = time_for(@page)
+        @to      = new_time(@from.year + 1)
+      end
+
+      # Time for the page
+      def time_for(page)
+        new_time(@initial.year + snap(page))
+      end
+    end
+  end
+end

data/lib/pagy/calendar.rb

@@ -2,122 +2,68 @@
 # frozen_string_literal: true
 
 require 'pagy'
-require 'date'
 
 class Pagy # :nodoc:
-  DEFAULT[:local_minmax] = []          # Min and max Time period must be set by the user
-  DEFAULT[:unit]         = :month      # Time unit allowed %i[year month week day]
-  DEFAULT[:week_offset]  = 0           # Day offset from Sunday (0: Sunday; 1: Monday;... 6: Saturday)
-  DEFAULT[:order]        = :asc        # Time direction of pagination
-  DEFAULT[:year_format]  = '%Y'        # strftime format for :year unit
-  DEFAULT[:month_format] = '%Y-%m'     # strftime format for :month unit
-  DEFAULT[:week_format]  = '%Y-%W'     # strftime format for :week unit
-  DEFAULT[:day_format]   = '%Y-%m-%d'  # strftime format for :day unit
-
-  # Paginate a Time period by units (year, month, week or day)
+  # Base class for time units subclasses (Year, Month, Week, Day)
   class Calendar < Pagy
-    attr_reader :utc_from, :utc_to, :unit, :week_offset, :order
-    attr_writer :count, :in
+    DAY  = 60 * 60 * 24
+    WEEK = DAY * 7
+
+    attr_reader :order
 
     # Merge and validate the options, do some simple arithmetic and set a few instance variables
     def initialize(vars) # rubocop:disable Lint/MissingSuper
+      raise InternalError, 'Pagy::Calendar is a base class; use one of its subclasses' if instance_of?(Pagy::Calendar)
+
       normalize_vars(vars)
-      setup_vars(page: 1, week_offset: 0)
+      @vars = self.class::DEFAULT.merge(@vars)
+      setup_vars(page: 1)
       setup_unit_vars
+      setup_params_var
       raise OverflowError.new(self, :page, "in 1..#{@last}", @page) if @page > @last
 
       @prev = (@page - 1 unless @page == 1)
       @next = @page == @last ? (1 if @vars[:cycle]) : @page + 1
     end
 
-    # Generate a label for each page, with the specific `Time` period it refers to
-    def page_label(num = @page, format = nil)
-      snap = snap(num.to_i)
-      format ||= @vars[:"#{@unit}_format"]
-      case @unit
-      when :year  then new_time(@initial.year + snap)
-      when :month then bump_month(@initial, snap)
-      when :week  then @initial + (snap * WEEK)
-      when :day   then @initial + (snap * DAY)
-      else raise InternalError, "expected @unit to be in [:year, :month, :week, :day]; got #{@unit.inspect}"
-      end.strftime(format)
+    # The label for the current page (it can pass along the I18n gem opts when it's used with the i18n extra)
+    def label(**opts)
+      label_for(@page, **opts)
     end
 
-    def current_page_label(format = nil)
-      page_label(@page, format)
+    # The label for any page (it can pass along the I18n gem opts when it's used with the i18n extra)
+    def label_for(page, **opts)
+      opts[:format] ||= @vars[:format]
+      localize(time_for(page.to_i), **opts)
     end
 
-    DAY  = 60 * 60 * 24
-    WEEK = DAY * 7
+    # Period of the active page (used for nested units)
+    def active_period
+      [[@starting, @from].max, [@to - DAY, @ending].min] # include only last unit day
+    end
 
     protected
 
+    # Base class method for the setup of the unit variables
     def setup_unit_vars
-      (units = %i[year month week day]).each do |unit|
-        raise VariableError.new(self, :format, 'to be a strftime format', @vars[:"#{unit}_format"]) \
-              unless @vars[:"#{unit}_format"].is_a?(String)
-      end
-      raise VariableError.new(self, :unit, "to be in #{units.inspect}", @unit) \
-            unless units.include?(@unit = @vars[:unit])
+      raise VariableError.new(self, :format, 'to be a strftime format', @vars[:format]) unless @vars[:format].is_a?(String)
       raise VariableError.new(self, :order, 'to be in [:asc, :desc]', @order) \
             unless %i[asc desc].include?(@order = @vars[:order])
 
-      min, max = @vars[:local_minmax]
-      raise VariableError.new(self, :local_minmax, 'to be a an Array of min and max local Time instances', @vars[:local_minmax]) \
-            unless min.is_a?(Time) && max.is_a?(Time) && !min.utc? && !min.utc? && min <= max \
-                   && (@utc_offset = min.utc_offset) == max.utc_offset
-
-      send :"setup_#{@unit}_vars", min, max
-    end
-
-    # IMPORTANT: all the Time objects created and passed as arguments MUST be local!
-
-    # @initial:  beginning of the first day of the period that encloses the min local time
-    # @final:    beginning of the first day of the NEXT period AFTER the period that encloses the max local time
-    # @utc_from: beginning of the first day of the period of the current page as UTC time
-    # @utc_to:   beginning of the first day of the NEXT period AFTER the current page as UTC time
-
-    # Setup the calendar vars when the unit is :year
-    def setup_year_vars(min, max)
-      @initial  = new_time(min.year)
-      @final    = new_time(max.year + 1)
-      @pages    = @last = @final.year - @initial.year
-      @utc_from = new_time(@initial.year + snap).utc
-      @utc_to   = new_time(@initial.year + snap + 1).utc
-    end
-
-    # Setup the calendar vars when the unit is :month
-    def setup_month_vars(min, max)
-      @initial  = new_time(min.year, min.month)
-      @final    = bump_month(max)
-      @pages    = @last = months(@final) - months(@initial)
-      @utc_from = bump_month(@initial, snap).utc
-      @utc_to   = bump_month(@initial, snap + 1).utc
-    end
-
-    # Setup the calendar vars when the unit is :week
-    def setup_week_vars(min, max)
-      @initial  = week_start(min)
-      @final    = week_start(max) + WEEK
-      @pages    = @last = (@final - @initial).to_i / WEEK
-      @utc_from = (@initial + (snap * WEEK)).utc
-      @utc_to   = @utc_from + WEEK
+      @starting, @ending = @vars[:period]
+      raise VariableError.new(self, :period, 'to be a an Array of min and max local Time instances', @vars[:period]) \
+            unless @starting.is_a?(Time) && @ending.is_a?(Time) && !@starting.utc? && !@ending.utc? && @starting <= @ending \
+                   && (@utc_offset = @starting.utc_offset) == @ending.utc_offset
     end
 
-    # Setup the calendar vars when the unit is :day
-    def setup_day_vars(min, max)
-      @initial  = new_time(min.year, min.month, min.day)
-      @final    = new_time(max.year, max.month, max.day) + DAY
-      @pages    = @last = (@final - @initial).to_i / DAY
-      @utc_from = (@initial + (snap * DAY)).utc
-      @utc_to   = @utc_from + DAY
+    # Apply the strftime format to the time (overridden by the i18n extra when localization is required)
+    def localize(time, opts)
+      time.strftime(opts[:format])
     end
 
-    private
-
-    # Simple trick to snap the page into its ordered position,
-    # without actually reordering anything in the internal structure
-    def snap(page = @page)
+    # Simple trick to snap the page into its ordered position, without actually reordering anything in the internal structure.
+    # Tech note: use for @from but not for @to, which must be one period after @from also in :desc order!
+    def snap(page)
       @order == :asc ? page - 1 : @pages - page
     end
 
@@ -125,24 +71,20 @@ class Pagy # :nodoc:
     def new_time(year, month = 1, day = 1)
       Time.new(year, month, day, 0, 0, 0, @utc_offset)
     end
+  end
+  require 'pagy/calendar/year'
+  require 'pagy/calendar/month'
+  require 'pagy/calendar/week'
+  require 'pagy/calendar/day'
 
-    # Months in local time
-    def months(time)
-      (time.year * 12) + time.month
-    end
+  class Calendar # :nodoc:
+    UNITS = { year: Year, month: Month, week: Week, day: Day }.freeze
 
-    # Add 1 or more months to local time
-    def bump_month(time, months = 1)
-      months += months(time)
-      year  = months / 12
-      month = months % 12
-      month.zero? ? new_time(year - 1, 12) : new_time(year, month)
-    end
+    # Create a subclass instance by unit name (internal use)
+    def self.create(unit, vars)
+      raise InternalError, "unit must be in #{UNITS.keys.inspect}; got #{unit}" unless UNITS.key?(unit)
 
-    # Return the start of the week for local time
-    def week_start(time)
-      start = time - (((time.wday - @week_offset) * DAY) % WEEK)
-      new_time(start.year, start.month, start.day)
+      UNITS[unit].new(vars)
     end
   end
 end

data/lib/pagy/countless.rb

@@ -11,6 +11,7 @@ class Pagy
       normalize_vars(vars)
       setup_vars(page: 1, outset: 0)
       setup_items_var
+      setup_params_var
       @offset = (@items * (@page - 1)) + @outset
     end
 
@@ -29,7 +30,7 @@ class Pagy
 
     # Override the original series.
     # Return nil if :countless_minimal is enabled
-    def series(_size = @vars[:size])
+    def series(*)
       super unless @vars[:countless_minimal]
     end
   end

data/lib/pagy/extras/bootstrap.rb

@@ -1,20 +1,20 @@
 # See the Pagy documentation: https://ddnexus.github.io/pagy/extras/bootstrap
 # frozen_string_literal: true
 
-require 'pagy/extras/shared'
+require 'pagy/extras/frontend_helpers'
 
 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, pagy_id: nil, link_extra: '')
+    def pagy_bootstrap_nav(pagy, pagy_id: nil, link_extra: '', **vars)
       p_id = %( id="#{pagy_id}") if pagy_id
       link = pagy_link_proc(pagy, link_extra: %(class="page-link" #{link_extra}))
 
       html = +%(<nav#{p_id} class="pagy-bootstrap-nav" aria-label="pager"><ul class="pagination">)
       html << pagy_bootstrap_prev_html(pagy, link)
-      pagy.series.each do |item| # series example: [1, :gap, 7, 8, "9", 10, 11, :gap, 36]
+      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">#{link.call item}</li>)
@@ -30,17 +30,17 @@ class Pagy # :nodoc:
     end
 
     # Javascript pagination for bootstrap: it returns a nav and a JSON tag used by the Pagy.nav javascript
-    def pagy_bootstrap_nav_js(pagy, pagy_id: nil, link_extra: '', steps: nil)
+    def pagy_bootstrap_nav_js(pagy, pagy_id: nil, link_extra: '', **vars)
       p_id = %( id="#{pagy_id}") if pagy_id
       link = pagy_link_proc(pagy, link_extra: %(class="page-link" #{link_extra}))
       tags = { 'before' => %(<ul class="pagination">#{pagy_bootstrap_prev_html pagy, link}),
-               'link'   => %(<li class="page-item">#{mark = link.call(PAGE_PLACEHOLDER)}</li>),
+               'link'   => %(<li class="page-item">#{mark = link.call(PAGE_PLACEHOLDER, LABEL_PLACEHOLDER)}</li>),
                'active' => %(<li class="page-item active">#{mark}</li>),
                'gap'    => %(<li class="page-item gap disabled"><a href="#" class="page-link">#{pagy_t 'pagy.nav.gap'}</a></li>),
                'after'  => %(#{pagy_bootstrap_next_html pagy, link}</ul>) }
 
       %(<nav#{p_id} class="pagy-njs pagy-bootstrap-nav-js" aria-label="pager" #{
-          pagy_json_attr(pagy, :nav, tags, pagy.sequels(steps))}></nav>)
+        pagy_json_attr(pagy, :nav, tags, (sequels = pagy.sequels(**vars)), pagy.label_sequels(sequels))}></nav>)
     end
 
     # Javascript combo pagination for bootstrap: it returns a nav and a JSON tag used by the Pagy.combo_nav javascript

data/lib/pagy/extras/bulma.rb

@@ -1,26 +1,26 @@
 # See the Pagy documentation: https://ddnexus.github.io/pagy/extras/bulma
 # frozen_string_literal: true
 
-require 'pagy/extras/shared'
+require 'pagy/extras/frontend_helpers'
 
 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, pagy_id: nil, link_extra: '')
+    def pagy_bulma_nav(pagy, pagy_id: nil, link_extra: '', **vars)
       p_id = %( id="#{pagy_id}") if pagy_id
       link = pagy_link_proc(pagy, link_extra: link_extra)
 
       html = +%(<nav#{p_id} class="pagy-bulma-nav pagination is-centered" aria-label="pagination">)
       html << pagy_bulma_prev_next_html(pagy, link)
       html << %(<ul class="pagination-list">)
-      pagy.series.each do |item| # series example: [1, :gap, 7, 8, "9", 10, 11, :gap, 36]
+      pagy.series(**vars).each do |item| # series example: [1, :gap, 7, 8, "9", 10, 11, :gap, 36]
         html << case item
                 when Integer
-                  %(<li>#{link.call item, item, %(class="pagination-link" aria-label="goto page #{item}")}</li>)
+                  %(<li>#{link.call item, pagy.label_for(item), %(class="pagination-link" aria-label="goto page #{item}")}</li>)
                 when String
-                  %(<li>#{link.call item, item,
+                  %(<li>#{link.call item, pagy.label_for(item),
                                     %(class="pagination-link is-current" aria-label="page #{item}" aria-current="page")}</li>)
                 when :gap
                   %(<li><span class="pagination-ellipsis">#{pagy_t 'pagy.nav.gap'}</span></li>)
@@ -30,21 +30,20 @@ class Pagy # :nodoc:
       html << %(</ul></nav>)
     end
 
-    def pagy_bulma_nav_js(pagy, pagy_id: nil, link_extra: '', steps: nil)
+    def pagy_bulma_nav_js(pagy, pagy_id: nil, link_extra: '', **vars)
       p_id = %( id="#{pagy_id}") if pagy_id
       link = pagy_link_proc(pagy, link_extra: link_extra)
       tags = { 'before' => %(#{pagy_bulma_prev_next_html(pagy, link)}<ul class="pagination-list">),
-               'link'   => %(<li>#{link.call PAGE_PLACEHOLDER, PAGE_PLACEHOLDER,
+               'link'   => %(<li>#{link.call PAGE_PLACEHOLDER, LABEL_PLACEHOLDER,
                                              %(class="pagination-link" aria-label="goto page #{PAGE_PLACEHOLDER}")}</li>),
-               'active' => %(<li>#{link.call PAGE_PLACEHOLDER, PAGE_PLACEHOLDER,
+               'active' => %(<li>#{link.call PAGE_PLACEHOLDER, LABEL_PLACEHOLDER,
                                              %(class="pagination-link is-current" aria-current="page" aria-label="page #{
                                                  PAGE_PLACEHOLDER}")}</li>),
                'gap'    => %(<li><span class="pagination-ellipsis">#{pagy_t 'pagy.nav.gap'}</span></li>),
                'after'  => '</ul>' }
 
-      %(<nav#{p_id} class="pagy-njs pagy-bulma-nav-js pagination is-centered" aria-label="pagination" #{pagy_json_attr(
-        pagy, :nav, tags, pagy.sequels(steps)
-      )}></nav>)
+      %(<nav#{p_id} class="pagy-njs pagy-bulma-nav-js pagination is-centered" aria-label="pagination" #{
+        pagy_json_attr(pagy, :nav, tags, (sequels = pagy.sequels(**vars)), pagy.label_sequels(sequels))}></nav>)
     end
 
     # Javascript combo pagination for Bulma: it returns a nav and a JSON tag used by the Pagy.combo_nav javascript