jekyll-vitepress-theme 1.10.0 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe14ff0d5fdef3e958e33fdb1d0af6325209f095c352b5c7b09e42cc4da38316
-  data.tar.gz: cc2bc43f7102cde80e9dc6b54dbe8834febca38d906dde8aa47b1835275c2068
+  metadata.gz: 31b1b2c1994a774599c9b5612781ac138dc561291572b97a4a2d3a96530618a6
+  data.tar.gz: 85fc67f3109b3e0c8a0964a98604c219c7fb418b4482580802aae6bc056f5adb
 SHA512:
-  metadata.gz: 62f45b83d078559a6065716a1d37170cf53043acbdc568760bef9c94e8c2dc90bc9bc37e070c1d50d4480d9abcc95f8c0ae7b286c7e4576a0ec312c35a2bce91
-  data.tar.gz: 8040cd095339494a138568eeeb021056985f43656c48db23ad4a00489a2a249fd259d79d299178ad2f19923ed79c02ecdc118dfe24f4c217daaa5fc10bd0366e
+  metadata.gz: '099a79e03be5ea69bf4a6d60f5ec0d9c567439f54b75e777f00d2199fc8ca055b3a15bb9d751993f6544b6d2e363ef0d0615adb5d09b8965fa04b7a1cbcf0b9b'
+  data.tar.gz: 5b527894fd9d9a99c5e2521cc9c40aea76507136fa7125915ad10347c503b0bd9570e9d5ba4287d9b975541deac4c3e784141c59e555806fde0a15a43684a13d

data/assets/css/vitepress-overrides.css

@@ -985,7 +985,7 @@ body.vp-search-open {
   height: 100%;
   padding: 18px;
   object-fit: contain;
-  filter: drop-shadow(-2px 4px 6px rgba(0, 0, 0, 0.2));
+  filter: drop-shadow(-2px 4px 6px rgb(0, 0, 0, 0.2));
   transform: translate(-50%, -50%);
 }
 

data/lib/jekyll/vitepress_theme/hooks.rb

@@ -3,7 +3,7 @@ require 'rouge'
 
 module Jekyll
   module VitePressTheme
-    # rubocop:disable Metrics/ModuleLength
+    # rubocop:disable-next Metrics/ModuleLength
     module Sidebar
       module_function
 
@@ -243,7 +243,6 @@ module Jekyll
         )
       end
     end
-    # rubocop:enable Metrics/ModuleLength
 
     module SearchIndex
       module_function
@@ -319,24 +318,6 @@ module Jekyll
       end
     end
 
-    module LastUpdated
-      module_function
-
-      def source_file_time(site, path)
-        return nil unless path
-
-        source_path = if Pathname.new(path).absolute?
-                        path
-                      else
-                        File.join(site.source, path)
-                      end
-
-        return nil unless File.file?(source_path)
-
-        File.mtime(source_path).utc
-      end
-    end
-
     module RougeStyles
       module_function
 

data/lib/jekyll/vitepress_theme/last_updated.rb

