jekyll-documents 0.7.5 → 0.7.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 649b75500be7e7a3e9c445e1c44cc35c95aef1caed51afba1711a6c9e8463388
-  data.tar.gz: '0382acb5e7cbcad06d0fae9590bab4fba7d9f57abee556d7dbad20eb5cdafdce'
+  metadata.gz: f4997e7c9ae34ce7462c3fd52a46a1e97c74be3fe1871e489a14eff6c80427d0
+  data.tar.gz: f1df13ca930a08fa219b0871a300a67f3b1569ec1e24d0e6f817b713697ae53d
 SHA512:
-  metadata.gz: dd3f001523be128185e881527f38d6c52afd890eafa72569f289f952d066f272eafd3f70b354f9bf234c8d25155bbe66f1c9ab5c9e693fc7265d9886d722e2a8
-  data.tar.gz: d94034fe3aa2a3bac172267f2422cebb76d4c333586d0afd37579dae32e1f498aaa59f98f4e2a45660dc5c91f34d94ff11aaa21790ccfd15034247f90a6cf2a8
+  metadata.gz: adfc57aed564575bd22d4ebe2446331cc3252b6644e0e886b50ebfecdc44a8afa8ba9c305dc95a965d29c3cfd442ba539066d7b05e4fbe7fee521903eb3b9723
+  data.tar.gz: 63336b909cfea4ba2d3fbcd10208e9315261c1b68e5b74fa8c534379b192c75a9dc9e43ef877a2caf3d1db4ae61b59d0c1e2be9a3c3acfe4de93c769cb84dbde

data/CHANGELOG.md

@@ -1,23 +1,66 @@
 # Changelog
 
+## [Unreleased]
+
+## [0.7.7] - 2026-10-06
+
+### Added
+
+- `Jekyll::Documents::Interface.to_h` — the public tag/filter/config/enum
+  surface derived from the code constants and the Liquid tag registry,
+  serialized to a committed `interface.yml` by `rake interface` for
+  downstream tooling (e.g. the jekyll-imgflow-vscode parity spec).
+- `spec/interface_spec.rb` pins code ↔ manifest ↔ docs: a stale
+  `interface.yml`, an unmanifested tag/param/config key, or an
+  undocumented tag/param fails the suite.
+- README coverage for `document_icon alt:`, the `{% latest_documents %}`
+  tag options (`count:`/`category:`), and `documents.include_extensions`.
+
+### Security
+
+- Dev-tooling audit gate: `scripts/npm-audit.mjs` + `.audit-allow.json`
+  replace the bare `npm audit` CI step — patchable transitive deps are
+  forced to fixed versions via `overrides` (smol-toml, katex), and only
+  explicitly allowlisted unpatched advisories are tolerated (braces,
+  dev-only, no patched release).
+
+## [0.7.6] - 2026-09-29
+
+### Added
+
+- Optional document metadata and download-link attribute include hooks in the generated layout
+- README recipe for provider-neutral template customization and optional GoatCounter click events
+
+### Changed
+
+- Bump dev dependencies: simplecov 1.3.1, @playwright/test 1.63.0, markdownlint-cli2 0.23.3 (plus transitive activesupport 8.1.4, regexp_parser 2.13.1, sass-embedded 1.105.0)
+
+### Fixed
+
+- Browser fixture build now invokes `bundle exec jekyll` and surfaces build output on failure — the previous bare `jekyll` invocation silently swallowed a sass-embedded version conflict
+
 ## [0.7.5] - 2026-09-21
 
 ### Changed
+
 - Git hooks now live in `bin/hooks/` as tracked files — `bin/install-hooks.sh` sets `core.hooksPath` so git runs them directly, eliminating drift between committed and installed hooks
 - `.ruby-version` is now the single source for the supported Ruby floor — the gemspec derives `required_ruby_version` from it instead of keeping a separate literal
 - Bump `plaintext` to `~> 0.4`
 - Sync `example/` lockfile with the root bundle (jekyll-documents 0.7.4, bigdecimal 4.1.3, google-protobuf 4.36.2, sass-embedded 1.104.1)
 
 ### Fixed
