just-the-docs 0.11.1 → 0.11.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b296b656da46282854bd74aaffe42ff320dc7ff2c1743f7d6f27620be411f699
-  data.tar.gz: 63da1a282c3a864faa479764191f12397916b035b8f09fe486e2d3c437924882
+  metadata.gz: 61e4056b5ae32ff59dc3bba0a6b8cb172f16ab2c4ea24edac2c8461bbea57e80
+  data.tar.gz: b3ec9e9c999d87c65a66709625a1921b983d495f90f95ceff0fbbdb4e6e9b799
 SHA512:
-  metadata.gz: d718cd6771f1d60d277f3f9e28988f15e3243756641e78248ac7afadb0ce8c5a2d6fae8466f2a8bf8c5ff17fd68b28a8a7c780fa3acd200d548e1cf35ed44dfd
-  data.tar.gz: 693ce50e3aa198b32a2677aeb39bcbe686722a6ab8a69df33b44ad982bc90f929ac9f86d066c95dfc18b91fefb05d9379a728b57917b1057ef00ad61b552c21c
+  metadata.gz: 5f4c1d66792b00c3499df1f3643c31f6de5a140a04867b519d20c236ec717e56468df6de3bc26444b259177c7c37057dbd232517b617d3b2bb76fe9102a6918e
+  data.tar.gz: 0babdc149600cd7a1d3e22f94030436105cac9b8902b37a507df7ad9bcba881d6c14cdb012ab6003807941d1a4723aca9473988b89386e8496cdb097094b5b73

data/CHANGELOG.md

@@ -24,11 +24,22 @@ Docs changes made since the latest release:
 
 - N/A
 
