liquid_xlsx 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdc976c8086895374758eae13fd1006379ffd15f37e3cad03cff012be6986065
-  data.tar.gz: de8e167af7057eb7dfad00991610a3171a30a13b67ed2eda1fa43b1f00bd9358
+  metadata.gz: e4a2f29e44a564a50870b6f4c7d066dbb2d648a5ce1031a31115c3087f968710
+  data.tar.gz: d1c8cbddb4f24c831cd7ada7cf5089814b615a72fa1f788828cddefce67a3dcf
 SHA512:
-  metadata.gz: c36433b43abf4b17f5a0fdbdcab009f6fb2a2d6d18c5c1c517c99a02f8a0207be1b3d3c2ba37187f57d96e1279083450666a3036d9281e5e7f9c3fa0f734ab34
-  data.tar.gz: 7c8f204d3284aba334ed3f942b0ee34ac3dde5953ad413d8a9847c5d6b588f1aaf754a82f0ada0cf15af0958b15bb3330f4ad49c917cb20644da4cbc3ff75b1b
+  metadata.gz: 503a440465922dbf924b017ecbd7f7a532ac695a861cffe9cf64fc3ae97603e73a961f645eb20737ac95f93901b62970222d24e20cfc004dc6ec18eeed2ea97e
+  data.tar.gz: 6f4f7399389a693dcd85af3fe4380e706783db5c4034133a4182a1445de4d3979ac535533e36b422aeeb720168cbe6dc0b85768be54a7557459037471c8c8ab5

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.2.0 (unreleased)
+
+### Fixed
+
+- Empty rows omitted from `sheetData` no longer collapse. Spreadsheet
+  applications skip blank rows when writing a sheet, so row numbers arrive with
+  gaps; the renderer used to renumber output rows contiguously and silently
+  dropped that vertical space. Templates that use blank rows as spacers — print
+  forms in particular — drifted upwards, and multi-page documents repaginated.
+  The gaps are now materialized as empty placeholder rows.
+
+### Added
+
+- `filters:` render option — pass a Liquid filter module (or an array of them)
+  to make host-application filters available in every cell. The modules are
+  added to the render context only, so nothing is registered on
+  `Liquid::Environment` and the host's global Liquid config stays untouched.
+
 ## 0.1.0 (2026-08-04)
 
 First public release.

data/README.md

@@ -689,7 +689,8 @@ LiquidXlsx.render(
   hide_control_sheets: true,      # скрывать контрольные листы
   hide_template_sheets: false,    # скрывать листы-шаблоны после клонирования
   images: nil,                    # { loader:, default_dpi: } для {% image_tag %}
-  liquid_resource_limits: nil     # { render_length_limit:, render_score_limit:, ... }
+  liquid_resource_limits: nil,    # { render_length_limit:, render_score_limit:, ... }
+  filters: nil                    # модуль (или массив модулей) со своими Liquid-фильтрами
 )
 ```
 
@@ -703,6 +704,28 @@ LiquidXlsx.render(
 | `hide_template_sheets` | `false`      | Скрывать листы-шаблоны                                  |
 | `images`               | `nil`        | `{ loader:, default_dpi: }` — загрузчик путей и DPI для `width/height` |
 | `liquid_resource_limits` | `nil`      | Лимиты Liquid (`render_length_limit`, `render_score_limit`, `assign_score_limit`) |
+| `filters`              | `nil`        | Модуль или массив модулей со своими фильтрами — см. [Свои фильтры](#свои-фильтры) |
+
+### Свои фильтры
+
+Фильтры приложения подключаются опцией `filters:` и доступны в любой ячейке книги:
+
+```ruby
+module MyFilters
+  def money2(value) = format("%.2f", value.to_f)
+end
+
+LiquidXlsx.render(template: "invoice.xlsx", output: "out.xlsx",
+                  data: data, filters: MyFilters)   # или [MyFilters, DateFilters]
+```
+
+```
+{{ invoice.sum | money2 }}
+```
+
+Модули добавляются только в контекст рендера (`Liquid::Context#add_filters`),
+на `Liquid::Environment` ничего не регистрируется — глобальная конфигурация
+Liquid в приложении остаётся нетронутой.
 
 ## Обработка ошибок
 