+
 - `.devin/wiki.json` steering notes updated to `Ruby >= 3.4` and the stale RSpec example count removed (matched the gemspec requirement and current gates)
 - Added `rake version:check_consistency` (wired into `version:pre_release`) — fails the release if `Ruby >= X.Y` literals in tracked docs or `.rubocop.yml`'s `TargetRubyVersion` don't match the `.ruby-version` floor
 
 ## [0.7.4] - 2026-09-18
 
 ### Added
+
 - Added Codecov coverage reporting: CI uploads Cobertura XML (via `simplecov-cobertura`) after the Ruby quality suite, with `codecov.yml` status checks (98% project / 90% patch targets)
 
 ### Changed
+
 - Auto-update `Gemfile.lock` on `rake version:bump` via `bundle lock` (use `SKIP_LOCK=1` to skip)
 - Further reduced `latest_documents.rb` `render` complexity by extracting `resolve_count` and `select_documents`
 - Extracted shared `TagHelpers` module (markup parsing, document collection access, path normalization, HTML escaping) used by `doc_link`, `doc_category`, `document_icon`, and `latest_documents` tags — removes SonarCloud-flagged duplication
@@ -27,12 +70,14 @@
 ## [0.7.3] - 2026-09-10
 
 ### Added
+
 - Added Semgrep CE security scanning with a custom ReDoS detection rule for pre-commit and CI
 - Added CodeFactor code quality analysis badge and integration
 - Added SEMGREP_APP_TOKEN integration for Cloud dashboard sync from CI
 - Added `rake version:pre_release` task for pre-release security gate with FORCE=1 override
 
 ### Changed
+
 - Updated CI to Node.js 26 and current Node 24-based GitHub Actions runtimes
 - Pinned all GitHub Actions to commit SHAs to prevent supply-chain attacks
 - Added cooldown period to Dependabot configuration
@@ -46,16 +91,19 @@
   - `options_parser.rb`: Extracted `read_value` from `parse_options`
 
 ### Fixed
+
 - Replaced dangerous subshell in system spec with Open3.capture2
 
 ## [0.7.2] - 2026-09-09
 
 ### Fixed
+
 - Replaced polynomial-time Liquid tag option regexes with a shared linear-time parser
 
 ## [0.7.1] - 2026-09-09
 
 ### Changed
+
 - Development dependencies now live in `Gemfile`; the gemspec declares runtime dependencies only
 - Removed redundant transitive dependency pins and made `Gemfile` read the exact Ruby version from `.ruby-version`
 - Refreshed compatible locked dependency versions and tracked `Gemfile.lock` for reproducible CI development environments
@@ -64,18 +112,21 @@
 ## [0.7.0] - 2026-09-05
 
 ### Added
+
 - Added stable `source_path`, `category_path`, and `category_slug` document metadata and JSON index fields
 - Added exact `path:` resolution for document and category tags plus explicit category aggregation
 - Added path/date permalink placeholders and full-path-first category mappings
 - Added configurable `warn` or `strict` handling for unresolved and ambiguous tag references
 
 ### Fixed
+
 - Ambiguous tags no longer silently select the first match
 - Duplicate generated permalinks now abort the build and identify every conflicting source file
 
 ## [0.6.1] - 2026-09-03
 
 ### Changed
+
 - Text extraction cache keys now include the source digest, extraction configuration, Plaintext version, and cache schema version so configuration or extractor changes invalidate stale results
 - Extracted document content now retains searchable metadata for title, category, file type, and date
 - Text cache cleanup now preserves shared digest files and removes orphaned files safely
@@ -86,30 +137,35 @@
 - Removed redundant package metadata and duplicate development dependency declarations
 
 ### Fixed
+
 - Replaced use of the private ActiveSupport deprecation API with the public `ActiveSupport.deprecator` API
 - Empty extraction results now fall back to metadata-only searchable content
 - Manifest loading now validates entries, logs filesystem read failures, and resets dirty state after successful saves
 - Updated stale CI, development, cache-cleanup, and package-lock documentation
 
 ### Tests
+
 - Added real PDF extraction coverage and stronger cache-hit/persistence assertions
 - Added tests for cache configuration invalidation, UTF-8 byte truncation, shared cache references, orphan cleanup, and conditional cache exclusion
 
 ## [0.6.0] - 2026-08-27
 
 ### Added
