Replace sass lighten() and darken() with color.adjust()

Bumps [google-protobuf](https://github.com/protocolbuffers/protobuf) from 4.28.1 to 4.28.2.
- [Release notes](https://github.com/protocolbuffers/protobuf/releases)
- [Changelog](https://github.com/protocolbuffers/protobuf/blob/main/protobuf_release.bzl)
- [Commits](https://github.com/protocolbuffers/protobuf/commits)

---
updated-dependencies:
- dependency-name: google-protobuf
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    just-the-docs (0.9.0)
+    just-the-docs (0.10.0)
       jekyll (>= 3.8.5)
       jekyll-include-cache
       jekyll-seo-tag (>= 2.0)
@@ -10,19 +10,18 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    Ascii85 (1.1.0)
-    addressable (2.8.6)
-      public_suffix (>= 2.0.2, < 6.0)
+    Ascii85 (1.1.1)
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
     afm (0.2.2)
-    async (2.11.0)
-      console (~> 1.25, >= 1.25.2)
+    async (2.17.0)
+      console (~> 1.26)
       fiber-annotation
-      io-event (~> 1.5, >= 1.5.1)
-      timers (~> 4.1)
+      io-event (~> 1.6, >= 1.6.5)
     bigdecimal (3.1.8)
     colorator (1.1.0)
-    concurrent-ruby (1.2.3)
-    console (1.25.2)
+    concurrent-ruby (1.3.4)
+    console (1.27.0)
       fiber-annotation
       fiber-local (~> 1.1)
       json
@@ -32,19 +31,24 @@ GEM
     ethon (0.16.0)
       ffi (>= 1.15.0)
     eventmachine (1.2.7)
-    faraday (2.9.0)
-      faraday-net_http (>= 2.0, < 3.2)
-    faraday-net_http (3.1.0)
+    faraday (2.12.0)
+      faraday-net_http (>= 2.0, < 3.4)
+      json
+      logger
+    faraday-net_http (3.3.0)
       net-http
-    ffi (1.16.3)
+    ffi (1.17.0-arm64-darwin)
+    ffi (1.17.0-x86_64-linux-gnu)
     fiber-annotation (0.2.0)
     fiber-local (1.1.0)
       fiber-storage
-    fiber-storage (0.1.0)
+    fiber-storage (1.0.0)
     forwardable-extended (2.6.0)
-    google-protobuf (4.26.1-arm64-darwin)
+    google-protobuf (4.28.2-arm64-darwin)
+      bigdecimal
       rake (>= 13)
-    google-protobuf (4.26.1-x86_64-linux)
+    google-protobuf (4.28.2-x86_64-linux)
+      bigdecimal
       rake (>= 13)
     hashery (2.1.2)
     html-proofer (5.0.9)
@@ -57,10 +61,10 @@ GEM
       yell (~> 2.0)
       zeitwerk (~> 2.5)
     http_parser.rb (0.8.0)
-    i18n (1.14.4)
+    i18n (1.14.6)
       concurrent-ruby (~> 1.0)
-    io-event (1.5.1)
-    jekyll (4.3.3)
+    io-event (1.7.1)
+    jekyll (4.3.4)
       addressable (~> 2.4)
       colorator (~> 1.0)
       em-websocket (~> 0.5)
@@ -98,12 +102,13 @@ GEM
     listen (3.9.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
+    logger (1.6.1)
     mercenary (0.4.0)
     net-http (0.4.1)
       uri
-    nokogiri (1.16.5-arm64-darwin)
+    nokogiri (1.16.7-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.16.5-x86_64-linux)
+    nokogiri (1.16.7-x86_64-linux)
       racc (~> 1.4)
     octokit (6.1.1)
       faraday (>= 1, < 3)
@@ -116,38 +121,35 @@ GEM
       hashery (~> 2.0)
       ruby-rc4
       ttfunk
-    public_suffix (5.0.5)
-    racc (1.7.3)
+    public_suffix (6.0.1)
+    racc (1.8.1)
     rainbow (3.1.1)
     rake (13.2.1)
     rb-fsevent (0.11.2)
-    rb-inotify (0.10.1)
+    rb-inotify (0.11.1)
       ffi (~> 1.0)
-    rexml (3.3.6)
-      strscan
-    rouge (4.2.1)
+    rexml (3.3.8)
+    rouge (4.4.0)
     ruby-rc4 (0.1.5)
     safe_yaml (1.0.5)
-    sass-embedded (1.75.0-arm64-darwin)
-      google-protobuf (>= 3.25, < 5.0)
-    sass-embedded (1.75.0-x86_64-linux-gnu)
-      google-protobuf (>= 3.25, < 5.0)
+    sass-embedded (1.79.4-arm64-darwin)
+      google-protobuf (~> 4.27)
+    sass-embedded (1.79.4-x86_64-linux-gnu)
+      google-protobuf (~> 4.27)
     sawyer (0.9.2)
       addressable (>= 2.3.5)
       faraday (>= 0.17.3, < 3)
-    strscan (3.1.0)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
-    timers (4.3.5)
     ttfunk (1.8.0)
       bigdecimal (~> 3.1)
     typhoeus (1.4.1)
       ethon (>= 0.9.0)
-    unicode-display_width (2.5.0)
-    uri (0.13.0)
-    webrick (1.8.1)
+    unicode-display_width (2.6.0)
+    uri (0.13.1)
+    webrick (1.8.2)
     yell (2.2.2)
-    zeitwerk (2.6.13)
+    zeitwerk (2.6.18)
 
 PLATFORMS
   arm64-darwin

MIGRATION.md

@@ -43,6 +43,10 @@ This document contains instructions on how to migrate and upgrade Just the Docs
 
 [CHANGELOG]: {% link CHANGELOG.md %}
 
+## v0.9.x - v0.10.0
+
+There are no potentially-breaking changes in v0.10.0.
+
 ## v0.8.x - v0.9.0
 
 There are no potentially-breaking changes in v0.9.0.

_sass/buttons.scss

@@ -1,6 +1,8 @@
 // Buttons and things that look like buttons
 // stylelint-disable color-named
 
+@use "sass:color";
+
 .btn {
   display: inline-block;
   box-sizing: border-box;
@@ -35,7 +37,7 @@
 
   &:hover,
   &.zeroclipboard-is-hover {
-    color: darken($link-color, 2%);
+    color: color.adjust($link-color, $lightness: -2%);
   }
 
   &:hover,
@@ -43,19 +45,19 @@
   &.zeroclipboard-is-hover,
   &.zeroclipboard-is-active {
     text-decoration: none;
-    background-color: darken($base-button-color, 1%);
+    background-color: color.adjust($base-button-color, $lightness: -1%);
   }
 
   &:active,
   &.selected,
   &.zeroclipboard-is-active {
-    background-color: darken($base-button-color, 3%);
+    background-color: color.adjust($base-button-color, $lightness: -3%);
     background-image: none;
     box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15);
   }
 
   &.selected:hover {
-    background-color: darken(#dcdcdc, 5%);
+    background-color: color.adjust(#dcdcdc, $lightness: -5%);
   }
 
   &:disabled,
@@ -80,7 +82,7 @@
   &:active,
   &.zeroclipboard-is-hover,
   &.zeroclipboard-is-active {
-    color: darken($link-color, 4%);
+    color: color.adjust($link-color, $lightness: -4%);
     text-decoration: none;
     background-color: transparent;
     box-shadow: inset 0 0 0 3px $grey-lt-300;

_sass/color_schemes/dark.scss

@@ -1,3 +1,5 @@
+@use "sass:color";
+
 $color-scheme: dark;
 $body-background-color: $grey-dk-300;
 $body-heading-color: $grey-lt-000;
@@ -9,7 +11,7 @@ $base-button-color: $grey-dk-250;
 $btn-primary-color: $blue-200;
 $code-background-color: #31343f; // OneDarkJekyll default for syntax-one-dark-vivid
 $code-linenumber-color: #dee2f7; // OneDarkJekyll .nf for syntax-one-dark-vivid
-$feedback-color: darken($sidebar-color, 3%);
+$feedback-color: color.adjust($sidebar-color, $lightness: -3%);
 $table-background-color: $grey-dk-250;
 $search-background-color: $grey-dk-250;
 $search-result-preview-color: $grey-dk-000;

_sass/color_schemes/light.scss

@@ -1,3 +1,5 @@
+@use "sass:color";
+
 $color-scheme: light !default;
 $body-background-color: $white !default;
 $body-heading-color: $grey-dk-300 !default;
@@ -8,7 +10,7 @@ $sidebar-color: $grey-lt-000 !default;
 $base-button-color: #f7f7f7 !default;
 $btn-primary-color: $purple-100 !default;
 $code-background-color: $grey-lt-000 !default;
-$feedback-color: darken($sidebar-color, 3%) !default;
+$feedback-color: color.adjust($sidebar-color, $lightness: -3%) !default;
 $table-background-color: $white !default;
 $search-background-color: $white !default;
 $search-result-preview-color: $grey-dk-000 !default;

_sass/support/mixins/_buttons.scss

@@ -1,9 +1,11 @@
 // Colored button
 
+@use "sass:color";
+
 @mixin btn-color($fg, $bg) {
   color: $fg;
-  background-color: darken($bg, 2%);
-  background-image: linear-gradient(lighten($bg, 5%), darken($bg, 2%));
+  background-color: color.adjust($bg, $lightness: -2%);
+  background-image: linear-gradient(color.adjust($bg, $lightness: 5%), color.adjust($bg, $lightness: -2%));
   box-shadow:
     0 1px 3px rgba(0, 0, 0, 0.25),
     0 4px 10px rgba(0, 0, 0, 0.12);
@@ -11,19 +13,19 @@
   &:hover,
   &.zeroclipboard-is-hover {
     color: $fg;
-    background-color: darken($bg, 4%);
-    background-image: linear-gradient((lighten($bg, 2%), darken($bg, 4%)));
+    background-color: color.adjust($bg, $lightness: -4%);
+    background-image: linear-gradient((color.adjust($bg, $lightness: 2%), color.adjust($bg, $lightness: -4%)));
   }
 
   &:active,
   &.selected,
   &.zeroclipboard-is-active {
-    background-color: darken($bg, 5%);
+    background-color: color.adjust($bg, $lightness: -5%);
     background-image: none;
     box-shadow: inset 0 2px 4px rgba(0, 0, 0, 0.15);
   }
 
   &.selected:hover {
-    background-color: darken($bg, 10%);
+    background-color: color.adjust($bg, $lightness: -10%);
   }
 }

docs/navigation/main/index.md

@@ -13,7 +13,7 @@ You need to specify the `title` of each page in its front matter. Page titles ar
 By default, links to all pages appear in the main navigation at the top level, ordered alphabetically by their titles. By adding further fields to the front matter of individual pages, you can [change their order]({% link docs/navigation/main/order.md %}), [exclude pages]({% link docs/navigation/main/exclude.md %}), and change their [parent pages]({% link docs/navigation/main/levels.md %}).
 
 {: .new-title }
-> New (Multi-level)
+> New (v0.10.0)
 >
 > The main navigation can be structured as a multi-level menu of unlimited depth:
 > pages can always have child pages.
@@ -25,7 +25,7 @@ For the construction of the navigation display to work (and to avoid potential c
 * The title of each page must be different from the titles of all its child pages, and from the titles of their child pages, etc.
 
 {: .new-title }
-> New (Multi-level)
+> New (v0.10.0)
 >
 > If *all* the pages of your site have different titles, you need only to specify the `title` of each page, and the `parent` title of each lower-level page.[^1]
 
@@ -34,7 +34,7 @@ For the construction of the navigation display to work (and to avoid potential c
 If your site has pages with the same title, you need to avoid confusion when you reference that title as `parent` on other pages. When the pages with the same title have different `parent` pages, you can distinguish between them using the `grand_parent` parameter.
 
 {: .new-title }
-> New (Multi-level)
+> New (v0.10.0)
 >
 > For deeper navigation structures, you can specify the title of a grandparent or higher level page as an `ancestor` title.
 

docs/navigation/main/levels.md

@@ -63,7 +63,7 @@ nav_order: 2
 The Buttons page appears as a child of UI Components and appears second in the UI Components pages.
 
 {: .new-title }
-> New (Multi-level)
+> New (v0.10.0)
 >
 > The `has_children` field is now redundant (and ignored, except when significant for backwards compatibility).
 

just-the-docs.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name          = "just-the-docs"
-  spec.version       = "0.9.0"
+  spec.version       = "0.10.0"
   spec.authors       = ["Patrick Marsceill", "Matthew Wang"]
   spec.email         = ["patrick.marsceill@gmail.com", "matt@matthewwang.me"]