jekyll-theme-zer0 1.29.0 → 1.31.0

data/scripts/content-review.rb

@@ -348,7 +348,26 @@ def check_quality(body, quality)
 
   # Bare URLs.
   if quality['flag_bare_urls']
-    bare = strip_code_fences(body).scan(%r{(?<![("<\]])\bhttps?://[^\s)>\]]+}).reject { |u| u.include?('](') }
+    # Two sources of false positives this guards against:
+    #   [http://x](http://x) — a CORRECT markdown link whose text is the URL.
+    #     The lookbehind must exclude `[` too, or the link text is counted.
+    #   <script>/<style> blocks and HTML attributes — pages that embed a config
+    #     generator carry URLs in JS strings and markup, which are code, not prose.
+    #   <code>http://…</code> — inline code in HTML syntax, which the markdown
+    #     backtick form is already exempt from; the two should agree.
+    # Stripping markup in ONE pass leaves split or nested tags behind (CodeQL:
+    # incomplete multi-character sanitization). This is prose extraction for
+    # counting, never sanitization for output, but iterate to a fixpoint anyway
+    # so the result is exact. Each pass strictly shortens the string, so it
+    # terminates.
+    prose = strip_code_fences(body)
+    loop do
+      before = prose
+      prose = prose.gsub(%r{<(script|style|code|pre)\b[^>]*>.*?</\1\s*>}mi, ' ')
+                   .gsub(/<[^<>]*>/, ' ')
+      break if prose == before
+    end
+    bare = prose.scan(%r{(?<![("<\[\]])\bhttps?://[^\s)>\]]+}).reject { |u| u.include?('](') }
     issues << Issue.new('info', 'quality', "#{bare.length} bare URL(s) — wrap as [text](url)") unless bare.empty?
   end
   issues

data/scripts/features/install-preview-generator

@@ -262,7 +262,7 @@ update_config() {
 preview_images:
   enabled: true
   provider: ${DEFAULT_PROVIDER}          # renderer: openai, xai, stability, gemini, local
-  model: ""                              # empty = renderer default (gpt-image-2, grok-2-image, ...)
+  model: ""                              # empty = renderer default (gpt-image-2, grok-imagine-image-2.0, ...)
   size: "1536x1024"                      # Landscape banner size
   quality: auto                          # auto for GPT Image; standard/hd for DALL-E 3
   style: "retro pixel art, 8-bit video game aesthetic, vibrant colors, nostalgic, clean pixel graphics"

data/scripts/lib/README.md

@@ -153,6 +153,18 @@ publish_gem "1.2.0"
 create_github_release "1.2.0"
 ```
 
+### 🖼️ `preview_generator.py` - Preview Image Engine
+
+The Python engine behind `scripts/generate-preview-images.sh`. Renderer defaults when `preview_images.model` is empty:
+
+| provider | default model | credential |
+| --- | --- | --- |
+| `openai` (default) | `gpt-image-2` | `OPENAI_API_KEY` |
+| `xai` | `grok-imagine-image-2.0` | `XAI_API_KEY` |
+| `gemini` | `gemini-2.5-flash-image` | `GEMINI_API_KEY` |
+
+Unit specs: `python3 test/test_preview_generator.py`.
+
 ## Testing
 
 Each library has comprehensive unit tests in `scripts/test/lib/`.

data/scripts/lib/preview_generator.py

@@ -24,7 +24,7 @@ Architecture — Claude ORCHESTRATES, an image model RENDERS:
     --------   --------------------------------------   ----------------------------------
     openai     gpt-image-2 / dall-e-3 (+ --enhance      OPENAI_API_KEY
     (default)  via /v1/images/edits)
-    xai        grok-2-image                             XAI_API_KEY
+    xai        grok-imagine-image-2.0                   XAI_API_KEY
     stability  Stable Diffusion XL (v1 API)             STABILITY_API_KEY
     gemini     gemini-2.5-flash-image                   GEMINI_API_KEY
     local      deterministic template SVG → PNG         none (CI-safe; skips
@@ -1688,7 +1688,7 @@ class XAIProvider(Provider):
         return "XAI_API_KEY environment variable is required for the xAI provider"
 
     def default_model(self) -> str:
-        return "grok-2-image"
+        return "grok-imagine-image-2.0"
 
     def generate(self, prompt, settings, out_base, ctx) -> ImageResult:
         model = effective_model(settings, self)

data/scripts/test/integration/mermaid

@@ -142,15 +142,16 @@ test_mermaid_init() {
     local url="$1"
     local description="$2"
     
-    run_test "$description" "curl -s '$url' | grep -q 'mermaid.initialize'"
+    run_test "$description" "curl -s '$url' | grep -q 'mermaid-diagrams.js'"
 }
 
-# Test diagram rendering
+# Test diagram presence (a ```mermaid fence is served as code.language-mermaid;
+# the deferred script turns it into a figure in the browser)
 test_diagram_rendering() {
     local url="$1"
     local description="$2"
-    
-    run_test "$description" "curl -s '$url' | grep -q 'class=\"mermaid\"'"
+
+    run_test "$description" "curl -s '$url' | grep -q 'language-mermaid'"
 }
 
 # Main test execution
@@ -179,16 +180,29 @@ main() {
     # Mermaid include file tests
     log_info "Testing Mermaid include file..."
     
-    test_file_content "_includes/components/mermaid.html" "site.mermaid.src" "Mermaid script from _config (local vendor path)"
-    test_file_content "_includes/components/mermaid.html" "mermaid.initialize" "Mermaid initialization script"
-    test_file_content "_includes/components/mermaid.html" "data-bs-theme" "Bootstrap theme detection configured"
-    test_file_content "_includes/components/mermaid.html" "getMermaidConfig" "Adaptive light/dark theming configured"
+    test_file_content "_includes/components/mermaid.html" "mm.src" "Mermaid script from _config (local vendor path)"
+    test_file_content "_includes/components/mermaid.html" "mermaidConfig" "Diagram config block emitted for the behaviour script"
+    test_file_content "_includes/components/mermaid.html" "mermaid-diagrams.js" "Behaviour script loaded after the vendor bundle"
+    test_file_content "_includes/components/mermaid.html" "defer" "Scripts are deferred (never block parsing)"
+
+    # Behaviour script (assets/js/mermaid-diagrams.js)
+    log_info "Testing diagram behaviour script..."
+
+    test_file_exists "assets/js/mermaid-diagrams.js" "Diagram behaviour script exists"
+    test_file_content "assets/js/mermaid-diagrams.js" "mermaid.initialize" "Mermaid initialization"
+    test_file_content "assets/js/mermaid-diagrams.js" "data-bs-theme" "Colour-mode change observed for re-render"
+    test_file_content "assets/js/mermaid-diagrams.js" "data-theme-skin" "Skin change observed for re-render"
+    test_file_content "assets/js/mermaid-diagrams.js" "themeVariables" "Palette derived into Mermaid theme variables"
+    test_file_content "assets/js/mermaid-diagrams.js" "zer0Mermaid" "Public API exposed"
+    test_file_exists "_sass/components/_mermaid.scss" "Diagram figure styles exist"
+    test_file_content "assets/css/main.scss" "components/mermaid" "Diagram styles imported by the stylesheet manifest"
     
     # Documentation tests
     log_info "Testing documentation..."
     
     test_file_content "pages/_docs/features/mermaid-diagrams.md" "mermaid: true" "Main docs have front matter"
     test_file_content "pages/_docs/features/mermaid-diagrams.md" "graph TD" "Main docs have examples"
+    test_file_content "pages/_docs/features/mermaid-diagrams.md" "accTitle" "Main docs cover accessible captions"
     
     # Server tests (if not quick mode)
     if [ "$QUICK" = false ]; then

data/scripts/test/lib/run_tests.sh

@@ -132,6 +132,7 @@ main() {
     source "$TEST_DIR/test_pixelate_images.sh"
     source "$TEST_DIR/test_content_review.sh"
     source "$TEST_DIR/test_agent_review_result.sh"
+    source "$TEST_DIR/test_visual_evidence_autogen.sh"
 
     # Summary
     echo -e "\n${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"

data/scripts/test/lib/test_visual_evidence_autogen.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+
+# Bridge for scripts/ci/test_visual_evidence_autogen.py (ZER0-085).
+#
+# The planner/decider behind visual-evidence-autogen.yml lives in
+# scripts/ci/visual_evidence_autogen.py, next to the other CI helpers, and its
+# tests are Python beside it. This wrapper puts them on the CI path: run_tests.sh
+# sources this file, and ./scripts/bin/test runs run_tests.sh on every PR — the
+# same arrangement as test_agent_review_result.sh, for the same reason (a test
+# suite no runner invokes rots silently).
+
+VEA_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
+
+print_suite_header "Visual-evidence autogen planner (scripts/ci/visual_evidence_autogen.py)"
+
+if command -v python3 >/dev/null 2>&1; then
+    vea_output="$(python3 "$VEA_ROOT/scripts/ci/test_visual_evidence_autogen.py" 2>&1)"
+    vea_status=$?
+    echo "$vea_output"
+    assert_equals "0" "$vea_status" \
+        "scripts/ci/test_visual_evidence_autogen.py passes (plan/decide/contract guards)"
+else
+    echo "python3 not available — skipping the visual-evidence autogen tests"
+fi

data/scripts/translate.rb

@@ -170,8 +170,30 @@ module Zer0Translate
       masked
     end
 
+    # A masked span can carry a placeholder minted by an earlier pattern: a
+    # Liquid expression inside a link destination (`](⟦3⟧)`), or inside an
+    # inline code span (`` `⟦8⟧` ``). `gsub` never rescans its own replacement
+    # text, so one pass restores the outer span and strands the inner token as
+    # a literal ⟦N⟧ in the published page. Substitute until the text stops
+    # changing — nesting can only run as deep as the pattern list is long — and
+    # refuse to hand back anything still holding a placeholder, so a corrupt
+    # page fails its job instead of shipping.
     def unmask(text)
-      text.gsub(PLACEHOLDER_RE) { |token| @map.fetch(token, token) }
+      result = text
+      (INLINE_PATTERNS.length + 1).times do
+        expanded = result.gsub(PLACEHOLDER_RE) { |token| @map.fetch(token, token) }
+        break if expanded == result
+
+        result = expanded
+      end
+
+      leftover = result.scan(PLACEHOLDER_RE).uniq
+      unless leftover.empty?
+        raise Translator::TranslationError,
+              "unresolved placeholder(s) #{leftover.join(', ')} after unmasking"
+      end
+
+      result
     end
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-zer0
 version: !ruby/object:Gem::Version
-  version: 1.29.0
+  version: 1.31.0
 platform: ruby
 authors:
 - Amr Abdel
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-01 00:00:00.000000000 Z
+date: 2026-10-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -79,6 +79,7 @@ files:
 - README.md
 - _data/README.md
 - _data/ai.yml
+- _data/ai_pricing.yml
 - _data/authors.yml
 - _data/backlog.yml
 - _data/consumers.yml
@@ -109,6 +110,7 @@ files:
 - _data/roadmap_plan.yml
 - _data/routing.yml
 - _data/series.yml
+- _data/site_builder.yml
 - _data/statistics_config.yml
 - _data/theme-manifest.yml
 - _data/theme_backgrounds.yml
@@ -131,6 +133,7 @@ files:
 - _includes/components/author-card.html
 - _includes/components/author-eeat.html
 - _includes/components/background-customizer.html
+- _includes/components/background-image.html
 - _includes/components/background-settings.html
 - _includes/components/book-card.html
 - _includes/components/book-nav.html
@@ -242,6 +245,8 @@ files:
 - _includes/navigation/unified-drawer.html
 - _includes/obsidian/full-graph.html
 - _includes/search-data.json
+- _includes/setup/claude-session.html
+- _includes/setup/prereq-checklist.html
 - _includes/setup/wizard.html
 - _includes/stats/README.md
 - _includes/stats/stats-categories.html
@@ -290,6 +295,7 @@ files:
 - _sass/components/_content-tables.scss
 - _sass/components/_cookie-banner.scss
 - _sass/components/_footer.scss
+- _sass/components/_mermaid.scss
 - _sass/components/_notes-index.scss
 - _sass/components/_notes.scss
 - _sass/components/_page-feedback.scss
@@ -339,6 +345,7 @@ files:
 - _sass/utilities/_layout.scss
 - _sass/utilities/_motion.scss
 - assets/css/custom.css
+- assets/css/extension-points-demo.css
 - assets/css/main.scss
 - assets/css/stats.css
 - assets/css/theme-npm-entry.scss
@@ -356,7 +363,11 @@ files:
 - assets/js/code-copy.js
 - assets/js/config-utility.js
 - assets/js/docs.min.js
+- assets/js/extension-points-demo.js
+- assets/js/fleet-feedback-capture.js
+- assets/js/fleet-feedback.js
 - assets/js/halfmoon.js
+- assets/js/mermaid-diagrams.js
 - assets/js/modules/navigation/config.js
 - assets/js/modules/navigation/focus.js
 - assets/js/modules/navigation/gestures.js
@@ -388,6 +399,7 @@ files:
 - assets/js/setup-wizard.js
 - assets/js/share-actions.js
 - assets/js/side-bar-folders.js
+- assets/js/site-builder.js
 - assets/js/skin-editor.js
 - assets/js/stats.js
 - assets/js/table-copy.js
@@ -433,6 +445,10 @@ files:
 - assets/vendor/mathjax/es5/tex-mml-chtml.js
 - assets/vendor/mermaid/mermaid.min.js
 - scripts/README.md
+- scripts/ai/README.md
+- scripts/ai/api_call.rb
+- scripts/ai/usage.rb
+- scripts/ai/usage_report.rb
 - scripts/analyze-commits.sh
 - scripts/bin/audit-consumer
 - scripts/bin/build
@@ -447,6 +463,8 @@ files:
 - scripts/ci/agent_review_result.py
 - scripts/ci/classify_changes.py
 - scripts/ci/test_agent_review_result.py
+- scripts/ci/test_visual_evidence_autogen.py
+- scripts/ci/visual_evidence_autogen.py
 - scripts/content-review.rb
 - scripts/convert-notebooks.sh
 - scripts/design-system-check.rb
@@ -588,6 +606,7 @@ files:
 - scripts/test/lib/test_pixelate_images.sh
 - scripts/test/lib/test_validation.sh
 - scripts/test/lib/test_version.sh
+- scripts/test/lib/test_visual_evidence_autogen.sh
 - scripts/test/theme/validate
 - scripts/translate.rb
 - scripts/update-preview-paths.sh