+
 - Auto-inject `file_type`, `icon_url`, and `icon_set` into jekyll-client-search's `passthrough_fields` config when `documents` is in the search collections — zero extra config needed for icons in search results
 - Documented field renaming in jekyll-client-search for integration with other search conventions
 - Framework-agnostic CSS file (`assets/css/documents.css`) with icon scaling utility classes (`icon-x1` through `icon-x9`: 16px to 512px) — no dependency on Bulma, Bootstrap, or Tailwind
 - Icons default to `1em` (line-height) so they scale with surrounding text
 
 ### Changed
+
 - Renamed icon CSS class from `file-icon` to `document-file-icon` to avoid collision with Bulma's `.file-icon` (which uses `display: flex` and breaks inline SVG icons onto a separate line)
 - Inline `1em` sizing added to JS-rendered and folder icons as a fallback when the CSS file is not included
 
 ## [0.5.0] - 2026-08-27
 
 ### Added
+
 - Text extraction from PDF, DOCX, XLSX, PPTX, ODT, ODS, and ODP files via the optional `plaintext` gem, enabling full-text search of document contents through `jekyll-client-search`
 - `extract_text` configuration option to enable text extraction (disabled by default)
 - `text_max_bytes` configuration option to control extracted text truncation (default 500KB)
@@ -120,6 +176,7 @@
 - `plaintext` as a development dependency for testing extraction
 
 ### Changed
+
 - Minimum Ruby version raised from 3.3 to 3.4 (tested on Ruby 3.4.10)
 - RuboCop target version updated from 3.3 to 3.4
 - Updated development dependencies: `rubocop` ~> 1.90, `rubocop-performance` ~> 1.27, `simplecov` ~> 1.1, `rake` ~> 13.4
@@ -130,18 +187,19 @@
 - Suppressed ActiveSupport deprecation warnings from the `plaintext` gem (`String#mb_chars`, deprecated in Rails 8.2)
 
 ### Fixed
+
 - `CHANGELOG.md` file permissions corrected to be world-readable (was `600`, now `644`)
 
 ## [0.4.0] - 2026-08-26
 
 ### Added
+
 - `categories` array baked into each document's data (in addition to the existing singular `category`) for compatibility with search plugins like `jekyll-client-search` that expect the plural Jekyll convention
 - Searchable content string (title, category, file type, date) set as document content so client-side search engines can index uploaded documents
 
 ### Changed
-- Refactored `Generator#generate` by extracting `bake_document_data` and `searchable_content` helper methods to keep method length within RuboCop limits
 
-### Changed
+- Refactored `Generator#generate` by extracting `bake_document_data` and `searchable_content` helper methods to keep method length within RuboCop limits
 - Simplified release workflow to tag-push trigger (`push: tags: v*`) — no manual `gh release create` needed
 - Switched to RubyGems trusted publishing (`rubygems/release-gem@v1` with OIDC)
 - Centralized version in `version.rb` as single source of truth — removed `version` field from `package.json` (was drifted to 0.3.1)
@@ -157,6 +215,7 @@
 ## [0.3.3] - 2026-08-12
 
 ### Added
+
 - `{% doc_link "title" %}` Liquid tag for linking to documents by partial title or slug match (case-insensitive); renders file icon, title, and human-readable file size; supports `text:"custom label"`, `icon:false`, and `size:false` options
 - `{% doc_category "name" %}` Liquid tag for linking to category pages or listing documents by category; supports `text:"label"`, `list:true`, and `limit:N` options
 - `file_size` attribute baked into each document's data at generation time
@@ -166,20 +225,24 @@
 ## [0.3.2] - 2026-08-12
 
 ### Added
+
 - Auto-registration of gem-packaged `_layouts` and `_includes` via a `:site, :after_init` hook so Jekyll discovers the `document` layout and all includes without the gem being declared as a theme; user-provided files always take precedence
 - 7 RSpec examples for `LayoutRegistrar` covering copy, override, idempotency, and hook registration
 
 ### Fixed
