jekyll-compress-flow 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 00c00c4a18a5ad58211bbaee01455e9973f9e238ce9795e426435405e9caf0ad
-  data.tar.gz: de0178bae5907891dff7f0eb65337df6333b958a5108f1e4f138f229c3776300
+  metadata.gz: 6e5a152c5ea63749b35bd7f707fadc383a54312e61bde7b9bd89b68f8d9d072e
+  data.tar.gz: d3261bba8a601a796cbc016e6b7399983d8098eb4839ff8407e5ce8782c5bbfd
 SHA512:
-  metadata.gz: 98e314c5f525eea612d4c04301c1bbe81fea6e9355820d4c348b60bde68d9d3deb6eee7e1ebdc344da1b316ecccd3cbaab725f9a720505abb3856d764c4ecfc5
-  data.tar.gz: 1dbad2fcdde09b6b07c49b4d6652ea10fa49e7cbdd368ff6bb20c75cd3b0e62dd9869e5d5cd13086cefe1af6eb5de543af0bb3bc69f5a280b8c2315134703685
+  metadata.gz: f8acbb85dd3422bb2ce6247ff85de0458b05b883069e45c6154e3d1f38b2dfa4519de216899754697cdeed086beeb0079516d1e226961175f803140ba4bcd5bd
+  data.tar.gz: a28861fff7a8b4bacf3ae6359934b6fbe24682679d24b1828e5d7aac4b9ad631925831ca7c64268b1b10d892d01de49689cefdabcc2d67820175b3257799aa2c

data/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## 0.2.1 — 2026-10-06
+
+### Added
+
+- `Jekyll::CompressFlow::Interface.to_h` — the config surface
+  (`compress_flow` keys plus `formats:`/`priority:` enums) derived from
+  `DEFAULTS`, serialized to a committed `interface.yml` by
+  `rake interface`; `interface_spec.rb` pins manifest freshness.
+
+### Changed
+
+- Register the compression dispatcher at low priority (10) by default, after
+  normal-priority processing and Fingerprint Flow (default 12); allow per-site
+  `compress_flow.priority` values from 0 through 10.
+
 ## 0.2.0 — 2026-10-03
 
 ### Added

data/README.md

@@ -124,16 +124,22 @@ configured to negotiate them via `Accept-Encoding`:
 ```yaml
 compress_flow:
   enabled: true            # default: Jekyll.env == "production"
+  priority: 10             # integer 0..10; default 10, after fingerprinting
   formats: [br, zst, gz]   # subset of the three; unknown names abort
   extensions: [html, css, js, json, xml, svg, txt, map]
   min_size: 0              # bytes — skip tiny files
   fail_on_error: true      # false: warn + skip instead of failing build
 ```
 
+The post-write dispatcher accepts integer priorities from 0 through 10 so
+site-specific compression remains after the default Fingerprint Flow range
+(11–19).
+
 ## Behavior
 
-- Runs on `:site, :post_write`, after every file is written — works
-  with any generator (pages, posts, feeds, sitemap, search JSON).
+- Runs on `:site, :post_write` at low priority (10), after normal-priority
+  post-processors and the priority-12 Fingerprint Flow pass — works with any
+  generator (pages, posts, feeds, sitemap, search JSON).
 - Compressed siblings are never re-compressed (extensions not in the
   list); images/fonts/PDFs are skipped (already compressed formats).
 - A missing CLI tool aborts the build once per format

data/interface.yml

@@ -0,0 +1,20 @@
+# Generated by `rake interface` — do not edit.
+# Public tag/config surface for tooling (editor extensions, doc linters).
+---
+gem: jekyll-compress-flow
+version: 0.2.1
+tags: {}
+filters: []
+config:
+  compress_flow:
+  - enabled
+  - extensions
+  - fail_on_error
+  - formats
+  - min_size
+  - priority
+enums:
+  formats:
+  - br
+  - gz
+  - zst

data/lib/jekyll/compress_flow/interface.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module CompressFlow
+    # Machine-readable description of the plugin's public interface:
+    # config keys and enum values (this plugin registers no Liquid tags).
+    # `rake interface` writes this as interface.yml (shipped in the gem) so
+    # tooling like editor extensions can consume it without parsing Ruby.
+    module Interface
+      def self.to_h
+        {
+          "gem" => "jekyll-compress-flow",
+          "version" => VERSION,
+          "tags" => {},
+          "filters" => [],
+          "config" => { "compress_flow" => DEFAULTS.keys.sort },
+          "enums" => { "formats" => FORMATS.keys.sort }
+        }
+      end
+    end
+  end
+end

data/lib/jekyll/compress_flow/version.rb

@@ -2,6 +2,6 @@
 
 module Jekyll
   module CompressFlow
-    VERSION = "0.2.0"
+    VERSION = "0.2.1"
   end
 end

data/lib/jekyll/compress_flow.rb

@@ -4,6 +4,7 @@ require "jekyll"
 require "open3"
 
 require_relative "compress_flow/version"
+require_relative "compress_flow/interface"
 
 module Jekyll
   # Generates .br/.zst/.gz siblings for text assets in the build output so a
@@ -23,8 +24,11 @@ module Jekyll
       "gz" => { "tool" => "gzip", "args" => %w[-f -9 -k] }
     }.freeze
 
+    DEFAULT_POST_WRITE_PRIORITY = 10
+    POST_WRITE_PRIORITIES = (0..DEFAULT_POST_WRITE_PRIORITY)
     DEFAULTS = {
       "enabled" => nil, # nil => Jekyll.env == "production"
+      "priority" => DEFAULT_POST_WRITE_PRIORITY,
       "extensions" => %w[html css js json xml svg txt map],
       "formats" => %w[br zst gz],
       "min_size" => 0,
@@ -33,6 +37,14 @@ module Jekyll
 
     module_function
 
+    def post_write_priority(config)
+      priority = config.transform_keys(&:to_s).fetch("priority", DEFAULT_POST_WRITE_PRIORITY)
+      return priority if priority.is_a?(Integer) && POST_WRITE_PRIORITIES.cover?(priority)
+
+      raise Jekyll::Errors::FatalException,
+            "CompressFlow: compress_flow.priority must be an integer from 0 through 10"
+    end
+
     # Entry point — compress all matching files under +dest+.
     # +config+ is the site's `compress_flow:` mapping (string or symbol keys).
     def run(dest, config = {})
@@ -114,6 +126,12 @@ module Jekyll
   end
 end
 
-Jekyll::Hooks.register :site, :post_write do |site|
-  Jekyll::CompressFlow.run(site.dest, site.config["compress_flow"] || {})
+Jekyll::CompressFlow::POST_WRITE_PRIORITIES.each do |hook_priority|
+  registered_priority = hook_priority
+  Jekyll::Hooks.register :site, :post_write, priority: registered_priority do |site|
+    config = site.config["compress_flow"] || {}
+    next unless Jekyll::CompressFlow.post_write_priority(config) == registered_priority
+
+    Jekyll::CompressFlow.run(site.dest, config)
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-compress-flow
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Svend Gundestrup
@@ -42,8 +42,10 @@ files:
 - CHANGELOG.md
 - LICENSE
 - README.md
+- interface.yml
 - lib/jekyll-compress-flow.rb
 - lib/jekyll/compress_flow.rb
+- lib/jekyll/compress_flow/interface.rb
 - lib/jekyll/compress_flow/version.rb
 homepage: https://github.com/gundestrup/jekyll-compress-flow
 licenses: