liquid_xlsx 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdc976c8086895374758eae13fd1006379ffd15f37e3cad03cff012be6986065
-  data.tar.gz: de8e167af7057eb7dfad00991610a3171a30a13b67ed2eda1fa43b1f00bd9358
+  metadata.gz: 2962349e5fe1197bffc9c0d28d21be73e83b97f71cf3e8ce86579c07246e5072
+  data.tar.gz: 67d36e10dfaf54790ffd949e175ba80b24940d331eb9e9b826661158b32c08ee
 SHA512:
-  metadata.gz: c36433b43abf4b17f5a0fdbdcab009f6fb2a2d6d18c5c1c517c99a02f8a0207be1b3d3c2ba37187f57d96e1279083450666a3036d9281e5e7f9c3fa0f734ab34
-  data.tar.gz: 7c8f204d3284aba334ed3f942b0ee34ac3dde5953ad413d8a9847c5d6b588f1aaf754a82f0ada0cf15af0958b15bb3330f4ad49c917cb20644da4cbc3ff75b1b
+  metadata.gz: 5f9379732f56d318bb9dba0a0fbf5a9c82e2ec782a97109043eaf6e5272aeb4a2a5eb3b7fa592dbab1d059543ba5dc3dbf3f9fdbc1637bf7c9df42ecacec88ce
+  data.tar.gz: '080cdb56014357ece810afd62e5e42271f7eb403cdcd62cb63697f894b4814b67b6c2959f11dd911dc98099b5be18e715b0cdc1c27b16cbe95c3b92e6862450f'

data/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 0.2.1 (2026-08-09)
+
+### Fixed
+
+- Rendered workbooks are no longer marked ZIP64. Members were streamed without
+  a declared size, and rubyzip 3 — where ZIP64 is on by default — then flagged
+  every member as ZIP64: version 4.5 in the local header and `0xFFFFFFFF`
+  sizes. Such an archive still satisfies rubyzip and `unzip`, but Excel reports
+  a corrupt file and LibreOffice 7.4 fails with "source file could not be
+  loaded", which also broke conversion to PDF. Newer LibreOffice reads ZIP64,
+  so the breakage only surfaced on hosts with an older build. The member size
+  is known at write time and is now declared up front, which keeps ordinary
+  local headers. rubyzip 2.x was never affected: ZIP64 is off by default there.
+
+## 0.2.0 (2026-08-04)
+
+### 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/package.rb

@@ -23,6 +23,17 @@ module LiquidXlsx
       name == :create && %i[key keyreq].include?(type)
     end
 
+    # rubyzip 3 turned ZIP64 on by default. Streaming a member gives it no size
+    # up front, so it marks EVERY member as ZIP64 — version 4.5 in the local
+    # header and 0xFFFFFFFF sizes. Such an .xlsx is rejected by Excel and by
+    # LibreOffice builds without ZIP64 support (7.4 fails, 26.2 reads it).
+    # Here the member content is fully known, so the size can be declared up
+    # front and Entry#prep_local_zip64_extra leaves an ordinary header alone.
+    # rubyzip 2.x has no `size:` keyword, but there ZIP64 is off by default.
+    ZIP_SIZE_KEYWORD = Zip::File.instance_method(:get_output_stream).parameters.any? do |type, name|
+      name == :size && %i[key keyreq].include?(type)
+    end
+
     # Guard rails against zip bombs / resource exhaustion when unpacking.
     MAX_ENTRIES = 10_000
     MAX_ENTRY_UNCOMPRESSED = 512 * 1024 * 1024   # 512 MB per entry
@@ -107,7 +118,7 @@ module LiquidXlsx
         @files.each do |name, content|
           next if content.nil? # directories
 
-          zip.get_output_stream(name) { |f| f.write(content) }
+          write_entry(zip, name, content)
         end
       end
     end
@@ -443,6 +454,17 @@ module LiquidXlsx
 
     private
 
+    # The size is declared in bytes: String#size counts characters, so on UTF-8
+    # content it would disagree with what actually gets written.
+    # See ZIP_SIZE_KEYWORD — rubyzip 2.x has no such keyword and needs none.
+    def write_entry(zip, name, content)
+      if ZIP_SIZE_KEYWORD
+        zip.get_output_stream(name, size: content.bytesize) { |f| f.write(content) }
+      else
+        zip.get_output_stream(name) { |f| f.write(content) }
+      end
+    end
+
     # Open a brand-new archive for writing across rubyzip 2.x and 3.x.
     # See ZIP_CREATE_KEYWORD for why the call has to be spelled two ways.
     def open_new_zip(output_path, &)

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.1"
 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.1
 platform: ruby
 authors:
 - Ivan Khlipitkin