+
 - Corrected publish workflow Ruby version from 3.2 to 3.3 to match the gemspec `required_ruby_version` so the gem builds and publishes to RubyGems successfully
 
 ## [0.3.1] - 2026-08-03
 
 ### Added
+
 - Added the context-aware `{% document_icon page %}` Liquid tag for simple icon rendering
 - Added installed-gem system coverage for all supported document types and icon themes
 - Added Playwright browser coverage for search interaction, links, icons, baseurl, and network errors
 
 ### Changed
+
 - Minimum Ruby version raised from `>= 3.2` to `>= 3.3`
 - Updated RuboCop target Ruby version to 3.3
 - Updated compatible development gems, including RuboCop, Reek, RSpec, and Playwright tooling
@@ -187,6 +250,7 @@
 - Added package-content checks to verify the built gem contains runtime templates, icons, JavaScript, and Liquid tags
 
 ### Fixed
+
 - Corrected non-color icon mappings to reference packaged SVG assets
 - Registered packaged icons and search JavaScript for copying during Jekyll builds
 - Made document search respect the configured index path and site base URL
@@ -197,6 +261,7 @@
 - Made Reek failures fail the quality task consistently
 
 ### Verification
+
 - 186 Ruby/system examples passing with 100% Ruby line coverage
 - 3 Playwright browser tests passing
 - 0 RuboCop offenses, 0 Reek warnings, and 0 Bundler Audit vulnerabilities
@@ -204,6 +269,7 @@
 ## [0.3.0] - 2026-07-23
 
 ### Added
+
 - **Baked icon data**: Generator now bakes `icon_url` and `icon_set` into each document's data at build time, eliminating the need for Liquid context in filters
 - **`FileTypeIcons.icon_for` class method**: Allows icon URL resolution without a Liquid context (used by generator)
 - **Search JavaScript wired up**: `_includes/documents_search.html` now loads Lunr.js and `documents-search.js` for out-of-the-box client-side search
@@ -213,6 +279,7 @@
 - **System test for full build pipeline**: End-to-end test covering generator → JSON index → tag rendering
 
 ### Changed
+
 - **Minimum Ruby version**: Bumped from `>= 2.7` to `>= 3.2` (zeitwerk 2.7+ — a Jekyll dependency — requires Ruby >= 3.2)
 - **RuboCop `TargetRubyVersion`**: Updated from `2.7` to `3.2` to match gemspec
 - **Templates use baked icon data**: `latest_documents.html`, `documents_list.html`, `document.html` now use `{{ doc.icon_url }}` instead of the broken `file_type_icon_tag` filter
@@ -227,6 +294,7 @@
 - **Reek**: 0 warnings (7 files inspected)
 
 ### Fixed
+
 - **Icon set config ignored in templates** (High): `file_type_icon_tag` filter never received Liquid context, causing `icon_set` config to be silently ignored — always fell back to `"color"`. Fixed by baking icon URLs into document data at generation time
 - **`rel_path` slicing** (Low): Replaced fragile `path[(site.source.length + 1)..]` with `String#delete_prefix` for robustness
 - **`Date.parse` in `parse_filename`** (Low): Replaced with `Date.new(year, month, day)` using integer-converted regex captures for clarity
@@ -237,6 +305,7 @@
 ## [0.2.0] - 2026-03-12
 
 ### Added
+
 - **Comprehensive code quality tools** (RuboCop, Reek, Bundler Audit, SimpleCov)
 - **98.99% test coverage** with integration tests for Liquid tags
 - **Enhanced release automation** with 10 safety checks and validations
@@ -250,6 +319,7 @@
 - **Post-release verification** with helpful links
 
 ### Changed
+
 - **Consolidated documentation** (README.Development.md combines all dev docs)
 - **Simplified README.md** with KISS approach
 - **Improved Rake tasks** with better organization and help system
@@ -257,12 +327,14 @@
 - **Better error handling** in release scripts
 
 ### Fixed
+
 - **Liquid tag testing** through integration tests (resolves 98% coverage)
 - **Keyword argument compatibility** in filters
 - **Release script safety** with comprehensive validation
 - **Documentation consistency** across all markdown files
 
 ### Development
