yard 0.9.40 → 0.9.41

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f30a7254915dfc58291d8bdbf05f6e65bbb392d9c359bb0df535c5d290dbf2f8
-  data.tar.gz: bd261832603492535a89218415f59c84c3e5c732dd8a0cc25f5a294a0b2c98a5
+  metadata.gz: b498d65eea07bb8fc6b7f6e43b210a66d2a7b37ff19159ca4312d254b006ff36
+  data.tar.gz: be2ebd8ff2e23d88afd7adebeb7520b4ece385c3faac5a564c91eb7137185034
 SHA512:
-  metadata.gz: 132b2b6ea721780a3f36001216fa16aade784e2936d89684249f92c3ddd2180f2820e24c339551ce33405779c627b82bb085978b6f3a785b1450f17204b00d88
-  data.tar.gz: e4410e47b0b7871241611b3328fa2e5219ba5632c4648e3d4f3d5ac66bf54986ac046bae935bc68911d905210159cc1dc70ca6aba0870056aef9ba36f70dbae3
+  metadata.gz: 40cb9115aafad9eb4b31dbc4f80d6bb3afe77d0935e4a52c435895a679730cccc1d0f53c2c2c54a908881e7bcf96c2585d1c638d8738d1b75834c164b3c2e825
+  data.tar.gz: 363ac81a03972f3e3d86f917d3db3db8beb50ae813a52f80104fcc9d57073d9717c203b0b885d34218bdc0739f20fc1f9b7ad5fd390f7672c6f0fb1e890b9a0a

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # main
 
+# [0.9.41] - April 14th, 2026
+
+[0.9.41]: https://github.com/lsegal/yard/compare/v0.9.40...v0.9.41
+
+- Add support for `rdoc-image:...` syntax in HybridMarkup (#1676)
+- Add support for colon suffix code blocks in HybridMarkup (rdoc compatibility)
+- Fix responsiveness and state issues with nav frame links in `yard server`
 # [0.9.40] - April 12th, 2026
 
 [0.9.40]: https://github.com/lsegal/yard/compare/v0.9.39...v0.9.40

data/lib/yard/templates/helpers/markup/hybrid_markdown.rb

@@ -503,6 +503,7 @@ module YARD
             while index < lines.length
               line = lines[index]
               break if blank_line?(line)
+              break if !buffer.empty? && colon_indented_code_block_start?(lines, index)
               break if thematic_break?(line)
               break if parse_setext_heading(lines, index)
               break if parse_heading(line)
@@ -528,6 +529,7 @@ module YARD
             text = protect_code_spans(text, placeholders)
             text = protect_autolinks(text, placeholders)
             text = protect_hard_breaks(text, placeholders)
+            text = protect_rdoc_images(text, placeholders)
             text = protect_inline_images(text, placeholders)
             text = protect_inline_links(text, placeholders)
             text = protect_braced_text_links(text, placeholders)
@@ -634,6 +636,14 @@ module YARD
             text.gsub(/(?:\\|\s{2,})\n/) { store_placeholder(placeholders, "<br />\n") }
           end
 
+          def protect_rdoc_images(text, placeholders)
+            text.gsub(/(^|[ \t\n])rdoc-image:([A-Za-z][A-Za-z0-9+.-]*:\/\/\S+)(?=$|[ \t\n])/) do
+              prefix = Regexp.last_match(1)
+              dest = Regexp.last_match(2)
+              prefix + store_placeholder(placeholders, image_html('', dest))
+            end
+          end
+
           def protect_inline_images(text, placeholders)
             replace_inline_constructs(text, placeholders, '!') do |label, dest, title|
               store_placeholder(placeholders, image_html(
@@ -918,6 +928,7 @@ module YARD
           def indented_code_block_start?(lines, index, previous_block_type = nil)
             return false unless indented_code_start?(lines[index])
             return true if leading_columns(lines[index]) >= 4
+            return true if colon_indented_code_block_start?(lines, index)
             return false if previous_block_type == :list
             return false if html_block_start?(lines[index])
             return false if parse_setext_heading(lines, index)
@@ -925,6 +936,17 @@ module YARD
             !index.zero? && blank_line?(lines[index - 1])
           end
 
+          def colon_indented_code_block_start?(lines, index)
+            return false if index.zero?
+            return false unless leading_columns(lines[index]) >= 2
+            return false if leading_columns(lines[index]) >= 4
+
+            previous_line = lines[index - 1]
+            return false if blank_line?(previous_line)
+
+            previous_line.rstrip.end_with?(':')
+          end
+
           def yard_indented_code_start?(lines, index)
             return false unless leading_columns(lines[index]) >= 2
             return false unless consume_columns(lines[index], 2) =~ /^!!!([\w.+-]+)[ \t]*$/

data/lib/yard/version.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module YARD
-  VERSION = '0.9.40'
+  VERSION = '0.9.41'
 end

data/templates/default/fulldoc/html/css/style.css

@@ -46,6 +46,37 @@ body {
   padding-top: 0.2em;
   box-sizing: border-box;
 }
+#main_progress {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 3px;
+  overflow: hidden;
+  opacity: 0;
+  z-index: 20;
+  pointer-events: none;
+  transition: opacity 0.18s ease;
+}
+#main_progress::before {
+  content: "";
+  display: block;
+  width: 35%;
+  height: 100%;
+  background: linear-gradient(90deg, #1b6ac9 0%, #4ea3ff 100%);
+  transform: translateX(-120%);
+}
+#main.loading #main_progress {
+  opacity: 1;
+}
+#main.loading #main_progress::before {
+  animation: yard-progress-slide 1s ease-in-out infinite;
+}
+
+@keyframes yard-progress-slide {
+  0% { transform: translateX(-120%); }
+  100% { transform: translateX(320%); }
+}
 
 @media (max-width: 920px) {
   body { display: block; }

data/templates/default/fulldoc/html/js/app.js

@@ -3,7 +3,11 @@
     navigationListenerBound: false,
     navigationChangeBound: false,
     navResizerBound: false,
-    searchFrameGlobalsBound: false
+    searchFrameGlobalsBound: false,
+    latestNavigationId: 0,
+    loadingIndicatorTimer: null,
+    navExpanderTimer: null,
+    navExpanderToken: 0
   });
   var safeLocalStorage = {};
   var safeSessionStorage = {};