+## v0.11.2 - 2026-01-23
+
+### Theme
+
+- Fixed: incorrect behaviour of `nav_footer` *below* `xs` viewport by [@mattxwang](https://github.com/mattxwang) in [#1760](https://github.com/just-the-docs/just-the-docs/pull/1760)
+- Fixed: usage of deprecated css properties (`word-wrap`, `clip`) and values (`appearance: button`) by [@mattxwang](https://github.com/mattxwang) in [#1761](https://github.com/just-the-docs/just-the-docs/pull/1761)
+- Fixed: incorrect main content spacing in print styles by [@mattxwang](https://github.com/mattxwang) in [#1765](https://github.com/just-the-docs/just-the-docs/pull/1765)
+- Fixed: focus indicator clipping and consistency for sidebar and top nav elements by [@mattxwang](https://github.com/mattxwang) in [#1769](https://github.com/just-the-docs/just-the-docs/pull/1769)
+- Fixed: search bar focus trap and search result focus outline clipping by [@mattxwang](https://github.com/mattxwang) in [#1770](https://github.com/just-the-docs/just-the-docs/pull/1770)
+
+
 ## v0.11.1 - 2026-01-02
 
 ### Theme
 
-- Fixed: incorrect behaviour of `nav_footer` on `xs` viewport
+- Fixed: incorrect behaviour of `nav_footer` on `xs` viewport by [@mattxwang](https://github.com/mattxwang) in [#1759](https://github.com/just-the-docs/just-the-docs/pull/1759)
 
 ## v0.11.0 - 2026-01-01
 

data/_includes/components/footer.html

@@ -34,7 +34,7 @@
     note: nav_footer_custom and/or this "site footer" appear in components/sidebar.html for the desktop view.
   {%- endcomment -%}
 
-  <div class="d-xs-block d-md-none">
+  <div class="d-md-none">
     {% capture nav_footer_custom %}
       {%- include nav_footer_custom.html -%}
     {% endcapture %}

data/_includes/components/sidebar.html

@@ -23,7 +23,7 @@
     note: nav_footer_custom and/or this "site footer" appear in components/footer.html for the mobile view.
   {%- endcomment -%}
 
-  <div class="d-md-block d-xs-none">
+  <div class="d-md-block d-none">
   {% capture nav_footer_custom %}
     {%- include nav_footer_custom.html -%}
   {% endcapture %}

data/_sass/layout.scss

@@ -133,6 +133,7 @@
   padding-top: $sp-3;
   padding-bottom: $sp-3;
   color: $body-heading-color;
+  outline-offset: -1px; // Fixes outline clipping on both desktop/mobile "views"
 
   @include container;
 
@@ -160,6 +161,7 @@
   height: 100%;
   padding: $gutter-spacing-sm;
   align-items: center;
+  outline-offset: -1px; // Fixes outline clipping on both desktop/mobile "views"
 }
 
 @include mq(md) {

data/_sass/navigation.scss

@@ -23,6 +23,8 @@
       padding-top: $sp-1;
       padding-bottom: $sp-1;
       line-height: #{$nav-list-item-height-sm - 2 * $sp-1};
+      outline-offset: -1px; // Fixes outline clipping on both desktop/mobile "views"
+
       @if $nav-list-expander-right {
         padding-right: $nav-list-item-height-sm;
         padding-left: $gutter-spacing-sm;
@@ -76,6 +78,7 @@
       height: $nav-list-item-height-sm;
       padding: #{$nav-list-item-height-sm * 0.25};
       color: $link-color;
+      outline-offset: -1px; // Fixes outline clipping on both desktop/mobile "views"
 
       @include mq(md) {
         width: $nav-list-item-height;

data/_sass/print.scss

@@ -19,6 +19,10 @@
     width: 100%;
     height: auto;
     border-right: 0 !important;
+
+    /* Disable display: flex and position: fixed from non-print styles */
+    position: static;
+    display: block;
   }
 
   .site-header {
@@ -40,6 +44,6 @@
 
   .main {
     max-width: none;
-    margin-left: 0;
+    margin-left: 0 !important; /* Necessary to override .side-bar + .main specificity */
   }
 }

data/_sass/search.scss

@@ -61,8 +61,7 @@
   }
 
   &:focus {
-    outline: 2px solid $link-color;
-    outline-offset: -2px;
+    outline-offset: -1px;
 
     + .search-label .search-icon {
       color: $link-color;
@@ -129,6 +128,7 @@
 .search-result {
   display: block;
   padding: $sp-1 $sp-3;
+  outline-offset: -1px;
 
   &:hover,
   &.active {
@@ -152,7 +152,7 @@
 .search-result-doc {
   display: flex;
   align-items: center;
-  word-wrap: break-word;
+  overflow-wrap: break-word;
 
   &.search-result-doc-parent {
     opacity: 0.5;
@@ -178,7 +178,7 @@
 
 .search-result-section {
   margin-left: #{$sp-4 + $sp-2};
-  word-wrap: break-word;
+  overflow-wrap: break-word;
 }
 
 .search-result-rel-url {
@@ -198,7 +198,7 @@
   padding-left: $sp-4;
   margin-left: $sp-2;
   color: $search-result-preview-color;
-  word-wrap: break-word;
+  overflow-wrap: break-word;
   border-left: $border;
   border-left-color: $border-color;
   @include fs-2;

data/_sass/support/mixins/_typography.scss

@@ -1,3 +1,8 @@
+// TODO: would be good to consider refactoring these mixins in a way that
+// the & { } selector is not necessary. Note that removing the & { }
+// will trip a SCSS deprecation warning -
+// see https://sass-lang.com/documentation/breaking-changes/mixed-decls/
+// stylelint-disable block-no-redundant-nested-style-rules
 @mixin fs-1 {
   & {
     font-size: $font-size-1 !important;

data/_sass/utilities/_layout.scss

@@ -31,7 +31,7 @@
   padding: 0;
   margin: -1px;
   overflow: hidden;
-  clip: rect(0, 0, 0, 0);
+  clip-path: inset(50%);
   white-space: nowrap;
   border-width: 0;
 }

data/_sass/vendor/normalize.scss/normalize.scss

@@ -198,7 +198,7 @@ button,
 [type="button"],
 [type="reset"],
 [type="submit"] {
-  appearance: button;
+  appearance: auto;
 }
 
 /**
@@ -308,7 +308,7 @@ textarea {
  */
 
 ::-webkit-file-upload-button {
-  appearance: button; /* 1 */
+  appearance: auto; /* 1 */
   font: inherit; /* 2 */
 }
 

data/assets/js/just-the-docs.js

@@ -418,6 +418,25 @@ function searchLoaded(index, docs) {
     setTimeout(update, 0);
   });
 
+  // When the search bar is *not* focused, it should be hidden. This code
+  // manages that - which is a bit tricky given that we can't just rely on
+  // focusout, since we could be re-focusing within the search itself.
+  const updateSearchFocus = function(evt) {
+    const nextFocusedElement = evt.relatedTarget;
+
+    // Re-focusing on search bar - "keep focus"
+    if (nextFocusedElement.id === 'search-input') return;
+
+    // Re-focusing on the next search result element - "keep focus"
+    if (nextFocusedElement.classList.contains('search-result')) return;
+
+    // Otherwise, we're not focused on the search bar anymore. Hide!
+    hideSearch();
+  }
+
+  searchInput.addEventListener('focusout', updateSearchFocus);
+  searchResults.addEventListener('focusout', updateSearchFocus);
+
   jtd.addEvent(searchInput, 'keyup', function(e){
     switch (e.keyCode) {
       case 27: // When esc key is pressed, hide the results and clear the field

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: just-the-docs
 version: !ruby/object:Gem::Version
-  version: 0.11.1
+  version: 0.11.2
 platform: ruby
 authors:
 - Patrick Marsceill
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-03 00:00:00.000000000 Z
+date: 2026-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -211,7 +211,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: A modern, highly customizable, and responsive Jekyll theme for documentation