From 8a59e4c4d4a935ba13c43562a29856e751d14282 Mon Sep 17 00:00:00 2001 From: Twisha Bansal Date: Mon, 22 Jun 2026 13:32:05 +0530 Subject: [PATCH 01/10] docs: copy docs-site scaffold verbatim from JS SDK MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Copies the Hugo/Docsy site scaffold from the JS SDK repo (googleapis/mcp-toolbox-sdk-js, docs-site/) byte-for-byte. No Python-specific changes in this commit — retargeting is done in the follow-up commit so the diff against the known-good JS pipeline is reviewable in isolation. Files copied unchanged: archetypes, assets (scss + icon), layouts (home.latest, home.releases, head-end hook, navbar-version-selector, sidebar-tree), static (w3.js + favicons), go.mod, go.sum, hugo.toml, package.json (postcss deps). --- docs-site/archetypes/default.md | 5 + docs-site/assets/icons/logo.svg | 1 + docs-site/assets/scss/_styles_project.scss | 27 +++ docs-site/assets/scss/_variables_project.scss | 4 + docs-site/assets/scss/main.scss | 1 + docs-site/go.mod | 8 + docs-site/go.sum | 8 + docs-site/hugo.toml | 91 ++++++++ docs-site/layouts/_default/home.latest.html | 11 + .../layouts/_default/home.releases.releases | 7 + .../layouts/_partials/hooks/head-end.html | 1 + .../_partials/navbar-version-selector.html | 16 ++ docs-site/layouts/_partials/sidebar-tree.html | 199 ++++++++++++++++++ docs-site/package.json | 7 + .../favicons/android-chrome-192x192.png | Bin 0 -> 7530 bytes .../favicons/android-chrome-512x512.png | Bin 0 -> 28023 bytes .../static/favicons/apple-touch-icon.png | Bin 0 -> 6873 bytes docs-site/static/favicons/favicon-16x16.png | Bin 0 -> 576 bytes docs-site/static/favicons/favicon-32x32.png | Bin 0 -> 1057 bytes docs-site/static/favicons/favicon.ico | Bin 0 -> 15406 bytes docs-site/static/js/w3.js | 34 +++ 21 files changed, 420 insertions(+) create mode 100644 docs-site/archetypes/default.md create mode 100644 docs-site/assets/icons/logo.svg create mode 100644 docs-site/assets/scss/_styles_project.scss create mode 100644 docs-site/assets/scss/_variables_project.scss create mode 100644 docs-site/assets/scss/main.scss create mode 100644 docs-site/go.mod create mode 100644 docs-site/go.sum create mode 100644 docs-site/hugo.toml create mode 100644 docs-site/layouts/_default/home.latest.html create mode 100644 docs-site/layouts/_default/home.releases.releases create mode 100644 docs-site/layouts/_partials/hooks/head-end.html create mode 100644 docs-site/layouts/_partials/navbar-version-selector.html create mode 100644 docs-site/layouts/_partials/sidebar-tree.html create mode 100644 docs-site/package.json create mode 100644 docs-site/static/favicons/android-chrome-192x192.png create mode 100644 docs-site/static/favicons/android-chrome-512x512.png create mode 100644 docs-site/static/favicons/apple-touch-icon.png create mode 100644 docs-site/static/favicons/favicon-16x16.png create mode 100644 docs-site/static/favicons/favicon-32x32.png create mode 100644 docs-site/static/favicons/favicon.ico create mode 100644 docs-site/static/js/w3.js diff --git a/docs-site/archetypes/default.md b/docs-site/archetypes/default.md new file mode 100644 index 000000000..25b67521d --- /dev/null +++ b/docs-site/archetypes/default.md @@ -0,0 +1,5 @@ ++++ +date = '{{ .Date }}' +draft = true +title = '{{ replace .File.ContentBaseName "-" " " | title }}' ++++ diff --git a/docs-site/assets/icons/logo.svg b/docs-site/assets/icons/logo.svg new file mode 100644 index 000000000..39cf8e2bc --- /dev/null +++ b/docs-site/assets/icons/logo.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs-site/assets/scss/_styles_project.scss b/docs-site/assets/scss/_styles_project.scss new file mode 100644 index 000000000..7bfb2f3b3 --- /dev/null +++ b/docs-site/assets/scss/_styles_project.scss @@ -0,0 +1,27 @@ +@import 'td/code-dark'; + +.td-navbar { + background-color: #80a7e9 !important; +} + +.nav-tabs { + flex-wrap: nowrap; + white-space: nowrap; + overflow-x: auto; + overflow-y: hidden; +} + +.td-content table { + display: table; + width: 100% !important; + margin-bottom: 1.5rem; +} + +.td-footer { + background-color: rgb(64, 63, 76) !important; + border-top: none; +} + +.td-footer, .td-footer a, .td-footer span { + color: #ffffff !important; +} \ No newline at end of file diff --git a/docs-site/assets/scss/_variables_project.scss b/docs-site/assets/scss/_variables_project.scss new file mode 100644 index 000000000..841966640 --- /dev/null +++ b/docs-site/assets/scss/_variables_project.scss @@ -0,0 +1,4 @@ +$primary: #80a7e9; +$secondary: #4484f4; + +$navbar-dark-bg: $primary; \ No newline at end of file diff --git a/docs-site/assets/scss/main.scss b/docs-site/assets/scss/main.scss new file mode 100644 index 000000000..866272c07 --- /dev/null +++ b/docs-site/assets/scss/main.scss @@ -0,0 +1 @@ +@import "td/main"; \ No newline at end of file diff --git a/docs-site/go.mod b/docs-site/go.mod new file mode 100644 index 000000000..b49fd08d9 --- /dev/null +++ b/docs-site/go.mod @@ -0,0 +1,8 @@ +module github.com/googleapis/mcp-toolbox-sdk-js/docs-site + +go 1.24.13 + +require ( + github.com/google/docsy v0.14.3 // indirect + github.com/google/docsy/dependencies v0.7.2 // indirect +) diff --git a/docs-site/go.sum b/docs-site/go.sum new file mode 100644 index 000000000..91e513190 --- /dev/null +++ b/docs-site/go.sum @@ -0,0 +1,8 @@ +github.com/FortAwesome/Font-Awesome v0.0.0-20230327165841-0698449d50f2/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo= +github.com/FortAwesome/Font-Awesome v0.0.0-20241216213156-af620534bfc3/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo= +github.com/google/docsy v0.14.3 h1:4uFgPWTPj4NT79IboVkXGi49LLQadLVfU4WNOfD/s74= +github.com/google/docsy v0.14.3/go.mod h1:1Fj1W1O3esZh7IBQ8XAYtxtg10udBXuGI89+LUQc1AU= +github.com/google/docsy/dependencies v0.7.2 h1:+t5ufoADQAj4XneFphz4A+UU0ICAxmNaRHVWtMYXPSI= +github.com/google/docsy/dependencies v0.7.2/go.mod h1:gihhs5gmgeO+wuoay4FwOzob+jYJVyQbNaQOh788lD4= +github.com/twbs/bootstrap v5.2.3+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0= +github.com/twbs/bootstrap v5.3.8+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0= diff --git a/docs-site/hugo.toml b/docs-site/hugo.toml new file mode 100644 index 000000000..ce455fbd6 --- /dev/null +++ b/docs-site/hugo.toml @@ -0,0 +1,91 @@ +title = "MCP Toolbox JS API" + +[params] + offlineSearch = true + copyright = "Google LLC" + +# Hand-edited version lists, one per package. Newest first — the order is +# mirrored into the dropdown. Add a block before tagging a release, and only +# list versions whose /// docs already exist (or will after the +# backfill run), or the dropdown link 404s. URLs are root-relative so they +# resolve against whatever host serves the page (production or staging). +[params.versions] + [[params.versions.core]] + version = "dev" + url = "/core/dev/" + [[params.versions.core]] + version = "v1.0.0" + url = "/core/v1.0.0/" + [[params.versions.core]] + version = "v0.3.0" + url = "/core/v0.3.0/" + [[params.versions.core]] + version = "v0.2.1" + url = "/core/v0.2.1/" + [[params.versions.adk]] + version = "dev" + url = "/adk/dev/" + [[params.versions.adk]] + version = "v0.3.0" + url = "/adk/v0.3.0/" + [[params.versions.adk]] + version = "v0.2.1" + url = "/adk/v0.2.1/" + [[params.versions.adk]] + version = "v0.2.0" + url = "/adk/v0.2.0/" + +[markup.goldmark.renderer] + unsafe = true + +# Resolve TypeDoc's relative .md / _index.md links to per-version pretty URLs. +# Required because the JS docs are generated by TypeDoc (a multi-file markdown +# tree); the Go SDK's gomarkdoc output is a single page and does not need this. +[markup.goldmark.renderHooks.link] + useEmbedded = "fallback" + +[markup.highlight] + noClasses = false + style = "tango" + +[params.ui] + navbar_logo = true + sidebar_menu_foldable = true + ul_show = 2 + breadcrumb_disable = true + sidebar_menu_compact = false + showLightDarkModeMenu = true + +[[menu.main]] + name = "Documentation" + url = "https://mcp-toolbox.dev" + weight = 10 + +[[menu.main]] + name = "GitHub" + url = "https://github.com/googleapis/mcp-toolbox-sdk-js" + weight = 20 + pre = "" + +[outputFormats] + # Dropdown fragment, fetched at runtime by the navbar version selector so + # frozen old version pages show newly-added versions without a rebuild. + [outputFormats.releases] + baseName = "releases" + isPlainText = true + mediaType = "text/releases" + # Per-package "latest" redirect, hoisted to //latest/index.html. + [outputFormats.latest] + baseName = "latest" + mediaType = "text/html" + isHTML = true + +[mediaTypes."text/releases"] + suffixes = ["releases"] + +[outputs] + home = ["HTML", "JSON", "releases", "latest"] # JSON kept for offline search + +[module] + [[module.imports]] + path = "github.com/google/docsy" diff --git a/docs-site/layouts/_default/home.latest.html b/docs-site/layouts/_default/home.latest.html new file mode 100644 index 000000000..8bcec6c90 --- /dev/null +++ b/docs-site/layouts/_default/home.latest.html @@ -0,0 +1,11 @@ +{{- $pkg := .Site.Params.package | default "" -}} +{{- $target := printf "/%s/dev/" $pkg -}} +{{- with index .Site.Params.versions $pkg }} + {{- range . }}{{ if ne .version "dev" }}{{ $target = .url }}{{ break }}{{ end }}{{ end }} +{{- end -}} + + + + +Redirecting… + diff --git a/docs-site/layouts/_default/home.releases.releases b/docs-site/layouts/_default/home.releases.releases new file mode 100644 index 000000000..d3464f915 --- /dev/null +++ b/docs-site/layouts/_default/home.releases.releases @@ -0,0 +1,7 @@ +{{- $pkg := .Site.Params.package | default "" -}} +latest +{{- with index .Site.Params.versions $pkg }} + {{- range . }} +{{ .version }} + {{- end }} +{{- end -}} diff --git a/docs-site/layouts/_partials/hooks/head-end.html b/docs-site/layouts/_partials/hooks/head-end.html new file mode 100644 index 000000000..abcb1b968 --- /dev/null +++ b/docs-site/layouts/_partials/hooks/head-end.html @@ -0,0 +1 @@ + diff --git a/docs-site/layouts/_partials/navbar-version-selector.html b/docs-site/layouts/_partials/navbar-version-selector.html new file mode 100644 index 000000000..7a716f16f --- /dev/null +++ b/docs-site/layouts/_partials/navbar-version-selector.html @@ -0,0 +1,16 @@ +{{/* Require a package context: on the rootless landing $pkg is empty, which + would emit a broken //releases.releases include and a meaningless picker. */ -}} +{{ if and .Site.Params.versions .Site.Params.package -}} +{{ $pkg := .Site.Params.package | default "" -}} +
+ +
+
+ +
+{{ end -}} diff --git a/docs-site/layouts/_partials/sidebar-tree.html b/docs-site/layouts/_partials/sidebar-tree.html new file mode 100644 index 000000000..adb5441e1 --- /dev/null +++ b/docs-site/layouts/_partials/sidebar-tree.html @@ -0,0 +1,199 @@ +{{ $context := .context -}} +{{ $sidebarRoot := .sidebarRoot -}} +{{ $sidebarRootID := .sidebarRootID -}} +{{ $cacheSidebar := .cacheSidebar -}} + +{{ with $context -}} + +{{/* When the sidebar is cached, "active" class is set client side. */ -}} +{{ $shouldDelayActive := $cacheSidebar -}} + +
+ {{ if not .Site.Params.ui.sidebar_search_disable -}} + +
+ {{ partial "search-input.html" . }} + +
+ + {{- else -}} + +
+
+ {{ partial "search-input.html" . }} + +
+
+
+ + {{- end }} + {{/* */ -}} + + +
+ +{{- end }}{{/* with $context */ -}} + +{{ define "section-tree-nav-section" -}} + {{/* cSpell:ignore manuallink manuallinkrelref manuallinktitle */ -}} + {{ $s := .section -}} + {{ $p := .page -}} + {{ $shouldDelayActive := .shouldDelayActive -}} + {{ $sidebarMenuTruncate := .sidebarMenuTruncate -}} + {{ $treeRoot := cond (eq .ulNr 0) true false -}} + {{ $ulNr := .ulNr -}} + {{ $ulShow := .ulShow -}} + {{ $active := and (not $shouldDelayActive) (eq $s $p) -}} + {{ $activePath := and (not $shouldDelayActive) (or (eq $p $s) ($p.IsDescendant $s)) -}} + {{ $show := cond + (or + (lt $ulNr $ulShow) + $activePath + (and (not $shouldDelayActive) (eq $s.Parent $p.Parent)) + (and (not $shouldDelayActive) (eq $s.Parent $p)) + (not $p.Site.Params.ui.sidebar_menu_compact) + (and (not $shouldDelayActive) ($p.IsDescendant $s.Parent)) + ) + true false + -}} + {{ $mid := printf "m-%s" ($s.RelPermalink | anchorize) -}} + {{ $pages_tmp := where (union $s.Pages $s.Sections).ByWeight ".Params.toc_hide" "!=" true -}} + {{ $pages := $pages_tmp | first $sidebarMenuTruncate -}} + {{ $truncatedEntryCount := sub (len $pages_tmp) $sidebarMenuTruncate -}} + + {{ if gt $truncatedEntryCount 0 -}} + {{ warnf "WARNING: %d sidebar entries have been truncated. To avoid this, increase `params.ui.sidebar_menu_truncate` to at least %d (from %d) in your config file. Section: %s" + $truncatedEntryCount (len $pages_tmp) $sidebarMenuTruncate $s.Path -}} + {{ end -}} + + {{ $withChild := gt (len $pages) 0 -}} + {{ $manualLink := + cond + (isset $s.Params "manuallink") + $s.Params.manualLink + (cond + (isset $s.Params "manuallinkrelref") + (relref $s $s.Params.manualLinkRelref) + $s.RelPermalink + ) + -}} + {{ $manualLinkTitle := + cond + (isset $s.Params "manuallinktitle") + $s.Params.manualLinkTitle + $s.Title + -}} + {{ if and $treeRoot (eq $s.Params.sidebar_root_for "self") -}} + {{ with $s.Parent -}} + {{ $manualLink = .RelPermalink -}} + {{ end -}} + {{ end -}} +
  • + {{ if (and $p.Site.Params.ui.sidebar_menu_foldable (ge $ulNr 1)) -}} + + + {{ else -}} + + {{- with $s.Params.Icon -}} + + {{- end -}} + + {{- $s.LinkTitle -}} + + {{- end -}} + {{ if $withChild -}} + {{ $ulNr := add $ulNr 1 }} +
      + {{ range $pages -}} + {{ if (not (and (eq $s $p.Site.Home) (eq .Params.toc_root true))) -}} + {{ template "section-tree-nav-section" (dict "page" $p "section" . "shouldDelayActive" $shouldDelayActive "sidebarMenuTruncate" $sidebarMenuTruncate "ulNr" $ulNr "ulShow" $ulShow) }} + {{- end }} + {{- end }} +
    + {{- end }} +
    • +{{- end -}} diff --git a/docs-site/package.json b/docs-site/package.json new file mode 100644 index 000000000..de75fcbd7 --- /dev/null +++ b/docs-site/package.json @@ -0,0 +1,7 @@ +{ + "dependencies": { + "autoprefixer": "^10.5.0", + "postcss": "^8.5.15", + "postcss-cli": "^11.0.1" + } +} diff --git a/docs-site/static/favicons/android-chrome-192x192.png b/docs-site/static/favicons/android-chrome-192x192.png new file mode 100644 index 0000000000000000000000000000000000000000..f2c81724e948fcf8b7191e99e1f17737706ae215 GIT binary patch literal 7530 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 literal 0 HcmV?d00001 diff --git a/docs-site/static/favicons/android-chrome-512x512.png b/docs-site/static/favicons/android-chrome-512x512.png new file mode 100644 index 0000000000000000000000000000000000000000..ad324c0d5f98e31e2a9a70a893e6b207329619a1 GIT binary patch literal 28023 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 literal 0 HcmV?d00001 diff --git a/docs-site/static/favicons/favicon-16x16.png b/docs-site/static/favicons/favicon-16x16.png new file mode 100644 index 0000000000000000000000000000000000000000..51f407b9cd4caf49d1d920a9169b1a18f6806e0b GIT binary patch literal 576 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�wtC|-9T3=puG`g8}Sa0u=-l7G!s$h7{;5WY2{y;H{YpO ze*&C!>D8a3|6GajL5vRZtTj$U-V$fIrXQMS6)wTJ<3oAG{CfL8+H(asi#~_?G#|T7 zh5cf*>E!P$9sdwwO?#PsMcU)iYqubV5LDf(S7Sve;XyAIWsy2`B?N!8$G9=I0XK^5~>j|AU=cdLFbu2 zosKN_`|hrnOPWypl)j}EdQA@O@!(M96Dz$5{)tuGk?Xbg8A)R=-v<7zh=;YBbe-)> z`F=5Gu|0A8=MG%i_@qAatLLV~VKc6QuFZ>Mh`jN1Nn~R$E^S;?64_#(9OL7c>WuFagE zMSiasv{r-j*Tcq}tqm3YUtBmNx79Rp4bI|rDY>&e=DV}#OZ9Z-Lf*b?6yE)d;2$2= zHYoU$Kh$QPn$>D5s>6H{=ci!4`DisiRZso~jm6P90`Gy&;-Vezq2C_CnV_ShmpdBr za>qhG(=iDMc}>UBua9FrdJ5&l#J1wuNqU|NkUNtogF3rV*9oN1!M!7St+~p+P5D-H zF^B$7=V*HHKK3{BlcIf$l_UPKJic{#lkK64LhU%Y!#=)i^Mb6d*Xpw6O?I{X%LO^| zh9#QFhPe;pyG}gA+;b^7r$k!+Y;G#x%mtswA7jGry4TOwMRjbokCEZyGA=BQp06-Y zaA3YZ=blwmM>c2AC{^-T-cOak;4zMs1oIyfxb(<@itnY8q5Btw*)tMk;P;w;EqhYO zG#+7_h=4}U@VECPhZ9ubQ$-*!FPT&9_DV8`2uG$wtd;Y zG~||rHh!q}oawNS?he$>2A|~^a~p7`$bm7}iL+OYI6LHqZ?zKs$!Z3vy=HlM p{hV@nyJr-1Va+@6Ig)|ODEVjd84F}Akg-6<0vQWrEO2Km@P9KRT|xi= literal 0 HcmV?d00001 diff --git a/docs-site/static/js/w3.js b/docs-site/static/js/w3.js new file mode 100644 index 000000000..331fe8876 --- /dev/null +++ b/docs-site/static/js/w3.js @@ -0,0 +1,34 @@ +/* Trimmed from W3.JS 1.04 (w3schools.com): only w3.includeHTML, plus a + w3-include-html-default fallback rendered on a 404. Used by the navbar + version selector to fetch //releases.releases at runtime. */ +"use strict"; +var w3 = {}; +w3.includeHTML = function (cb) { + var z, i, elmnt, file, xhttp; + z = document.getElementsByTagName("*"); + for (i = 0; i < z.length; i++) { + elmnt = z[i]; + file = elmnt.getAttribute("w3-include-html"); + if (file) { + xhttp = new XMLHttpRequest(); + xhttp.onreadystatechange = function () { + if (this.readyState == 4) { + if (this.status == 200) { elmnt.innerHTML = this.responseText; } + if (this.status == 404) { + if (elmnt.getAttribute("w3-include-html-default")) { + elmnt.innerHTML = elmnt.getAttribute("w3-include-html-default"); + } else { + elmnt.innerHTML = "Page not found."; + } + } + elmnt.removeAttribute("w3-include-html"); + w3.includeHTML(cb); + } + }; + xhttp.open("GET", file, true); + xhttp.send(); + return; + } + } + if (cb) cb(); +}; From 2d5b8fd5d201f214e583ce6f09f9b7015bb5deed Mon Sep 17 00:00:00 2001 From: Twisha Bansal Date: Mon, 22 Jun 2026 13:35:50 +0530 Subject: [PATCH 02/10] docs: retarget docs-site scaffold for the Python SDK Applies the Python-specific edits on top of the verbatim JS copy. Every change is listed so it can be diffed against the JS pipeline: - hugo.toml: title -> MCP Toolbox Python API; [params.versions] rewritten to the four Python packages (core, adk, langchain, llamaindex), dev only; GitHub menu link -> the Python repo; [markup.goldmark.renderHooks.link] useEmbedded = fallback kept as a safety net for any relative .md links from pydoc-markdown's crossref processor. - go.mod: module path -> .../mcp-toolbox-sdk-python/docs-site (docsy still pinned v0.14.3, matching Go/JS). - sidebar-tree.html: cross-package links core/adk -> core/adk/langchain/llamaindex. - .gitignore: ignore Hugo build output (public/, resources/, .hugo_build.lock, node_modules/) and docs-site/package-lock.json. Verified: hugo v0.152.2 extended builds the scaffold clean (Docsy main.css compiles via PostCSS/autoprefixer); only the harmless no-layout-for-json home warning remains. --- .gitignore | 7 ++++ docs-site/go.mod | 2 +- docs-site/hugo.toml | 34 ++++++------------- docs-site/layouts/_partials/sidebar-tree.html | 6 ++++ 4 files changed, 25 insertions(+), 24 deletions(-) diff --git a/.gitignore b/.gitignore index fc7b2d042..1875683e9 100644 --- a/.gitignore +++ b/.gitignore @@ -15,3 +15,10 @@ __pycache__/** **/.coverage build/ **/build/ + +# Hugo docs-site build output +node_modules/ +docs-site/public/ +docs-site/resources/ +.hugo_build.lock +docs-site/package-lock.json diff --git a/docs-site/go.mod b/docs-site/go.mod index b49fd08d9..26f9311f6 100644 --- a/docs-site/go.mod +++ b/docs-site/go.mod @@ -1,4 +1,4 @@ -module github.com/googleapis/mcp-toolbox-sdk-js/docs-site +module github.com/googleapis/mcp-toolbox-sdk-python/docs-site go 1.24.13 diff --git a/docs-site/hugo.toml b/docs-site/hugo.toml index ce455fbd6..75eb2fac8 100644 --- a/docs-site/hugo.toml +++ b/docs-site/hugo.toml @@ -1,4 +1,4 @@ -title = "MCP Toolbox JS API" +title = "MCP Toolbox Python API" [params] offlineSearch = true @@ -13,34 +13,22 @@ title = "MCP Toolbox JS API" [[params.versions.core]] version = "dev" url = "/core/dev/" - [[params.versions.core]] - version = "v1.0.0" - url = "/core/v1.0.0/" - [[params.versions.core]] - version = "v0.3.0" - url = "/core/v0.3.0/" - [[params.versions.core]] - version = "v0.2.1" - url = "/core/v0.2.1/" [[params.versions.adk]] version = "dev" url = "/adk/dev/" - [[params.versions.adk]] - version = "v0.3.0" - url = "/adk/v0.3.0/" - [[params.versions.adk]] - version = "v0.2.1" - url = "/adk/v0.2.1/" - [[params.versions.adk]] - version = "v0.2.0" - url = "/adk/v0.2.0/" + [[params.versions.langchain]] + version = "dev" + url = "/langchain/dev/" + [[params.versions.llamaindex]] + version = "dev" + url = "/llamaindex/dev/" [markup.goldmark.renderer] unsafe = true -# Resolve TypeDoc's relative .md / _index.md links to per-version pretty URLs. -# Required because the JS docs are generated by TypeDoc (a multi-file markdown -# tree); the Go SDK's gomarkdoc output is a single page and does not need this. +# Resolve relative .md / _index.md links to per-version pretty URLs. Kept as a +# safety net for any cross-links pydoc-markdown's crossref processor emits so +# none leak as raw .md hrefs once fed through Hugo. [markup.goldmark.renderHooks.link] useEmbedded = "fallback" @@ -63,7 +51,7 @@ title = "MCP Toolbox JS API" [[menu.main]] name = "GitHub" - url = "https://github.com/googleapis/mcp-toolbox-sdk-js" + url = "https://github.com/googleapis/mcp-toolbox-sdk-python" weight = 20 pre = "" diff --git a/docs-site/layouts/_partials/sidebar-tree.html b/docs-site/layouts/_partials/sidebar-tree.html index adb5441e1..775c57db1 100644 --- a/docs-site/layouts/_partials/sidebar-tree.html +++ b/docs-site/layouts/_partials/sidebar-tree.html @@ -68,6 +68,12 @@
  • ADK
    • +
  • + LangChain +
    • +
  • + LlamaIndex +
    • From 913c0245987891dd7ee2ddd07c701ac4fa3572dd Mon Sep 17 00:00:00 2001 From: Twisha Bansal Date: Mon, 22 Jun 2026 13:55:46 +0530 Subject: [PATCH 03/10] docs: copy doc-generation scripts verbatim from Go SDK --- scripts/generate-api-docs.sh | 62 ++++++++++++++++++++++++++++++++++++ scripts/generate-root.sh | 47 +++++++++++++++++++++++++++ 2 files changed, 109 insertions(+) create mode 100755 scripts/generate-api-docs.sh create mode 100755 scripts/generate-root.sh diff --git a/scripts/generate-api-docs.sh b/scripts/generate-api-docs.sh new file mode 100755 index 000000000..1a51b58ed --- /dev/null +++ b/scripts/generate-api-docs.sh @@ -0,0 +1,62 @@ +#!/bin/bash +# Copyright 2026 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +set -euo pipefail + +export PATH="$PATH:$(go env GOPATH)/bin" + +PACKAGE="${1:?package required (core|tbadk|tbgenkit)}" +VERSION="${2:?version required (e.g. v1.0.0 or dev)}" +BASE_URL="${3:-/}" + +case "$PACKAGE" in + core) TITLE="Core" ;; + tbadk) TITLE="Tbadk" ;; + tbgenkit) TITLE="Tbgenkit" ;; + *) echo "Unknown package: $PACKAGE" >&2; exit 1 ;; +esac + +go install github.com/princjef/gomarkdoc/cmd/gomarkdoc@latest + +# Per-build content tree in a temp dir, kept out of the checked-in +# docs-site/content so concurrent package builds never trample each other. +# The package's API reference is the home page, so /// lands +# directly on the docs (the repo README lives only at the site root). +CONTENT_DIR="$(mktemp -d)" +trap 'rm -rf "$CONTENT_DIR"' EXIT + +cat > "$CONTENT_DIR/_index.md" <> "$CONTENT_DIR/_index.md" + +cd docs-site +HUGO_PARAMS_VERSION="${VERSION}" HUGO_PARAMS_PACKAGE="${PACKAGE}" hugo \ + --minify \ + --contentDir "${CONTENT_DIR}" \ + --baseURL "${BASE_URL}${PACKAGE}/${VERSION}/" \ + --destination "public/${PACKAGE}/${VERSION}" + +# Hoist the home-scoped outputs from this version's dir up to the package root, +# where the navbar version selector fetches them. They list every version of the +# package, so they must live once per package (not per version) and are shared +# across all of this package's version pages. keep_files on deploy preserves them. +mv "public/${PACKAGE}/${VERSION}/releases.releases" "public/${PACKAGE}/releases.releases" +mkdir -p "public/${PACKAGE}/latest" +mv "public/${PACKAGE}/${VERSION}/latest.html" "public/${PACKAGE}/latest/index.html" diff --git a/scripts/generate-root.sh b/scripts/generate-root.sh new file mode 100755 index 000000000..66cc318af --- /dev/null +++ b/scripts/generate-root.sh @@ -0,0 +1,47 @@ +#!/bin/bash +# Copyright 2026 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +set -euo pipefail + +BASE_URL="${1:-/}" + +# Render the repo README (from the checked-out tag) as the root landing page. +# Built only on tag pushes so the root URL tracks the latest release and stays +# stable between main-branch dev builds. +CONTENT_DIR="$(mktemp -d)" +trap 'rm -rf "$CONTENT_DIR"' EXIT + +cat > "$CONTENT_DIR/_index.md" </ { intoc = 1 } + intoc { if (//) intoc = 0; next } + !h1done && /^# / { h1done = 1; next } + { print } +' README.md >> "$CONTENT_DIR/_index.md" + +cd docs-site +hugo \ + --minify \ + --contentDir "${CONTENT_DIR}" \ + --baseURL "${BASE_URL}" \ + --destination "public" From b0e76af1bf9f47610e08a9dd2dcdf5a4ab7a4b22 Mon Sep 17 00:00:00 2001 From: Twisha Bansal Date: Mon, 22 Jun 2026 13:57:05 +0530 Subject: [PATCH 04/10] docs: add pydoc-markdown pin for API doc generation --- docs-site/requirements.txt | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 docs-site/requirements.txt diff --git a/docs-site/requirements.txt b/docs-site/requirements.txt new file mode 100644 index 000000000..e9079a625 --- /dev/null +++ b/docs-site/requirements.txt @@ -0,0 +1,5 @@ +# Pins the API reference doc generator used by scripts/generate-api-docs.sh. +# pydoc-markdown parses the SDK source statically (no install/import of the +# packages), pulling docspec-python transitively. Keep in sync with the version +# installed in .github/workflows/api-docs.yml. +pydoc-markdown==4.8.2 From f91f26ab6bc9939e8fc1e0f425daed5396ffbfcd Mon Sep 17 00:00:00 2001 From: Twisha Bansal Date: Mon, 22 Jun 2026 13:57:21 +0530 Subject: [PATCH 05/10] docs: retarget doc-generation scripts for the Python SDK --- scripts/generate-api-docs.sh | 86 +++++++++++++++++++++++++++++------- scripts/generate-root.sh | 2 +- 2 files changed, 71 insertions(+), 17 deletions(-) diff --git a/scripts/generate-api-docs.sh b/scripts/generate-api-docs.sh index 1a51b58ed..e0b469fb4 100755 --- a/scripts/generate-api-docs.sh +++ b/scripts/generate-api-docs.sh @@ -15,36 +15,90 @@ set -euo pipefail -export PATH="$PATH:$(go env GOPATH)/bin" - -PACKAGE="${1:?package required (core|tbadk|tbgenkit)}" +PACKAGE="${1:?package required (core|adk|langchain|llamaindex)}" VERSION="${2:?version required (e.g. v1.0.0 or dev)}" BASE_URL="${3:-/}" +# Absolute repo root: the pydoc-markdown config's search_path is resolved +# relative to the config file's directory (a temp dir), not the CWD, so it must +# be absolute. Captured before the later `cd docs-site`. +ROOT="$(pwd)" + +# Map the URL slug to its package title and the curated list of public modules +# to document. The list is explicit (not whole-package recursion) so internal +# surface -- utils, itransport, the mcp_transport.v* protocol impls, and every +# package's version module -- stays out of the page, matching the Go/JS docs. case "$PACKAGE" in - core) TITLE="Core" ;; - tbadk) TITLE="Tbadk" ;; - tbgenkit) TITLE="Tbgenkit" ;; - *) echo "Unknown package: $PACKAGE" >&2; exit 1 ;; + core) + TITLE="Core" + MODULES=(client sync_client tool sync_tool auth_methods protocol) ;; + adk) + TITLE="ADK" + MODULES=(client tool toolset credentials) ;; + langchain) + TITLE="LangChain" + MODULES=(client tools async_client async_tools) ;; + llamaindex) + TITLE="LlamaIndex" + MODULES=(client tools async_client async_tools) ;; + *) echo "Unknown package: $PACKAGE" >&2; exit 1 ;; esac -go install github.com/princjef/gomarkdoc/cmd/gomarkdoc@latest +DIR="packages/toolbox-${PACKAGE}" +MODULE="toolbox_${PACKAGE}" # Per-build content tree in a temp dir, kept out of the checked-in # docs-site/content so concurrent package builds never trample each other. # The package's API reference is the home page, so /// lands # directly on the docs (the repo README lives only at the site root). CONTENT_DIR="$(mktemp -d)" -trap 'rm -rf "$CONTENT_DIR"' EXIT +CFG="$(mktemp)" +# return 0 so a leftover non-zero never becomes the script's exit code, since an +# EXIT trap's last status replaces it. +cleanup() { rm -rf "$CONTENT_DIR"; rm -f "$CFG"; return 0; } +trap cleanup EXIT + +# Build the YAML module block (" - toolbox_." per line). +MODULE_YAML="" +for m in "${MODULES[@]}"; do + MODULE_YAML+=" - ${MODULE}.${m}"$'\n' +done -cat > "$CONTENT_DIR/_index.md" < a single _index.md, the Hugo section index for +# ///. Parameters render as lists (Go-SDK style); the Raises +# section is kept as pydoc-markdown emits it. +cat > "$CFG" <> "$CONTENT_DIR/_index.md" +# Prepend Docsy frontmatter (type: docs + the friendly " (<version>)" +# heading) to the generated page so Docsy renders the section index correctly. +tmp="$(mktemp)" +{ printf -- '---\ntitle: "%s"\ntype: docs\n---\n\n' "${TITLE} (${VERSION})"; cat "${CONTENT_DIR}/_index.md"; } > "$tmp" +mv "$tmp" "${CONTENT_DIR}/_index.md" cd docs-site HUGO_PARAMS_VERSION="${VERSION}" HUGO_PARAMS_PACKAGE="${PACKAGE}" hugo \ diff --git a/scripts/generate-root.sh b/scripts/generate-root.sh index 66cc318af..dba506136 100755 --- a/scripts/generate-root.sh +++ b/scripts/generate-root.sh @@ -25,7 +25,7 @@ trap 'rm -rf "$CONTENT_DIR"' EXIT cat > "$CONTENT_DIR/_index.md" <<EOF --- -title: "MCP Toolbox Go SDK" +title: "MCP Toolbox Python API Reference" type: docs --- EOF From 7d4ff0aec2742f226926874f805e71a65f6ded1e Mon Sep 17 00:00:00 2001 From: Twisha Bansal <twishabansal07@gmail.com> Date: Mon, 22 Jun 2026 14:13:38 +0530 Subject: [PATCH 06/10] docs: copy api-docs workflow verbatim from Go SDK --- .github/workflows/api-docs.yml | 97 ++++++++++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 .github/workflows/api-docs.yml diff --git a/.github/workflows/api-docs.yml b/.github/workflows/api-docs.yml new file mode 100644 index 000000000..aee6d27c9 --- /dev/null +++ b/.github/workflows/api-docs.yml @@ -0,0 +1,97 @@ +# Copyright 2026 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + + +name: "API Reference Deployment" +on: + push: + branches: [ 'main' ] + tags: [ '**' ] + workflow_dispatch: + +concurrency: + group: api-docs-deploy + cancel-in-progress: false + +jobs: + deploy: + # Never run on forks; docs deploy only from the upstream repository. + if: github.repository == 'googleapis/mcp-toolbox-sdk-go' + runs-on: ubuntu-latest + permissions: + contents: write + steps: + - name: Checkout Code + uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6 + with: + submodules: recursive + fetch-depth: 0 + + - name: Set up Go + uses: actions/setup-go@4a3601121dd01d1626a1e23e37211e3254c1c06c # v6 + with: + go-version: '1.25.0' + + - name: Setup Hugo + uses: peaceiris/actions-hugo@2752ce1d29631191ea3f27c23495fa06139a5b78 # v3 + with: + hugo-version: '0.152.2' + extended: true + + - name: Install PostCSS Dependencies + run: | + cd docs-site + npm install postcss postcss-cli autoprefixer + + - name: Resolve build target + id: resolve + run: | + # Route the git ref to the package(s) and version to build. + # A per-package tag builds that one package; pushes to main (and manual + # dispatch) build all three as "dev". Any other tag is skipped. + REF="${GITHUB_REF}" + case "$REF" in + refs/tags/core/v*) echo "packages=core" >> "$GITHUB_OUTPUT"; echo "version=${REF#refs/tags/core/}" >> "$GITHUB_OUTPUT" ;; + refs/tags/tbadk/v*) echo "packages=tbadk" >> "$GITHUB_OUTPUT"; echo "version=${REF#refs/tags/tbadk/}" >> "$GITHUB_OUTPUT" ;; + refs/tags/tbgenkit/v*) echo "packages=tbgenkit" >> "$GITHUB_OUTPUT"; echo "version=${REF#refs/tags/tbgenkit/}" >> "$GITHUB_OUTPUT" ;; + refs/tags/*) echo "packages=" >> "$GITHUB_OUTPUT"; echo "version=" >> "$GITHUB_OUTPUT" ;; + *) echo "packages=core tbadk tbgenkit" >> "$GITHUB_OUTPUT"; echo "version=dev" >> "$GITHUB_OUTPUT" ;; + esac + + # Deploys only run upstream (see job-level guard), so always use the + # production domain. + echo "BASE_URL=https://go.mcp-toolbox.dev/" >> "$GITHUB_ENV" + + - name: Build per-package docs + if: steps.resolve.outputs.packages != '' + run: | + chmod +x scripts/generate-api-docs.sh + for PKG in ${{ steps.resolve.outputs.packages }}; do + ./scripts/generate-api-docs.sh "$PKG" "${{ steps.resolve.outputs.version }}" "$BASE_URL" + done + + - name: Build root page + if: steps.resolve.outputs.packages != '' && startsWith(github.ref, 'refs/tags/') + run: | + chmod +x scripts/generate-root.sh + ./scripts/generate-root.sh "$BASE_URL" + + - name: Deploy to gh-pages + if: steps.resolve.outputs.packages != '' + uses: peaceiris/actions-gh-pages@84c30a85c19949d7eee79c4ff27748b70285e453 # v4 + with: + github_token: ${{ secrets.GITHUB_TOKEN }} + publish_dir: ./docs-site/public + keep_files: true + cname: ${{ github.repository == 'googleapis/mcp-toolbox-sdk-go' && 'go.mcp-toolbox.dev' || '' }} From 1f26da021d7d1ef8a79a999e98f5056b86074850 Mon Sep 17 00:00:00 2001 From: Twisha Bansal <twishabansal07@gmail.com> Date: Mon, 22 Jun 2026 14:16:06 +0530 Subject: [PATCH 07/10] docs: retarget api-docs workflow for the Python SDK --- .github/workflows/api-docs.yml | 46 +++++++++++++++++++++------------- 1 file changed, 29 insertions(+), 17 deletions(-) diff --git a/.github/workflows/api-docs.yml b/.github/workflows/api-docs.yml index aee6d27c9..8f1965214 100644 --- a/.github/workflows/api-docs.yml +++ b/.github/workflows/api-docs.yml @@ -27,51 +27,63 @@ concurrency: jobs: deploy: # Never run on forks; docs deploy only from the upstream repository. - if: github.repository == 'googleapis/mcp-toolbox-sdk-go' + if: github.repository == 'googleapis/mcp-toolbox-sdk-python' runs-on: ubuntu-latest permissions: contents: write steps: - name: Checkout Code - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6 + uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7 with: submodules: recursive fetch-depth: 0 - - name: Set up Go - uses: actions/setup-go@4a3601121dd01d1626a1e23e37211e3254c1c06c # v6 + - name: Set up Python + uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6 with: - go-version: '1.25.0' + python-version: '3.13' + + - name: Install doc generator + run: | + # pydoc-markdown parses the SDK source statically (no install/import of + # the packages), so no package build step is needed -- unlike the JS + # pipeline, which compiles types before TypeDoc runs. + pip install -r docs-site/requirements.txt - name: Setup Hugo uses: peaceiris/actions-hugo@2752ce1d29631191ea3f27c23495fa06139a5b78 # v3 with: hugo-version: '0.152.2' - extended: true - + extended: true + - name: Install PostCSS Dependencies run: | + # --no-workspaces installs into docs-site/node_modules (where Hugo's + # PostCSS looks). docs-site/package.json pins postcss/postcss-cli/ + # autoprefixer. cd docs-site - npm install postcss postcss-cli autoprefixer + npm install --no-workspaces - name: Resolve build target id: resolve run: | # Route the git ref to the package(s) and version to build. # A per-package tag builds that one package; pushes to main (and manual - # dispatch) build all three as "dev". Any other tag is skipped. + # dispatch) build all four as "dev". Python release tags are + # toolbox-<name>-vX.Y.Z; release-please-* and any other tag are skipped. REF="${GITHUB_REF}" case "$REF" in - refs/tags/core/v*) echo "packages=core" >> "$GITHUB_OUTPUT"; echo "version=${REF#refs/tags/core/}" >> "$GITHUB_OUTPUT" ;; - refs/tags/tbadk/v*) echo "packages=tbadk" >> "$GITHUB_OUTPUT"; echo "version=${REF#refs/tags/tbadk/}" >> "$GITHUB_OUTPUT" ;; - refs/tags/tbgenkit/v*) echo "packages=tbgenkit" >> "$GITHUB_OUTPUT"; echo "version=${REF#refs/tags/tbgenkit/}" >> "$GITHUB_OUTPUT" ;; - refs/tags/*) echo "packages=" >> "$GITHUB_OUTPUT"; echo "version=" >> "$GITHUB_OUTPUT" ;; - *) echo "packages=core tbadk tbgenkit" >> "$GITHUB_OUTPUT"; echo "version=dev" >> "$GITHUB_OUTPUT" ;; + refs/tags/toolbox-core-v*) echo "packages=core" >> "$GITHUB_OUTPUT"; echo "version=${REF#refs/tags/toolbox-core-}" >> "$GITHUB_OUTPUT" ;; + refs/tags/toolbox-adk-v*) echo "packages=adk" >> "$GITHUB_OUTPUT"; echo "version=${REF#refs/tags/toolbox-adk-}" >> "$GITHUB_OUTPUT" ;; + refs/tags/toolbox-langchain-v*) echo "packages=langchain" >> "$GITHUB_OUTPUT"; echo "version=${REF#refs/tags/toolbox-langchain-}" >> "$GITHUB_OUTPUT" ;; + refs/tags/toolbox-llamaindex-v*) echo "packages=llamaindex" >> "$GITHUB_OUTPUT"; echo "version=${REF#refs/tags/toolbox-llamaindex-}" >> "$GITHUB_OUTPUT" ;; + refs/tags/*) echo "packages=" >> "$GITHUB_OUTPUT"; echo "version=" >> "$GITHUB_OUTPUT" ;; + *) echo "packages=core adk langchain llamaindex" >> "$GITHUB_OUTPUT"; echo "version=dev" >> "$GITHUB_OUTPUT" ;; esac # Deploys only run upstream (see job-level guard), so always use the # production domain. - echo "BASE_URL=https://go.mcp-toolbox.dev/" >> "$GITHUB_ENV" + echo "BASE_URL=https://py.mcp-toolbox.dev/" >> "$GITHUB_ENV" - name: Build per-package docs if: steps.resolve.outputs.packages != '' @@ -93,5 +105,5 @@ jobs: with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_dir: ./docs-site/public - keep_files: true - cname: ${{ github.repository == 'googleapis/mcp-toolbox-sdk-go' && 'go.mcp-toolbox.dev' || '' }} + keep_files: true + cname: ${{ github.repository == 'googleapis/mcp-toolbox-sdk-python' && 'py.mcp-toolbox.dev' || '' }} From 44e7b1f557b31ea0a7895931b69d4e45cfec7d6d Mon Sep 17 00:00:00 2001 From: Twisha Bansal <twishabansal07@gmail.com> Date: Mon, 22 Jun 2026 14:16:50 +0530 Subject: [PATCH 08/10] docs: seed released versions in the version selector --- docs-site/hugo.toml | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/docs-site/hugo.toml b/docs-site/hugo.toml index 75eb2fac8..a6ec3cd5f 100644 --- a/docs-site/hugo.toml +++ b/docs-site/hugo.toml @@ -13,15 +13,51 @@ title = "MCP Toolbox Python API" [[params.versions.core]] version = "dev" url = "/core/dev/" + [[params.versions.core]] + version = "v1.1.0" + url = "/core/v1.1.0/" + [[params.versions.core]] + version = "v1.0.0" + url = "/core/v1.0.0/" + [[params.versions.core]] + version = "v0.6.0" + url = "/core/v0.6.0/" [[params.versions.adk]] version = "dev" url = "/adk/dev/" + [[params.versions.adk]] + version = "v1.0.1" + url = "/adk/v1.0.1/" + [[params.versions.adk]] + version = "v1.0.0" + url = "/adk/v1.0.0/" + [[params.versions.adk]] + version = "v0.7.0" + url = "/adk/v0.7.0/" [[params.versions.langchain]] version = "dev" url = "/langchain/dev/" + [[params.versions.langchain]] + version = "v1.0.1" + url = "/langchain/v1.0.1/" + [[params.versions.langchain]] + version = "v1.0.0" + url = "/langchain/v1.0.0/" + [[params.versions.langchain]] + version = "v0.6.0" + url = "/langchain/v0.6.0/" [[params.versions.llamaindex]] version = "dev" url = "/llamaindex/dev/" + [[params.versions.llamaindex]] + version = "v1.0.0" + url = "/llamaindex/v1.0.0/" + [[params.versions.llamaindex]] + version = "v0.7.0" + url = "/llamaindex/v0.7.0/" + [[params.versions.llamaindex]] + version = "v0.6.0" + url = "/llamaindex/v0.6.0/" [markup.goldmark.renderer] unsafe = true From 2e728191de61f9bfb7849a2d68a429e5ac7d0749 Mon Sep 17 00:00:00 2001 From: Twisha Bansal <twishabansal07@gmail.com> Date: Mon, 22 Jun 2026 16:32:32 +0530 Subject: [PATCH 09/10] build(docs): commit docs-site lockfile for reproducible installs The PostCSS toolchain (autoprefixer/postcss/postcss-cli) was installed with npm install, which re-resolves the latest matching semver on every run. A broken upstream patch (e.g. browserslist 4.28.3) could then fail both the deploy and backfill workflows nondeterministically. Commit the lockfile so npm ci can install the exact, vetted versions instead. --- .gitignore | 1 - docs-site/package-lock.json | 863 ++++++++++++++++++++++++++++++++++++ 2 files changed, 863 insertions(+), 1 deletion(-) create mode 100644 docs-site/package-lock.json diff --git a/.gitignore b/.gitignore index 1875683e9..d48c7af8c 100644 --- a/.gitignore +++ b/.gitignore @@ -21,4 +21,3 @@ node_modules/ docs-site/public/ docs-site/resources/ .hugo_build.lock -docs-site/package-lock.json diff --git a/docs-site/package-lock.json b/docs-site/package-lock.json new file mode 100644 index 000000000..f6f5be387 --- /dev/null +++ b/docs-site/package-lock.json @@ -0,0 +1,863 @@ +{ + "name": "docs-site", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "dependencies": { + "autoprefixer": "^10.5.0", + "postcss": "^8.5.15", + "postcss-cli": "^11.0.1" + } + }, + "node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/anymatch": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", + "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", + "license": "ISC", + "dependencies": { + "normalize-path": "^3.0.0", + "picomatch": "^2.0.4" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/autoprefixer": { + "version": "10.5.0", + "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.5.0.tgz", + "integrity": "sha512-FMhOoZV4+qR6aTUALKX2rEqGG+oyATvwBt9IIzVR5rMa2HRWPkxf+P+PAJLD1I/H5/II+HuZcBJYEFBpq39ong==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/autoprefixer" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "browserslist": "^4.28.2", + "caniuse-lite": "^1.0.30001787", + "fraction.js": "^5.3.4", + "picocolors": "^1.1.1", + "postcss-value-parser": "^4.2.0" + }, + "bin": { + "autoprefixer": "bin/autoprefixer" + }, + "engines": { + "node": "^10 || ^12 || >=14" + }, + "peerDependencies": { + "postcss": "^8.1.0" + } + }, + "node_modules/baseline-browser-mapping": { + "version": "2.10.38", + "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.38.tgz", + "integrity": "sha512-31/02mVB4yuQU6adKk5SlY6m+mxDwUq5KZkyYgnLrrKl7TEm1+3PyDtDBz2kOv/wxZz41GHsvV1A/u6RmiyBvw==", + "license": "Apache-2.0", + "bin": { + "baseline-browser-mapping": "dist/cli.cjs" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/binary-extensions": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz", + "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==", + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/braces": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", + "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "license": "MIT", + "dependencies": { + "fill-range": "^7.1.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/browserslist": { + "version": "4.28.4", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.4.tgz", + "integrity": "sha512-MTc8i/x9jBQd1iMw2CFGS+rwMa07eYjLR0CCTLDACl9xhxy+nIs3KeML/biicXtk9JrZ6dnnTatmc7ErPXIxqw==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "baseline-browser-mapping": "^2.10.38", + "caniuse-lite": "^1.0.30001799", + "electron-to-chromium": "^1.5.376", + "node-releases": "^2.0.48", + "update-browserslist-db": "^1.2.3" + }, + "bin": { + "browserslist": "cli.js" + }, + "engines": { + "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7" + } + }, + "node_modules/caniuse-lite": { + "version": "1.0.30001799", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001799.tgz", + "integrity": "sha512-hG1bReV+OUU+MOqK4t/ZWI0tZOyz3rqS9XuhOUz1cIcbwBKjOyJEJuw9ER5JuNyqxNk8u/JUVbGibBOL1yrjFw==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/caniuse-lite" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "CC-BY-4.0" + }, + "node_modules/chokidar": { + "version": "3.6.0", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.6.0.tgz", + "integrity": "sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==", + "license": "MIT", + "dependencies": { + "anymatch": "~3.1.2", + "braces": "~3.0.2", + "glob-parent": "~5.1.2", + "is-binary-path": "~2.1.0", + "is-glob": "~4.0.1", + "normalize-path": "~3.0.0", + "readdirp": "~3.6.0" + }, + "engines": { + "node": ">= 8.10.0" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + }, + "optionalDependencies": { + "fsevents": "~2.3.2" + } + }, + "node_modules/cliui": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz", + "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==", + "license": "ISC", + "dependencies": { + "string-width": "^4.2.0", + "strip-ansi": "^6.0.1", + "wrap-ansi": "^7.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" + }, + "node_modules/dependency-graph": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/dependency-graph/-/dependency-graph-1.0.0.tgz", + "integrity": "sha512-cW3gggJ28HZ/LExwxP2B++aiKxhJXMSIt9K48FOXQkm+vuG5gyatXnLsONRJdzO/7VfjDIiaOOa/bs4l464Lwg==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/electron-to-chromium": { + "version": "1.5.376", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.376.tgz", + "integrity": "sha512-cUVA7/RvbFTEuw/i3obUwDTRIXojaxkResf+ibByPFxjc6XK3VNtcQXV0NSbAlJ0FMjcJGgftVVB4Qo184EXvA==", + "license": "ISC" + }, + "node_modules/emoji-regex": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", + "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", + "license": "MIT" + }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/fill-range": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", + "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "license": "MIT", + "dependencies": { + "to-regex-range": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/fraction.js": { + "version": "5.3.4", + "resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-5.3.4.tgz", + "integrity": "sha512-1X1NTtiJphryn/uLQz3whtY6jK3fTqoE3ohKs0tT+Ujr1W59oopxmoEh7Lu5p6vBaPbgoM0bzveAW4Qi5RyWDQ==", + "license": "MIT", + "engines": { + "node": "*" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/rawify" + } + }, + "node_modules/fs-extra": { + "version": "11.3.5", + "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.3.5.tgz", + "integrity": "sha512-eKpRKAovdpZtR1WopLHxlBWvAgPny3c4gX1G5Jhwmmw4XJj0ifSD5qB5TOo8hmA0wlRKDAOAhEE1yVPgs6Fgcg==", + "license": "MIT", + "dependencies": { + "graceful-fs": "^4.2.0", + "jsonfile": "^6.0.1", + "universalify": "^2.0.0" + }, + "engines": { + "node": ">=14.14" + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/get-caller-file": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", + "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", + "license": "ISC", + "engines": { + "node": "6.* || 8.* || >= 10.*" + } + }, + "node_modules/glob-parent": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", + "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/graceful-fs": { + "version": "4.2.11", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", + "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", + "license": "ISC" + }, + "node_modules/is-binary-path": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz", + "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==", + "license": "MIT", + "dependencies": { + "binary-extensions": "^2.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-fullwidth-code-point": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", + "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-number": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", + "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/jsonfile": { + "version": "6.2.1", + "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.2.1.tgz", + "integrity": "sha512-zwOTdL3rFQ/lRdBnntKVOX6k5cKJwEc1HdilT71BWEu7J41gXIB2MRp+vxduPSwZJPWBxEzv4yH1wYLJGUHX4Q==", + "license": "MIT", + "dependencies": { + "universalify": "^2.0.0" + }, + "optionalDependencies": { + "graceful-fs": "^4.1.6" + } + }, + "node_modules/lilconfig": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-3.1.3.tgz", + "integrity": "sha512-/vlFKAoH5Cgt3Ie+JLhRbwOsCQePABiU3tJ1egGvyQ+33R/vcwM2Zl2QR/LzjsBeItPt3oSVXapn+m4nQDvpzw==", + "license": "MIT", + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/antonk52" + } + }, + "node_modules/nanoid": { + "version": "3.3.15", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.15.tgz", + "integrity": "sha512-y7Wygv/7mEOvxTuEQDB8StXdMRBWf1kR/tlhAzBRUFkB2jfcLOAxO/SHmOO2zgz1pVgK29/kyupn059/bCHdjA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/node-releases": { + "version": "2.0.48", + "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.48.tgz", + "integrity": "sha512-1uz8041X6LoI6ZSdZacM9lVY28vuzDlSKitnpbSNK0RfKoIJkX29NBPVEFXhnuSuEOA9Ww0xnPJ+ILWbGAv8DA==", + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/normalize-path": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", + "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", + "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==", + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/pify": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz", + "integrity": "sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/postcss": { + "version": "8.5.15", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.15.tgz", + "integrity": "sha512-FfR8sjd4em2T6fb3I2MwAJU7HWVMr9zba+enmQeeWFfCbm+UOC/0X4DS8XtpUTMwWMGbjKYP7xjfNekzyGmB3A==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.12", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/postcss-cli": { + "version": "11.0.1", + "resolved": "https://registry.npmjs.org/postcss-cli/-/postcss-cli-11.0.1.tgz", + "integrity": "sha512-0UnkNPSayHKRe/tc2YGW6XnSqqOA9eqpiRMgRlV1S6HdGi16vwJBx7lviARzbV1HpQHqLLRH3o8vTcB0cLc+5g==", + "license": "MIT", + "dependencies": { + "chokidar": "^3.3.0", + "dependency-graph": "^1.0.0", + "fs-extra": "^11.0.0", + "picocolors": "^1.0.0", + "postcss-load-config": "^5.0.0", + "postcss-reporter": "^7.0.0", + "pretty-hrtime": "^1.0.3", + "read-cache": "^1.0.0", + "slash": "^5.0.0", + "tinyglobby": "^0.2.12", + "yargs": "^17.0.0" + }, + "bin": { + "postcss": "index.js" + }, + "engines": { + "node": ">=18" + }, + "peerDependencies": { + "postcss": "^8.0.0" + } + }, + "node_modules/postcss-load-config": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/postcss-load-config/-/postcss-load-config-5.1.0.tgz", + "integrity": "sha512-G5AJ+IX0aD0dygOE0yFZQ/huFFMSNneyfp0e3/bT05a8OfPC5FUoZRPfGijUdGOJNMewJiwzcHJXFafFzeKFVA==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "lilconfig": "^3.1.1", + "yaml": "^2.4.2" + }, + "engines": { + "node": ">= 18" + }, + "peerDependencies": { + "jiti": ">=1.21.0", + "postcss": ">=8.0.9", + "tsx": "^4.8.1" + }, + "peerDependenciesMeta": { + "jiti": { + "optional": true + }, + "postcss": { + "optional": true + }, + "tsx": { + "optional": true + } + } + }, + "node_modules/postcss-reporter": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/postcss-reporter/-/postcss-reporter-7.1.0.tgz", + "integrity": "sha512-/eoEylGWyy6/DOiMP5lmFRdmDKThqgn7D6hP2dXKJI/0rJSO1ADFNngZfDzxL0YAxFvws+Rtpuji1YIHj4mySA==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "picocolors": "^1.0.0", + "thenby": "^1.3.4" + }, + "engines": { + "node": ">=10" + }, + "peerDependencies": { + "postcss": "^8.1.0" + } + }, + "node_modules/postcss-value-parser": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz", + "integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==", + "license": "MIT" + }, + "node_modules/pretty-hrtime": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/pretty-hrtime/-/pretty-hrtime-1.0.3.tgz", + "integrity": "sha512-66hKPCr+72mlfiSjlEB1+45IjXSqvVAIy6mocupoww4tBFE9R9IhwwUGoI4G++Tc9Aq+2rxOt0RFU6gPcrte0A==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/read-cache": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/read-cache/-/read-cache-1.0.0.tgz", + "integrity": "sha512-Owdv/Ft7IjOgm/i0xvNDZ1LrRANRfew4b2prF3OWMQLxLfu3bS8FVhCsrSCMK4lR56Y9ya+AThoTpDCTxCmpRA==", + "license": "MIT", + "dependencies": { + "pify": "^2.3.0" + } + }, + "node_modules/readdirp": { + "version": "3.6.0", + "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz", + "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==", + "license": "MIT", + "dependencies": { + "picomatch": "^2.2.1" + }, + "engines": { + "node": ">=8.10.0" + } + }, + "node_modules/require-directory": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", + "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/slash": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/slash/-/slash-5.1.0.tgz", + "integrity": "sha512-ZA6oR3T/pEyuqwMgAKT0/hAv8oAXckzbkmR0UkUosQ+Mc4RxGoJkRmwHgHufaenlyAgE1Mxgpdcrf75y6XcnDg==", + "license": "MIT", + "engines": { + "node": ">=14.16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/string-width": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", + "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", + "license": "MIT", + "dependencies": { + "emoji-regex": "^8.0.0", + "is-fullwidth-code-point": "^3.0.0", + "strip-ansi": "^6.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/thenby": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/thenby/-/thenby-1.4.1.tgz", + "integrity": "sha512-D5a/bO0KdalOE3q8MlrRmSxjbKZHT3MQmXkJP+r97Vw8MMwOZKOwUSEyTtK7eSMj2y0kyAjpYMRMZmmLw1FtNQ==", + "license": "Apache-2.0" + }, + "node_modules/tinyglobby": { + "version": "0.2.17", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz", + "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==", + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/tinyglobby/node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/tinyglobby/node_modules/picomatch": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz", + "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/to-regex-range": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", + "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "license": "MIT", + "dependencies": { + "is-number": "^7.0.0" + }, + "engines": { + "node": ">=8.0" + } + }, + "node_modules/universalify": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz", + "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==", + "license": "MIT", + "engines": { + "node": ">= 10.0.0" + } + }, + "node_modules/update-browserslist-db": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.2.3.tgz", + "integrity": "sha512-Js0m9cx+qOgDxo0eMiFGEueWztz+d4+M3rGlmKPT+T4IS/jP4ylw3Nwpu6cpTTP8R1MAC1kF4VbdLt3ARf209w==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "escalade": "^3.2.0", + "picocolors": "^1.1.1" + }, + "bin": { + "update-browserslist-db": "cli.js" + }, + "peerDependencies": { + "browserslist": ">= 4.21.0" + } + }, + "node_modules/wrap-ansi": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", + "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/y18n": { + "version": "5.0.8", + "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", + "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/yaml": { + "version": "2.9.0", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.0.tgz", + "integrity": "sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==", + "license": "ISC", + "bin": { + "yaml": "bin.mjs" + }, + "engines": { + "node": ">= 14.6" + }, + "funding": { + "url": "https://github.com/sponsors/eemeli" + } + }, + "node_modules/yargs": { + "version": "17.7.3", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.3.tgz", + "integrity": "sha512-GZtjxm/J/4TSxuL3FNYjCmLktBTnIw/rVmKSIyKeYAZpmJB2ig9VauCC5xsa82GNKVKDAqpOn3KVzNt0zmrU0g==", + "license": "MIT", + "dependencies": { + "cliui": "^8.0.1", + "escalade": "^3.1.1", + "get-caller-file": "^2.0.5", + "require-directory": "^2.1.1", + "string-width": "^4.2.3", + "y18n": "^5.0.5", + "yargs-parser": "^21.1.1" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/yargs-parser": { + "version": "21.1.1", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz", + "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==", + "license": "ISC", + "engines": { + "node": ">=12" + } + } + } +} From 9f035a9be2c381d0a367268c5e2a132593b6996d Mon Sep 17 00:00:00 2001 From: Twisha Bansal <twishabansal07@gmail.com> Date: Mon, 22 Jun 2026 16:33:52 +0530 Subject: [PATCH 10/10] ci(docs): install PostCSS deps with npm ci for reproducible builds Use npm ci against the committed docs-site lockfile instead of npm install, which re-resolved latest semver each run and could pull a broken upstream patch into the deploy build. --- .github/workflows/api-docs.yml | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/.github/workflows/api-docs.yml b/.github/workflows/api-docs.yml index 8f1965214..4c9601938 100644 --- a/.github/workflows/api-docs.yml +++ b/.github/workflows/api-docs.yml @@ -58,11 +58,13 @@ jobs: - name: Install PostCSS Dependencies run: | - # --no-workspaces installs into docs-site/node_modules (where Hugo's - # PostCSS looks). docs-site/package.json pins postcss/postcss-cli/ - # autoprefixer. + # npm ci installs the exact versions from docs-site/package-lock.json + # into docs-site/node_modules (where Hugo's PostCSS looks), so the + # build is reproducible -- a broken upstream patch can't be pulled in. + # docs-site/package.json pins postcss/postcss-cli/autoprefixer; the + # lockfile freezes their transitive deps. cd docs-site - npm install --no-workspaces + npm ci - name: Resolve build target id: resolve