@@ -36,6 +40,29 @@
     element.style.display = visible ? (displayValue || "") : "none";
   }
 
+  function setMainLoading(loading) {
+    var main = query("#main");
+    if (!main) return;
+    main.classList.toggle("loading", !!loading);
+    main.setAttribute("aria-busy", loading ? "true" : "false");
+  }
+
+  function scheduleMainLoading(navigationId) {
+    clearTimeout(appState.loadingIndicatorTimer);
+    appState.loadingIndicatorTimer = setTimeout(function() {
+      if (navigationId === appState.latestNavigationId) {
+        setMainLoading(true);
+      }
+      appState.loadingIndicatorTimer = null;
+    }, 50);
+  }
+
+  function cancelMainLoading() {
+    clearTimeout(appState.loadingIndicatorTimer);
+    appState.loadingIndicatorTimer = null;
+    setMainLoading(false);
+  }
+
   function firstNextMatchingSibling(element, selector) {
     var current = element;
     while (current) {
@@ -453,18 +480,24 @@
   function navExpander() {
     if (typeof pathId === "undefined") return;
 
-    var done = false;
-    var timer = setTimeout(postMessage, 500);
+    var frame = document.getElementById("nav");
+    var token = ++appState.navExpanderToken;
 
     function postMessage() {
-      var frame;
-      if (done) return;
-      clearTimeout(timer);
-      frame = document.getElementById("nav");
-      if (!frame || !frame.contentWindow) return;
-      frame.contentWindow.postMessage({ action: "expand", path: pathId }, "*");
-      done = true;
+      if (token !== appState.navExpanderToken) return;
+      expandNavPath(pathId);
     }
+
+    clearTimeout(appState.navExpanderTimer);
+    if (frame) frame.addEventListener("load", postMessage, { once: true });
+    appState.navExpanderTimer = setTimeout(postMessage, 50);
+  }
+
+  function expandNavPath(path) {
+    var frame = document.getElementById("nav");
+
+    if (path == null || !frame || !frame.contentWindow) return;
+    frame.contentWindow.postMessage({ action: "expand", path: path }, "*");
   }
 
   function focusHashTarget() {
@@ -523,53 +556,81 @@
     window.addEventListener(
       "message",
       async function(event) {
+        var navigationId;
+        var response;
+        var text;
+        var parser;
+        var doc;
+        var classListLink;
+        var contentNode;
+        var content;
+        var url;
+        var hash;
+
         if (!event.data || event.data.action !== "navigate") return;
 
-        var response = await fetch(event.data.url);
-        var text = await response.text();
-        var parser = new DOMParser();
-        var doc = parser.parseFromString(text, "text/html");
-        var classListLink = document.getElementById("class_list_link");
-        var content = doc.querySelector("#main").innerHTML;
-
-        document.querySelector("#main").innerHTML = content;
-        document.title = doc.head.querySelector("title").innerText;
-
-        queryAll("script", document.head).forEach(function(script) {
-          if (
-            !script.type ||
-            (script.type.indexOf("text/javascript") !== -1 && !script.src)
-          ) {
-            script.remove();
-          }
-        });
+        navigationId = ++appState.latestNavigationId;
+        expandNavPath(event.data.path);
+        scheduleMainLoading(navigationId);
+
+        try {
+          response = await fetch(event.data.url);
+          if (navigationId !== appState.latestNavigationId) return;
+
+          text = await response.text();
+          if (navigationId !== appState.latestNavigationId) return;
+
+          parser = new DOMParser();
+          doc = parser.parseFromString(text, "text/html");
+          classListLink = document.getElementById("class_list_link");
+          contentNode = doc.querySelector("#main");
+          if (!contentNode) return;
+          content = contentNode.innerHTML;
+
+          document.querySelector("#main").innerHTML = content;
+          document.title = doc.head.querySelector("title").innerText;
+
+          queryAll("script", document.head).forEach(function(script) {
+            if (
+              !script.type ||
+              (script.type.indexOf("text/javascript") !== -1 && !script.src)
+            ) {
+              script.remove();
+            }
+          });
 
-        queryAll("script", doc.head).forEach(function(script) {
-          if (
-            !script.type ||
-            (script.type.indexOf("text/javascript") !== -1 && !script.src)
-          ) {
-            var newScript = document.createElement("script");
-            newScript.type = "text/javascript";
-            newScript.textContent = script.textContent;
-            document.head.appendChild(newScript);
-          }
-        });
+          queryAll("script", doc.head).forEach(function(script) {
+            if (
+              !script.type ||
+              (script.type.indexOf("text/javascript") !== -1 && !script.src)
+            ) {
+              var newScript = document.createElement("script");
+              newScript.type = "text/javascript";
+              newScript.textContent = script.textContent;
+              document.head.appendChild(newScript);
+            }
+          });
 
-        window.__app();
+          window.__app();
+          if (navigationId !== appState.latestNavigationId) return;
 
-        if (classListLink && document.getElementById("class_list_link")) {
-          document.getElementById("class_list_link").className =
-            classListLink.className;
-        }
+          if (classListLink && document.getElementById("class_list_link")) {
+            document.getElementById("class_list_link").className =
+              classListLink.className;
+          }
 
-        var url = new URL(event.data.url, "http://localhost");
-        var hash = decodeURIComponent(url.hash || "");
-        if (hash) {
-          var target = document.getElementById(hash.substring(1));
-          if (target) target.scrollIntoView();
+          url = new URL(event.data.url, "http://localhost");
+          hash = decodeURIComponent(url.hash || "");
+          if (hash) {
+            var target = document.getElementById(hash.substring(1));
+            if (target) target.scrollIntoView();
+          }
+          history.pushState({}, document.title, event.data.url);
+        } finally {
+          if (navigationId === appState.latestNavigationId) {
+            cancelMainLoading();
+          }
         }
-        history.pushState({}, document.title, event.data.url);
       },
       false
     );

data/templates/default/fulldoc/html/js/full_list.js

@@ -59,18 +59,39 @@
     if (clicked) clicked.classList.add("clicked");
   }
 
+  function pathForItem(item) {
+    if (!item || !item.id || item.id.indexOf("object_") !== 0) return null;
+    return item.id.substring("object_".length);
+  }
+
   function enableLinks() {
     queryAll("#full_list li").forEach(function(item) {
-      item.addEventListener("click", function(event) {
+      var itemRow = item.querySelector(":scope > .item");
+
+      if (!itemRow) return;
+
+      itemRow.addEventListener("click", function(event) {
         var targetLink;
         var mouseEvent;
         var url;
 
+        if (
+          event.defaultPrevented ||
+          event.button !== 0 ||
+          event.metaKey ||
+          event.ctrlKey ||
+          event.shiftKey ||
+          event.altKey
+        ) {
+          return true;
+        }
+
         setClicked(item);
         event.stopPropagation();
+        targetLink = event.target.closest("a");
 
         if (window.origin === "null") {
-          if (event.target.tagName === "A") return true;
+          if (targetLink) return true;
 
           targetLink = item.querySelector(":scope > .item .object_link a");
           if (!targetLink) return false;
@@ -94,11 +115,20 @@
           targetLink.dispatchEvent(mouseEvent);
           event.preventDefault();
         } else {
-          url = item.querySelector(".object_link a").getAttribute("href");
+          if (!targetLink || !targetLink.matches(".object_link a")) {
+            targetLink = item.querySelector(":scope > .item .object_link a");
+          }
+          if (!targetLink) return false;
+
+          event.preventDefault();
+          url = targetLink.getAttribute("href");
           try {
             url = new URL(url, window.location.href).href;
           } catch (error) {}
-          window.top.postMessage({ action: "navigate", url: url }, "*");
+          window.top.postMessage(
+            { action: "navigate", url: url, path: pathForItem(item) },
+            "*"
+          );
         }
         return false;
       });
@@ -291,7 +321,7 @@
 
     if (!target) return;
 
-    target.classList.add("clicked");
+    setClicked(target);
     target.classList.remove("collapsed");
 
     var current = target.parentElement;

data/templates/default/layout/html/layout.erb

@@ -10,6 +10,7 @@
     </div>
 
     <div id="main" tabindex="-1">
+      <div id="main_progress" aria-hidden="true"></div>
       <div id="header">
         <%= erb(:breadcrumb) %>
         <%= erb(:search) %>
@@ -21,4 +22,4 @@
       <%= erb(:footer) %>
     </div>
   </body>
-</html>
+</html>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yard
 version: !ruby/object:Gem::Version
-  version: 0.9.40
+  version: 0.9.41
 platform: ruby
 authors:
 - Loren Segal
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-13 00:00:00.000000000 Z
+date: 2026-04-14 00:00:00.000000000 Z
 dependencies: []
 description: |2
       YARD is a documentation generation tool for the Ruby programming language.