jekyll-vitepress-theme 1.10.0 → 1.10.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe14ff0d5fdef3e958e33fdb1d0af6325209f095c352b5c7b09e42cc4da38316
-  data.tar.gz: cc2bc43f7102cde80e9dc6b54dbe8834febca38d906dde8aa47b1835275c2068
+  metadata.gz: 0fa9bd9f39f9a07a853282a881aff54b24f4adde9c87f9c2f03b89bcafff8617
+  data.tar.gz: 19d2551ffa4497e178771471091d3655dd0678e6cbcd823e79eefd6c617546ef
 SHA512:
-  metadata.gz: 62f45b83d078559a6065716a1d37170cf53043acbdc568760bef9c94e8c2dc90bc9bc37e070c1d50d4480d9abcc95f8c0ae7b286c7e4576a0ec312c35a2bce91
-  data.tar.gz: 8040cd095339494a138568eeeb021056985f43656c48db23ad4a00489a2a249fd259d79d299178ad2f19923ed79c02ecdc118dfe24f4c217daaa5fc10bd0366e
+  metadata.gz: b5041e3e3a4019083374bba8ead0db79724322337d945605168214d3e430ac225c925a2b41040154431fd55da644fdcf0f42c2058daf99d326903f1ea3a77c61
+  data.tar.gz: 87e47129bd88e563ba4187118029c1de8311a7662cc7233432a05a8dc3911013b84c0b930bb582c79dd88bf23ad4d570326b9d93756db22016720f36eed38466

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,154 @@
+# 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
+
+      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
 
@@ -588,6 +588,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.10.1".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,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-vitepress-theme
 version: !ruby/object:Gem::Version
-  version: 1.10.0
+  version: 1.10.1
 platform: ruby
 authors:
 - Carmine Paolino
@@ -56,20 +56,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 +177,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