data/lib/liquid_xlsx/renderer.rb

@@ -97,6 +97,11 @@ module LiquidXlsx
       end
       liquid_context.strict_variables = strict_vars
       liquid_context.strict_filters = strict_filts
+      # Host-application filters, if any. Scoped to this context — nothing is
+      # registered on Liquid::Environment, so the host's global config is
+      # neither required nor mutated.
+      extra_filters = @options[:filters]
+      liquid_context.add_filters(extra_filters) if extra_filters
       apply_resource_limits(liquid_context)
 
       # Get original merge cells

data/lib/liquid_xlsx/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LiquidXlsx
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/liquid_xlsx/worksheet.rb

@@ -56,6 +56,14 @@ module LiquidXlsx
     end
 
     # Parse rows from the worksheet.
+    #
+    # Spreadsheet applications omit empty rows from sheetData, so row numbers
+    # come with gaps. Those gaps are not nothing: an empty row still takes up
+    # vertical space on the sheet, and templates use them as spacers. Since the
+    # renderer renumbers output rows contiguously, the gaps are materialized
+    # here as empty placeholder rows — otherwise every spacer collapses and the
+    # whole document creeps upwards.
+    #
     # @return [Array<Hash>] rows with :row_number, :row_xml, :cells, :row_attrs
     def parse_rows
       rows = []
@@ -68,6 +76,9 @@ module LiquidXlsx
       @doc.xpath("//xmlns:sheetData/xmlns:row", "xmlns" => ns.href).each do |row_elem|
         row_num = row_elem["r"]&.to_i
         row_num = last_row_num + 1 if row_num.nil? || row_num < 1
+
+        ((last_row_num + 1)...row_num).each { |missing| rows << placeholder_row(missing) }
+
         last_row_num = row_num
         cells = parse_cells(row_elem, row_num)
         rows << {
@@ -80,6 +91,17 @@ module LiquidXlsx
       rows
     end
 
+    # An empty row omitted from sheetData. No attributes — the sheet's
+    # defaultRowHeight applies, exactly as the spreadsheet application shows it.
+    def placeholder_row(row_num)
+      {
+        row_number: row_num,
+        row_xml: nil,
+        cells: [],
+        row_attrs: {}
+      }
+    end
+
     # Get merge cells from the worksheet.
     # @return [Array<Hash>] each: {ref: "A3:B3", start_row:, end_row:}
     def merge_cells

data/lib/liquid_xlsx.rb

@@ -64,13 +64,16 @@ module LiquidXlsx
     # @param images [Hash] image rendering options: { loader:, default_dpi: }
     # @param liquid_resource_limits [Hash, nil] optional Liquid resource limits:
     #   { render_length_limit:, render_score_limit:, assign_score_limit: }
+    # @param filters [Module, Array<Module>, nil] extra Liquid filter modules made
+    #   available to every cell of the workbook. Added to the render context only,
+    #   so nothing is registered globally on Liquid::Environment.
     # rubocop:disable Metrics/ParameterLists
     def render(template:, output:, data:,
                strict_variables: false, strict_filters: false,
                recalculate_formulas: false, remove_template_comments: false,
                dynamic_sheets: false, hide_control_sheets: true,
                hide_template_sheets: false, images: nil,
-               liquid_resource_limits: nil)
+               liquid_resource_limits: nil, filters: nil)
       tpl = Template.new(template, {
                            strict_variables: strict_variables,
                            strict_filters: strict_filters,
@@ -80,7 +83,8 @@ module LiquidXlsx
                            hide_control_sheets: hide_control_sheets,
                            hide_template_sheets: hide_template_sheets,
                            images: images || {},
-                           liquid_resource_limits: liquid_resource_limits
+                           liquid_resource_limits: liquid_resource_limits,
+                           filters: filters
                          })
       # rubocop:enable Metrics/ParameterLists
       tpl.render_to_file(data, output)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: liquid_xlsx
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Ivan Khlipitkin