@@ -0,0 +1,162 @@
+# frozen_string_literal: true
+
+require 'open3'
+require 'pathname'
+
+module Jekyll
+  module VitePressTheme
+    # Dates each page by the last commit that touched its source file, read
+    # from one `git log` pass per build. Files Git cannot date reliably
+    # (untracked, locally modified, outside the repository, or older than a
+    # shallow clone's history) use their modification time instead.
+    module LastUpdated
+      module_function
+
+      FIELD_SEPARATOR = "\x1e"
+
+      # Git's view of the files under a site source: commit times keyed by
+      # real path, plus the paths whose working copy differs from HEAD.
+      class GitIndex
+        def self.empty
+          new({}, [])
+        end
+
+        def initialize(times, modified)
+          @times = times
+          @modified = modified.to_h { |path| [path, true] }
+        end
+
+        def time_for(path)
+          return nil if @modified.key?(path)
+
+          @times[path]
+        end
+      end
+
+      def source_file_time(site, path)
+        source_path = resolved_source_path(site, path)
+        return nil unless source_path
+
+        git_index(site).time_for(source_path) || File.mtime(source_path).utc
+      end
+
+      # The last commit date alone, or nil where Git cannot date the file.
+      # For uses such as the sitemap, where a build-time file timestamp
+      # would claim a change that never happened.
+      def commit_time(site, path)
+        source_path = resolved_source_path(site, path)
+        source_path && git_index(site).time_for(source_path)
+      end
+
+      def resolved_source_path(site, path)
+        return nil unless path
+
+        source_path = Pathname.new(path).absolute? ? path : File.join(site.source, path)
+        return nil unless File.file?(source_path)
+
+        File.realpath(source_path)
+      end
+
+      def git_index(site)
+        @git_indexes ||= {}
+        @git_indexes[site] ||= build_git_index(site.source)
+      end
+
+      def reset(site)
+        @git_indexes&.delete(site)
+      end
+
+      def build_git_index(source)
+        source = File.realpath(source)
+        root = repository_root(source)
+        return GitIndex.empty unless root
+
+        pathspec = relative_pathspec(source, root)
+        boundaries = shallow_boundaries(root)
+        warn_shallow if boundaries.any?
+
+        GitIndex.new(commit_times(root, pathspec, boundaries), modified_paths(root, pathspec))
+      rescue SystemCallError, ArgumentError => e
+        Jekyll.logger.debug('jekyll-vitepress-theme', "Git dates unavailable: #{e.message}")
+        GitIndex.empty
+      end
+
+      def repository_root(source)
+        root = git(source, 'rev-parse', '--show-toplevel').to_s.strip
+        root.empty? ? nil : File.realpath(root)
+      end
+
+      def relative_pathspec(source, root)
+        Pathname.new(source).relative_path_from(Pathname.new(root)).to_s
+      end
+
+      def commit_times(root, pathspec, boundaries)
+        log = git(root, 'log', '--no-renames', "--format=#{FIELD_SEPARATOR}%H %ct", '--name-only', '-z', '--', pathspec)
+        return {} unless log
+
+        log.split(FIELD_SEPARATOR).each_with_object({}) do |entry, times|
+          sha, time, files = parse_log_entry(entry)
+          next if files.empty? || boundaries.include?(sha)
+
+          files.each do |file|
+            path = File.join(root, file)
+            times[path] = time if times[path].nil? || time > times[path]
+          end
+        end
+      end
+
+      def parse_log_entry(entry)
+        header, files = entry.split("\0", 2)
+        sha, timestamp = header.to_s.split
+        return [sha, nil, []] if files.nil?
+
+        [sha, Time.at(Integer(timestamp)).utc, files.delete_prefix("\n").split("\0").reject(&:empty?)]
+      end
+
+      def modified_paths(root, pathspec)
+        status = git(root, 'status', '--porcelain=v1', '-z', '--untracked-files=no', '--', pathspec)
+        return [] unless status
+
+        entries = status.split("\0")
+        paths = []
+        until entries.empty?
+          entry = entries.shift
+          paths << File.join(root, entry[3..])
+          entries.shift if entry.start_with?('R', 'C')
+        end
+        paths
+      end
+
+      def shallow_boundaries(root)
+        return [] unless git(root, 'rev-parse', '--is-shallow-repository')&.strip == 'true'
+
+        shallow_file = git(root, 'rev-parse', '--git-path', 'shallow')&.strip
+        return [] unless shallow_file
+
+        shallow_file = File.expand_path(shallow_file, root)
+        return [] unless File.file?(shallow_file)
+
+        File.read(shallow_file).split
+      end
+
+      def warn_shallow
+        Jekyll.logger.warn(
+          'jekyll-vitepress-theme',
+          'Shallow Git clone: pages last changed before the clone\'s history use their file ' \
+          'modification time for "Last updated". Fetch the full history (fetch-depth: 0) for accurate dates.'
+        )
+      end
+
+      def git(directory, *args)
+        output, status = Open3.capture2('git', '-C', directory, *args, err: File::NULL)
+        status.success? ? output : nil
+      rescue SystemCallError
+        nil
+      end
+    end
+  end
+end
+
+Jekyll::Hooks.register :site, :after_reset do |site|
+  Jekyll::VitePressTheme::LastUpdated.reset(site)
+end

data/lib/jekyll/vitepress_theme/llms.rb

@@ -4,7 +4,7 @@ module Jekyll
   module VitePressTheme
     # Generates the proposed llms.txt index and its full-text companion from
     # the same canonical, indexable content used by the theme's SEO layer.
-    # rubocop:disable Metrics/AbcSize, Metrics/ModuleLength
+    # rubocop:disable-next Metrics/AbcSize, Metrics/ModuleLength
     module LLMS
       module_function
 
@@ -231,6 +231,5 @@ module Jekyll
         value.is_a?(Hash) ? value : {}
       end
     end
-    # rubocop:enable Metrics/AbcSize, Metrics/ModuleLength
   end
 end

data/lib/jekyll/vitepress_theme/markdown_export.rb