+
 - **Quality metrics**: 98.99% coverage • 0 vulnerabilities • 3 RuboCop offenses
 - **Release workflow**: Fully automated with rollback capability
 - **Testing**: 79 examples, 0 failures, integration tests for all features
@@ -270,11 +342,13 @@
 ## [0.1.2] - 2026-03-09
 
 ### Added
+
 - **Release automation scripts**
 
 ## [0.1.1] - 2026-03-09
 
 ### Added
+
 - **4 icon sets**: color, lines, minimal, ultra-minimal (configurable)
 - File type icons for 20+ formats (PDF, DOCX, XLSX, etc.)
 - Folder icons for category lists
@@ -287,6 +361,7 @@
 - `icon_set` configuration option
 
 ### Fixed
+
 - Icon URLs (now using actual svgrepo.com icons)
 - XSS vulnerabilities (HTML escaping)
 - Date format standardized to ISO (YYYY-MM-DD)
@@ -294,17 +369,20 @@
 - JavaScript search null safety
 
 ### Changed
+
 - Icons now included in gem (no external dependencies)
 - JSON index includes file_type and extension
 - Search results display icons dynamically
 - Improved documentation and examples
 
 ### Attribution
+
 - Icons from [SVG Repo](https://www.svgrepo.com)
 
 ## [0.1.0] - 2026-03-09
 
 ### Initial Release
+
 - Auto-collection from `assets/documents/`
 - Filename parsing: `YYYY-MM-DD_Title.ext`
 - Category from folder structure

data/README.md

@@ -1,6 +1,7 @@
 # jekyll-documents
+
 [![Status: Active](https://img.shields.io/badge/status-active-success)](https://github.com/gundestrup/jekyll-documents)
-[![Tests](https://github.com/gundestrup/jekyll-documents/actions/workflows/test.yml/badge.svg)](https://github.com/gundestrup/jekyll-documents/actions/workflows/test.yml)
+[![Tests](https://github.com/gundestrup/jekyll-documents/actions/workflows/ci.yml/badge.svg)](https://github.com/gundestrup/jekyll-documents/actions/workflows/ci.yml)
 [![Codecov](https://codecov.io/gh/gundestrup/jekyll-documents/graph/badge.svg)](https://codecov.io/gh/gundestrup/jekyll-documents)
 [![Gem Version](https://img.shields.io/gem/v/jekyll-documents)](https://rubygems.org/gems/jekyll-documents)
 [![Gem Downloads](https://img.shields.io/gem/dt/jekyll-documents)](https://rubygems.org/gems/jekyll-documents)
@@ -34,7 +35,7 @@ documents:
   icon_set: "color"  # color, lines, minimal, ultra-minimal
 ```
 
-```
+```text
 # Add files
 assets/documents/reports/2026-03-01_Annual_Report.pdf
 assets/documents/minutes/2026-02-15_Board_Meeting.docx
@@ -51,7 +52,7 @@ assets/documents/minutes/2026-02-15_Board_Meeting.docx
 
 **Format**: `YYYY-MM-DD_Title.ext`
 
-```
+```text
 assets/documents/reports/2026-03-01_Annual_Report.pdf
 ```
 
@@ -115,13 +116,56 @@ Link mode renders an `<a>` tag to the category page. List mode renders a `<ul>`
 Use `path:` for an exact, case-sensitive category path, `limit:N` to cap the list, and
 `aggregate:true list:true` to explicitly combine repeated short category names.
 
+**List the most recent documents**:
+
+```liquid
+{% latest_documents %}
+{% latest_documents count:3 %}
+{% latest_documents count:3 category:"minutes" %}
+```
+
+`count:` defaults to `latest_default_count` (5); `category:` filters to a single category.
+Unlike `{% include latest_documents.html %}`, the tag reads its defaults from site config.
+
+## Document template customization
+
+The document layout provides two optional include hooks. Both are empty by default, and the
+`LayoutRegistrar` copies them only when the site does not already provide a file with that name:
+
+- `_includes/document_metadata_extra.html` renders inside the document metadata paragraph, after the
+  date and category.
+- `_includes/document_download_attributes.html` renders inside the opening tag of the document
+  download link. It should output zero or more valid HTML attributes, including any leading spaces.
+
+For example, a site can put a downloads label or count display in the metadata include, and add
+analytics attributes to the download link without copying the full document layout. These hooks are
+provider-neutral; the site owns their content and any associated JavaScript.
+
+### Optional GoatCounter click events
+
+If the site loads GoatCounter's `count.js`, it can record clicks on the document-page download link
+using the attributes include. Use a stable, unique event name for each document:
+
+```liquid
+ data-goatcounter-click="download-{{ page.source_path | url_encode | escape }}"
+ data-goatcounter-no-session="1"
+```
+
+`data-goatcounter-no-session="1"` counts repeat clicks by the same visitor. GoatCounter counts a
+click attempt, not a confirmed file transfer. This hook covers the download link on the document
+page only; direct file links in site-authored listings or posts need the same event attributes of
+their own. The gem does not load GoatCounter, fetch event totals, or combine historical baselines.
+Those remain optional site-level analytics behavior.
+
 ## Configuration
 
 ```yaml
 documents:
   root: "assets/documents"
   icon_set: "color"
+  include_extensions: [".pdf", ".docx", ".pptx", ".xlsx", ".odt", ".ods", ".odp"]
   strict_filename: true
+  strict_extensions: true
   resolution_mode: "warn"
 ```
 
@@ -173,6 +217,7 @@ Usage with the `document_icon` tag:
 
 ```liquid
 {% document_icon page class:"document-file-icon icon-x2" %}
+{% document_icon doc alt:"Board minutes" %}
 ```
 
 Or with any `<img>`:
@@ -299,7 +344,7 @@ documents:
 
 Add the cache directory to `.gitignore`:
 
-```
+```text
 .cache/jekyll-documents/
 ```
 
@@ -309,7 +354,7 @@ The `plaintext` gem uses the `rubyzip` Ruby gem for Office formats (no CLI
 tools needed). PDF extraction shells out to a system command:
 
 | Format | Tool |
-|--------|------|
+| -------- | ------ |
 | PDF | `pdftotext` (poppler-utils) |
 | DOCX/PPTX/XLSX | rubyzip (Ruby gem, no CLI needed) |
 | ODT/ODS/ODP | rubyzip (Ruby gem, no CLI needed) |

data/_layouts/document.html

@@ -7,12 +7,12 @@ layout: default
     <h1>{{ page.title }}</h1>
     <p class="document-meta">
       <strong>Date:</strong> {{ page.date | date: "%Y-%m-%d" }}<br>
-      <strong>Category:</strong> {{ page.category }}
+      <strong>Category:</strong> {{ page.category }}{% include document_metadata_extra.html %}
     </p>
   </header>
 
   <p>
-    <a href="{{ page.file_url | relative_url }}" class="document-download">
+    <a href="{{ page.file_url | relative_url }}" class="document-download"{% include document_download_attributes.html %}>
       {% document_icon page %}
       Download ({{ page.extension | remove: "." | upcase }})
     </a>

data/interface.yml

@@ -0,0 +1,61 @@
+# Generated by `rake interface` — do not edit.
+# Public tag/filter/config surface for tooling (editor extensions, doc linters).
+---
+gem: jekyll-documents
+version: 0.7.7
+tags:
+  doc_link:
+    params:
+    - icon
+    - path
+    - size
+    - text
+  doc_category:
+    params:
+    - aggregate
+    - limit
+    - list
+    - path
+    - text
+  document_icon:
+    params:
+    - alt
+    - class
+  latest_documents:
+    params:
+    - category
+    - count
+filters:
+- documents_slugify
+- documents_title_from_filename
+- file_type_icon
+- file_type_icon_tag
+config:
+  documents:
+  - categories_from_path
+  - category_map
+  - extract_text
+  - icon_set
+  - include_extensions
+  - json_index
+  - json_index_path
+  - latest_default_count
+  - layout
+  - permalink
+  - resolution_mode
+  - root
+  - slug_danish_map
+  - slug_downcase
+  - strict_extensions
+  - strict_filename
+  - text_cache_dir
+  - text_max_bytes
+enums:
+  icon_set:
+  - color
+  - lines
+  - minimal
+  - ultra-minimal
+  resolution_mode:
+  - strict
+  - warn

data/jekyll-documents.gemspec

@@ -31,7 +31,8 @@ Gem::Specification.new do |spec|
     ">= #{File.read(File.expand_path('.ruby-version', __dir__)).strip[/\d+\.\d+/]}"
 
   spec.files         = Dir.glob("{lib,assets,_includes,_layouts}/**/*") +
-                       ["README.md", "CHANGELOG.md", "LICENSE", "jekyll-documents.gemspec"]
+                       ["README.md", "CHANGELOG.md", "LICENSE", "interface.yml",
+                        "jekyll-documents.gemspec"]
   spec.require_paths = ["lib"]
 
   spec.add_dependency "jekyll", ">= 4.4", "< 5.0"

data/lib/jekyll/documents/configuration.rb

@@ -13,7 +13,6 @@ module Jekyll
 
     class Configuration
       RESOLUTION_MODES = %w[warn strict].freeze
-      private_constant :RESOLUTION_MODES
 
       DEFAULTS = {
         "root" => "assets/documents",

data/lib/jekyll/documents/interface.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module Documents
+    # Machine-readable description of the plugin's public interface:
+    # Liquid tags + their options, filters, config keys, and enum values.
+    # `rake interface` writes this as interface.yml (shipped in the gem) so
+    # tooling like editor extensions can consume it without parsing Ruby.
+    module Interface
+      TAG_OPTIONS = {
+        "doc_link" => %w[icon path size text],
+        "doc_category" => %w[aggregate limit list path text],
+        "document_icon" => %w[alt class],
+        "latest_documents" => %w[category count]
+      }.freeze
+
+      FILTERS = %w[
+        documents_slugify
+        documents_title_from_filename
+        file_type_icon
+        file_type_icon_tag
+      ].freeze
+
+      def self.to_h
+        {
+          "gem" => "jekyll-documents",
+          "version" => VERSION,
+          "tags" => TAG_OPTIONS.transform_values { |params| { "params" => params } },
+          "filters" => FILTERS,
+          "config" => { "documents" => Configuration::DEFAULTS.keys.sort },
+          "enums" => {
+            "icon_set" => FileTypeIcons::ICON_MAP.keys.sort,
+            "resolution_mode" => Configuration::RESOLUTION_MODES.sort
+          }
+        }
+      end
+    end
+  end
+end

data/lib/jekyll/documents/version.rb

@@ -2,6 +2,6 @@
 
 module Jekyll
   module Documents
-    VERSION = "0.7.5"
+    VERSION = "0.7.7"
   end
 end

data/lib/jekyll-documents.rb

@@ -20,6 +20,8 @@ require_relative "jekyll/documents/tags/document_icon"
 require_relative "jekyll/documents/tags/doc_link"
 require_relative "jekyll/documents/tags/doc_category"
 
+require_relative "jekyll/documents/interface"
+
 module Jekyll
   module Documents
     # Namespace module for the plugin.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-documents
 version: !ruby/object:Gem::Version
-  version: 0.7.5
+  version: 0.7.7
 platform: ruby
 authors:
 - Svend Gundestrup
@@ -42,6 +42,8 @@ files:
 - LICENSE
 - README.md
 - _includes/category_list.html
+- _includes/document_download_attributes.html
+- _includes/document_metadata_extra.html
 - _includes/documents_list.html
 - _includes/documents_search.html
 - _includes/latest_documents.html
@@ -145,6 +147,7 @@ files:
 - assets/icons/ultra-minimal/xls.svg
 - assets/icons/ultra-minimal/zip.svg
 - assets/js/documents-search.js
+- interface.yml
 - jekyll-documents.gemspec
 - lib/jekyll-documents.rb
 - lib/jekyll/documents/assets_generator.rb
@@ -152,6 +155,7 @@ files:
 - lib/jekyll/documents/file_type_icons.rb
 - lib/jekyll/documents/filters.rb
 - lib/jekyll/documents/generator.rb
+- lib/jekyll/documents/interface.rb
 - lib/jekyll/documents/json_index_generator.rb
 - lib/jekyll/documents/layout_registrar.rb
 - lib/jekyll/documents/options_parser.rb