@@ -11,7 +11,7 @@ module Jekyll
     # the exported .md files, and llms-full.txt all share it. Fenced code
     # blocks and code spans pass through untouched, and a page without HTML
     # comes back unchanged.
-    # rubocop:disable Metrics/AbcSize, Metrics/ModuleLength
+    # rubocop:disable-next Metrics/AbcSize, Metrics/ModuleLength
     module MarkdownExport
       module_function
 
@@ -277,7 +277,7 @@ module Jekyll
       def dedent(text)
         lines = text.split("\n", -1)
         indents = lines.drop(1).reject { |line| line.strip.empty? || line.match?(/\A[ \t]*#{BLOCK_CODE_PATTERN.source}/) }
-                               .map { |line| line[/\A[ \t]*/].length }
+                       .map { |line| line[/\A[ \t]*/].length }
         indent = indents.min.to_i
         return text if indent.zero?
 
@@ -632,6 +632,5 @@ module Jekyll
         nil
       end
     end
-    # rubocop:enable Metrics/AbcSize, Metrics/ModuleLength
   end
 end

data/lib/jekyll/vitepress_theme/seo.rb

@@ -10,7 +10,7 @@ module Jekyll
     # Generates the metadata shared by the HTML head, sitemap, and robots.txt.
     # Keeping those outputs on one canonical URL resolver prevents contradictory
     # indexing signals across theme consumers.
-    # rubocop:disable Metrics/AbcSize, Metrics/ModuleLength
+    # rubocop:disable-next Metrics/AbcSize, Metrics/ModuleLength
     module SEO
       module_function
 
@@ -388,7 +388,7 @@ module Jekyll
           metadata = item.data['_seo']
           next unless sitemap_candidate?(item, metadata)
 
-          last_modified = metadata['date_modified']
+          last_modified = metadata['date_modified'] || source_modified(item)
           last_modified ||= metadata['date_published'] if posts_document?(item)
           [metadata['canonical_url'], last_modified]
         end
@@ -408,6 +408,13 @@ module Jekyll
         XML
       end
 
+      # Front matter first, then the last commit that touched the page's
+      # source file. Never a build-time file timestamp, which would mark every
+      # page as changed on each build.
+      def source_modified(item)
+        xml_time(item.data['last_updated_at'] || LastUpdated.commit_time(item.site, item.path))
+      end
+
       def robots_txt(site, config, site_url)
         index = config.fetch('index', true) != false
         lines = ['User-agent: *', index ? 'Allow: /' : 'Disallow: /']
@@ -588,6 +595,5 @@ module Jekyll
         CGI.escapeHTML(value.to_s)
       end
     end
-    # rubocop:enable Metrics/AbcSize, Metrics/ModuleLength
   end
 end

data/lib/jekyll/vitepress_theme/version.rb

@@ -1,5 +1,5 @@
 module Jekyll
   module VitePressTheme
-    VERSION = "1.10.0".freeze
+    VERSION = "1.11.0".freeze
   end
 end

data/lib/jekyll-vitepress-theme.rb

@@ -3,4 +3,5 @@ require_relative 'jekyll/vitepress_theme/version'
 require_relative 'jekyll/vitepress_theme/markdown_export'
 require_relative 'jekyll/vitepress_theme/seo'
 require_relative 'jekyll/vitepress_theme/llms'
+require_relative 'jekyll/vitepress_theme/last_updated'
 require_relative 'jekyll/vitepress_theme/hooks'

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-vitepress-theme
 version: !ruby/object:Gem::Version
-  version: 1.10.0
+  version: 1.11.0
 platform: ruby
 authors:
 - Carmine Paolino
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -56,20 +55,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '4.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '6.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '4.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '6.0'
 description: Jekyll VitePress Theme brings VitePress-style documentation UX, search,
   structured metadata, and Jekyll-native extensions to Ruby static sites.
 email:
@@ -177,6 +176,7 @@ files:
 - assets/vendor/turbo.js
 - lib/jekyll-vitepress-theme.rb
 - lib/jekyll/vitepress_theme/hooks.rb
+- lib/jekyll/vitepress_theme/last_updated.rb
 - lib/jekyll/vitepress_theme/llms.rb
 - lib/jekyll/vitepress_theme/markdown_export.rb
 - lib/jekyll/vitepress_theme/seo.rb
@@ -192,7 +192,6 @@ metadata:
   documentation_uri: https://jekyll-vitepress.dev
   bug_tracker_uri: https://github.com/crmne/jekyll-vitepress-theme/issues
   funding_uri: https://github.com/sponsors/crmne
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -207,8 +206,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A polished, SEO-ready VitePress-style documentation theme for Jekyll.
 test_files: []