diff --git a/scripts/docs-site/assets.mjs b/scripts/docs-site/assets.mjs
index 90eb52cb96..0d1a8cf7a8 100644
--- a/scripts/docs-site/assets.mjs
+++ b/scripts/docs-site/assets.mjs
@@ -9,7 +9,7 @@ export function siteCss() {
 :root{--tooltip-bg:#ededed;--tooltip-text:#17171a;--tooltip-border:#ededed;--sticky-header-h:121px}:root[data-theme="light"]{--tooltip-bg:#17171a;--tooltip-text:#f6f5f3;--tooltip-border:#17171a}
 .oc-table-wrap{max-width:100%;overflow:auto;margin:22px 0 28px;border:1px solid var(--line-strong);border-radius:0;background:color-mix(in srgb,var(--paper) 72%,transparent)}.doc .oc-table{margin:0;width:100%;min-width:560px;border-collapse:separate;border-spacing:0;font-size:13px}.doc .oc-table th,.doc .oc-table td{border:0;border-bottom:1px solid var(--line);padding:10px 12px;text-align:left;vertical-align:top;overflow-wrap:anywhere;word-break:break-word}.doc .oc-table th{position:sticky;top:0;background:color-mix(in srgb,var(--paper-2) 86%,var(--soft) 14%);color:var(--ink);font:780 12px/1.35 Switzer,ui-sans-serif,system-ui,sans-serif}.doc .oc-table tr:last-child td{border-bottom:0}.doc .oc-table td:first-child{color:var(--ink);font-weight:720}.oc-lead{margin:18px 0 28px;color:var(--text);font:500 17px/1.72 Switzer,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif}.oc-lead p{margin:0}.oc-pullquote{margin:30px 0;padding:3px 0 3px 24px;border-left:3px solid var(--brand);color:var(--ink)}.oc-pullquote blockquote{margin:0;padding:0;border:0;font:400 21px/1.55 Sentient,Georgia,serif;font-style:italic}.oc-pullquote figcaption{margin-top:10px;color:var(--muted);font-size:12px}.oc-stat-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(170px,100%),1fr));gap:12px;margin:24px 0}.oc-stat{border:1px solid var(--line-strong);border-radius:0;background:color-mix(in srgb,var(--paper) 72%,transparent);padding:15px 16px}.oc-stat strong{display:block;color:var(--ink);font:780 24px/1 Switzer,ui-sans-serif,system-ui,sans-serif;margin:0 0 8px}.oc-stat>span{display:block;color:var(--muted);font-size:12px;line-height:1.35}.oc-stat-delta{display:inline-block!important;width:max-content;margin-top:10px;padding:2px 7px;border:1px solid color-mix(in srgb,var(--brand) 35%,var(--line-strong));border-radius:2px;background:color-mix(in srgb,var(--brand) 10%,var(--paper));color:var(--brand)!important}.oc-stat div p{margin:.8em 0 0}.oc-cta{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:18px;align-items:end;margin:32px 0;padding:22px;border:1px solid color-mix(in srgb,var(--brand) 34%,var(--line-strong));border-radius:0;background:linear-gradient(135deg,color-mix(in srgb,var(--paper) 82%,var(--brand) 18%),color-mix(in srgb,var(--paper-2) 92%,transparent));box-shadow:var(--shadow)}.oc-cta-copy>span{display:block;color:var(--brand);font:780 12px/1.2 Switzer,ui-sans-serif,system-ui,sans-serif;margin:0 0 7px}.oc-cta-copy strong{display:block;color:var(--ink);font:780 19px/1.28 Switzer,ui-sans-serif,system-ui,sans-serif;margin:0 0 8px}.oc-cta-copy p{margin:0;color:var(--text)}.oc-cta-actions{display:flex;flex-wrap:wrap;gap:9px;align-items:center}.oc-cta-link{display:inline-flex;align-items:center;justify-content:center;min-height:38px;padding:10px 20px;border:1px solid var(--line-strong);border-radius:0;font:600 13px/1 ui-monospace,SFMono-Regular,"SF Mono",Menlo,Consolas,monospace;transition:background .16s ease,border-color .16s ease,color .16s ease,filter .16s ease}.oc-cta-link-primary{background:var(--brand);border-color:var(--brand);color:var(--on-brand)}.oc-cta-link-secondary{background:color-mix(in srgb,var(--paper) 78%,transparent);color:var(--ink)}.oc-cta-link:after{content:"→";margin-left:8px}.oc-cta-link:hover{filter:brightness(1.04)}.oc-cta-link-primary:hover{background:color-mix(in srgb,var(--brand) 86%,white 14%);border-color:color-mix(in srgb,var(--brand) 86%,white 14%);color:var(--on-brand)}.oc-cta-link-secondary:hover{background:color-mix(in srgb,var(--soft) 62%,var(--paper) 38%);border-color:color-mix(in srgb,var(--brand) 44%,var(--line-strong));color:var(--ink)}.oc-cta-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(230px,100%),1fr));gap:14px;margin:24px 0}.oc-cta-card{display:block;min-height:160px;border:1px solid var(--line-strong);border-radius:0;background:color-mix(in srgb,var(--paper) 78%,transparent);padding:18px 20px;color:var(--text);transition:border-color .16s ease,background .16s ease}.oc-cta-card:hover,.oc-cta-card:focus-visible{border-color:var(--brand);background:color-mix(in srgb,var(--soft) 38%,transparent);outline:0}.oc-cta-card .oc-card-icon{margin-bottom:14px}.oc-cta-card strong{display:block;color:var(--ink);font:760 16px/1.3 Switzer,ui-sans-serif,system-ui,sans-serif;margin:0 0 4px}.oc-cta-kicker{display:block;color:var(--brand);font:760 12px/1.35 Switzer,ui-sans-serif,system-ui,sans-serif;margin:0 0 9px}.oc-cta-card p{margin:0 0 14px;color:var(--muted)}.oc-cta-card .oc-cta-actions{margin-top:16px}.oc-chart{margin:28px 0;padding:16px;border:1px solid var(--line-strong);border-radius:0;background:color-mix(in srgb,var(--paper) 76%,transparent)}.oc-chart figcaption{display:flex;align-items:baseline;justify-content:space-between;gap:14px;margin:0 0 16px}.oc-chart figcaption strong{color:var(--ink);font:780 15px/1.25 Switzer,ui-sans-serif,system-ui,sans-serif}.oc-chart figcaption span{color:var(--muted);font-size:12px}.oc-chart-bars{display:grid;gap:10px}.oc-chart-row{display:grid;grid-template-columns:minmax(86px,150px) minmax(120px,1fr) auto;gap:10px;align-items:center}.oc-chart-row>span{color:var(--text);font-size:12px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.oc-chart-row strong{color:var(--ink);font:760 12px/1 Switzer,ui-sans-serif,system-ui,sans-serif}.oc-chart-track{height:10px;border-radius:0;background:color-mix(in srgb,var(--line-strong) 62%,transparent);overflow:hidden}.oc-chart-track i{display:block;width:var(--oc-chart-value);height:100%;border-radius:inherit;background:linear-gradient(90deg,var(--brand-2),var(--brand))}.oc-chart-line-wrap{display:grid;gap:10px}.oc-chart-line-svg{display:block;width:100%;height:auto;overflow:visible}.oc-chart-line-svg polyline{fill:none;stroke:var(--brand);stroke-width:3;stroke-linecap:round;stroke-linejoin:round}.oc-chart-line-svg circle{fill:var(--paper);stroke:var(--brand);stroke-width:3}.oc-chart-gridline{stroke:var(--line-strong);stroke-width:1}.oc-chart-axis{display:flex;justify-content:space-between;gap:8px;color:var(--muted);font-size:11px}.oc-chart-axis span{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.oc-chart-data{position:absolute!important;width:1px!important;height:1px!important;overflow:hidden!important;clip:rect(0,0,0,0)!important;white-space:nowrap!important}@media(max-width:820px){.oc-cta{grid-template-columns:1fr}.oc-chart-row{grid-template-columns:minmax(74px,110px) minmax(90px,1fr) auto}.doc .oc-table{min-width:0;table-layout:fixed}}
 *{box-sizing:border-box}html{scroll-behavior:smooth;scroll-padding-top:120px}body{margin:0;display:flex;flex-direction:column;min-height:100vh;background:var(--bg);color:var(--text);font:15px/1.7 Switzer,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;-webkit-font-smoothing:antialiased}::selection{background:var(--brand);color:var(--on-brand)}a{color:inherit;text-decoration:none}a:hover{color:var(--ink)}img{max-width:100%;height:auto}button,input,select{font:inherit}.hidden{display:none!important}.oc-visually-hidden{position:absolute!important;width:1px!important;height:1px!important;padding:0!important;margin:-1px!important;overflow:hidden!important;clip:rect(0,0,0,0)!important;white-space:nowrap!important;border:0!important}:root[data-theme="dark"] .dark\\:hidden{display:none!important}:root[data-theme="dark"] .dark\\:block{display:block!important}:root[data-theme="light"] .dark\\:block{display:none!important}
-.site-header{position:sticky;top:0;z-index:70;background:color-mix(in srgb,var(--bg) 94%,transparent);backdrop-filter:blur(18px);border-bottom:1px solid var(--line)}.header-row,.tabs{max-width:1780px;margin:0 auto}.doc-shell{width:100%;max-width:1780px;margin:0 auto;flex:1 0 auto}.header-row{height:62px;display:grid;grid-template-columns:minmax(0,1fr) minmax(300px,430px) minmax(0,1fr);gap:24px;align-items:center;padding:0 56px}.header-left{display:flex;align-items:center;gap:16px;min-width:0}.brand{display:inline-flex;align-items:center;gap:9px;flex:0 0 auto;color:var(--ink);font-weight:600;font-size:14.5px;letter-spacing:.02em}.brand img{width:22px;height:22px}.brand-name{color:var(--ink)}.brand-tag{color:var(--muted);font:600 10px/1 ui-monospace,SFMono-Regular,"SF Mono",Menlo,Consolas,monospace;letter-spacing:.08em;text-transform:uppercase;border:1px solid var(--line-strong);padding:3px 6px;margin-left:2px}.language-picker{position:relative;min-width:0}.language-trigger{height:36px;border:1px solid transparent;border-radius:0;background:color-mix(in srgb,var(--paper) 62%,transparent);color:var(--ink);display:flex;align-items:center;gap:9px;max-width:190px;padding:0 12px 0 11px;cursor:pointer;transition:background .16s ease,border-color .16s ease,box-shadow .16s ease,color .16s ease}.language-trigger:hover,.language-picker.open .language-trigger{background:var(--paper);border-color:var(--line-strong);color:var(--ink)}.language-trigger:focus-visible{outline:0;border-color:var(--brand);box-shadow:0 0 0 3px color-mix(in srgb,var(--brand) 28%,transparent),0 10px 30px rgba(0,0,0,.20)}.language-trigger:hover .language-chevron{color:var(--brand)}.locale-flag{width:21px;height:21px;border-radius:50%;display:inline-grid;place-items:center;font-size:17px;line-height:1;overflow:hidden;flex:0 0 auto}.language-current{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:14px;color:var(--ink)}.language-chevron{display:inline-flex;align-items:center;justify-content:center;width:16px;height:16px;color:var(--muted);line-height:1;transition:transform .16s ease,color .16s ease}.language-chevron .icon{width:16px;height:16px}.language-picker.open .language-chevron{transform:rotate(180deg);color:var(--brand)}.language-menu{position:absolute;top:calc(100% + 10px);left:auto;right:0;width:min(340px,calc(100vw - 32px));max-height:min(72vh,720px);overflow:auto;display:none;z-index:80;padding:10px;background:color-mix(in srgb,var(--bg) 92%,#000 8%);border:1px solid var(--line-strong);border-radius:0;box-shadow:0 30px 90px rgba(0,0,0,.52)}.language-picker.open .language-menu{display:block}.language-option{display:grid;grid-template-columns:30px minmax(0,1fr) 22px;align-items:center;gap:12px;padding:12px 16px;border-radius:0;color:var(--ink);font-weight:800;font-size:18px;line-height:1.2}.language-option:hover{background:color-mix(in srgb,var(--paper-2) 84%,transparent);color:var(--ink)}.language-option.active{color:var(--brand)}.language-option.active:hover{background:color-mix(in srgb,var(--soft) 84%,transparent)}.language-name{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.language-check{opacity:0;color:var(--brand);font-size:19px;text-align:right}.language-option.active .language-check{opacity:1}.icon{display:block;width:18px;height:18px;min-width:18px;max-width:18px;flex:0 0 18px}.search-button{height:38px;border:1px solid var(--line-strong);border-radius:0;background:color-mix(in srgb,var(--paper) 86%,transparent);color:var(--muted);display:grid;grid-template-columns:auto minmax(0,1fr) auto;align-items:center;gap:10px;padding:0 9px 0 14px;cursor:pointer;text-align:left}.search-button:hover{background:var(--paper);border-color:var(--line-strong);color:var(--text)}.search-button:hover .search-shortcut{border-color:var(--line-strong);color:var(--ink);background:var(--paper-2)}.search-label{min-width:0;font-size:14px;color:var(--muted)}.search-shortcut{display:inline-grid;place-items:center;justify-self:end;min-width:44px;height:28px;padding:0 9px;border:1px solid var(--line-strong);border-radius:0;background:color-mix(in srgb,var(--paper-2) 82%,transparent);color:var(--text);font:760 13px/1 ui-monospace,SFMono-Regular,"SF Mono",Menlo,Consolas,monospace}.header-links{display:flex;align-items:center;justify-content:flex-end;gap:22px;color:var(--muted);font-size:14px;white-space:nowrap}.header-links a{display:inline-flex;align-items:center;gap:7px;color:var(--muted);font-weight:650}.header-links a:hover{color:var(--ink)}.header-links a .icon{width:16px;height:16px;color:var(--ink)}.header-links .top-icon-link{padding:2px}.header-links .top-icon-link .icon{width:18px;height:18px;min-width:18px;max-width:18px;color:currentColor}.header-links button{border:0;background:transparent;color:var(--muted);cursor:pointer;padding:4px}.header-links button:hover{color:var(--ink)}.theme-toggle{display:inline-grid;place-items:center;width:28px;height:28px}.theme-toggle .icon{width:18px;height:18px}.nav-toggle{display:none;flex-direction:column;gap:4px;border:0;background:none;color:var(--muted);cursor:pointer;padding:5px 2px;transition:color .15s ease}.nav-toggle:hover{color:var(--ink)}.nav-toggle span{display:block;width:18px;height:1.6px;background:currentColor;border-radius:1px;transition:transform .25s ease,opacity .2s ease}body.nav-open .nav-toggle span:nth-child(1){transform:translateY(5.6px) rotate(45deg)}body.nav-open .nav-toggle span:nth-child(2){opacity:0}body.nav-open .nav-toggle span:nth-child(3){transform:translateY(-5.6px) rotate(-45deg)}.sidebar-close{display:none}
+.site-header{position:sticky;top:0;z-index:70;background:color-mix(in srgb,var(--bg) 94%,transparent);backdrop-filter:blur(18px);border-bottom:1px solid var(--line)}.header-row,.tabs{max-width:1780px;margin:0 auto}.doc-shell{width:100%;max-width:1780px;margin:0 auto;flex:1 0 auto}.header-row{height:62px;display:grid;grid-template-columns:minmax(0,1fr) minmax(300px,430px) minmax(0,1fr);gap:24px;align-items:center;padding:0 56px}.header-left{display:flex;align-items:center;gap:16px;min-width:0}.brand{display:inline-flex;align-items:center;gap:9px;flex:0 0 auto;color:var(--ink);font-weight:600;font-size:14.5px;letter-spacing:.02em}.brand img{width:22px;height:22px}.brand-name{color:var(--ink)}.brand-tag{color:var(--muted);font:600 10px/1 ui-monospace,SFMono-Regular,"SF Mono",Menlo,Consolas,monospace;letter-spacing:.08em;text-transform:uppercase;border:1px solid var(--line-strong);padding:3px 6px;margin-left:2px}.language-picker{position:relative;min-width:0}.language-trigger{height:36px;border:1px solid transparent;border-radius:0;background:color-mix(in srgb,var(--paper) 62%,transparent);color:var(--ink);display:flex;align-items:center;gap:9px;max-width:190px;padding:0 12px 0 11px;cursor:pointer;transition:background .16s ease,border-color .16s ease,box-shadow .16s ease,color .16s ease}.language-trigger:hover,.language-picker.open .language-trigger{background:var(--paper);border-color:var(--line-strong);color:var(--ink)}.language-trigger:focus-visible{outline:0;border-color:var(--brand);box-shadow:0 0 0 3px color-mix(in srgb,var(--brand) 28%,transparent),0 10px 30px rgba(0,0,0,.20)}.language-trigger:hover .language-chevron{color:var(--brand)}.locale-flag{width:21px;height:21px;border-radius:50%;display:inline-grid;place-items:center;font-size:17px;line-height:1;overflow:hidden;flex:0 0 auto}.language-current{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:14px;color:var(--ink)}.language-chevron{display:inline-flex;align-items:center;justify-content:center;width:16px;height:16px;color:var(--muted);line-height:1;transition:transform .16s ease,color .16s ease}.language-chevron .icon{width:16px;height:16px}.language-picker.open .language-chevron{transform:rotate(180deg);color:var(--brand)}.language-menu{position:absolute;top:calc(100% + 10px);left:auto;right:0;width:min(340px,calc(100vw - 32px));max-height:min(72vh,720px);overflow:auto;display:none;z-index:80;padding:10px;background:color-mix(in srgb,var(--bg) 92%,#000 8%);border:1px solid var(--line-strong);border-radius:0;box-shadow:0 30px 90px rgba(0,0,0,.52)}.language-picker.open .language-menu{display:block}.language-option{display:grid;grid-template-columns:30px minmax(0,1fr) 22px;align-items:center;gap:12px;padding:12px 16px;border-radius:0;color:var(--ink);font-weight:800;font-size:18px;line-height:1.2}.language-option:hover{background:color-mix(in srgb,var(--paper-2) 84%,transparent);color:var(--ink)}.language-option.active{color:var(--brand)}.language-option.active:hover{background:color-mix(in srgb,var(--soft) 84%,transparent)}.language-name{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.language-check{opacity:0;color:var(--brand);font-size:19px;text-align:right}.language-option.active .language-check{opacity:1}.icon{display:block;width:18px;height:18px;min-width:18px;max-width:18px;flex:0 0 18px}.search-button{height:38px;border:1px solid var(--line-strong);border-radius:0;background:color-mix(in srgb,var(--paper) 86%,transparent);color:var(--muted);display:grid;grid-template-columns:auto minmax(0,1fr) auto;align-items:center;gap:10px;padding:0 9px 0 14px;cursor:pointer;text-align:left}.search-button:hover{background:var(--paper);border-color:var(--line-strong);color:var(--text)}.search-button:hover .search-shortcut{border-color:var(--line-strong);color:var(--ink);background:var(--paper-2)}.search-label{min-width:0;font-size:14px;color:var(--muted)}.search-shortcut{display:inline-grid;place-items:center;justify-self:end;min-width:44px;height:28px;padding:0 9px;border:1px solid var(--line-strong);border-radius:0;background:color-mix(in srgb,var(--paper-2) 82%,transparent);color:var(--text);font:760 13px/1 ui-monospace,SFMono-Regular,"SF Mono",Menlo,Consolas,monospace}.header-links{display:flex;align-items:center;justify-content:flex-end;gap:22px;color:var(--muted);font-size:14px;white-space:nowrap}.header-links>a{display:inline-flex;align-items:center;gap:7px;color:var(--muted);font-weight:650}.header-links>a:hover{color:var(--ink)}.header-links>a .icon{width:16px;height:16px;color:var(--ink)}.header-links .top-icon-link{padding:2px}.header-links .top-icon-link .icon{width:18px;height:18px;min-width:18px;max-width:18px;color:currentColor}.header-links button{border:0;background:transparent;color:var(--muted);cursor:pointer;padding:4px}.header-links button:hover{color:var(--ink)}.theme-toggle{display:inline-grid;place-items:center;width:28px;height:28px}.theme-toggle .icon{width:18px;height:18px}.nav-toggle{display:none;flex-direction:column;gap:4px;border:0;background:none;color:var(--muted);cursor:pointer;padding:5px 2px;transition:color .15s ease}.nav-toggle:hover{color:var(--ink)}.nav-toggle span{display:block;width:18px;height:1.6px;background:currentColor;border-radius:1px;transition:transform .25s ease,opacity .2s ease}body.nav-open .nav-toggle span:nth-child(1){transform:translateY(5.6px) rotate(45deg)}body.nav-open .nav-toggle span:nth-child(2){opacity:0}body.nav-open .nav-toggle span:nth-child(3){transform:translateY(-5.6px) rotate(-45deg)}.sidebar-close{display:none}
 .search-shortcut{display:inline-flex;align-items:center;justify-content:flex-end;gap:2px;color:var(--muted);font:760 15px/1 ui-monospace,SFMono-Regular,"SF Mono",Menlo,Consolas,monospace;background:transparent;border:0;border-radius:0;box-shadow:none;min-width:0;height:15px;padding:0}.search-shortcut span{display:block;line-height:15px}.search-shortcut .icon{width:15px;height:15px;min-width:15px;max-width:15px;stroke-width:2.2}.search-button:hover .search-shortcut{background:transparent;border-color:transparent;color:var(--ink)}
 .theme-toggle-icon{display:none;place-items:center}:root[data-theme="dark"] .theme-toggle-icon-dark,:root[data-theme="light"] .theme-toggle-icon-light{display:grid}
 .tabs{position:relative;display:flex;align-items:center;gap:32px;min-height:58px;padding:0 56px;overflow-x:auto;white-space:nowrap}.tab-link{position:relative;color:var(--muted);font:700 13px/1.4 ui-monospace,SFMono-Regular,"SF Mono",Menlo,Consolas,monospace;padding:19px 0 20px;transition:color .18s ease}.tab-link:hover{color:var(--ink)}.tab-link.active{color:var(--ink)}.tab-underline{position:absolute;left:0;bottom:0;height:2px;width:var(--tu-w,0);transform:translate3d(var(--tu-x,0),0,0);background:var(--brand);border-radius:2px;pointer-events:none;opacity:0;will-change:transform,width;transition:transform .28s cubic-bezier(.4,0,.2,1),width .28s cubic-bezier(.4,0,.2,1),opacity .18s ease}.tabs.is-ready .tab-underline{opacity:1}.tab-underline.no-transition{transition:none}@media(prefers-reduced-motion:reduce){.tab-underline{transition:opacity .18s ease}}
diff --git a/scripts/docs-site/smoke.mjs b/scripts/docs-site/smoke.mjs
index 05a9f8d3df..4915bdcbbb 100644
--- a/scripts/docs-site/smoke.mjs
+++ b/scripts/docs-site/smoke.mjs
@@ -285,6 +285,12 @@ if (!/\.language-menu\{top:calc\(100% \+ 8px\);width:min\(270px,calc\(100vw - 32
   || !/\.language-menu::-webkit-scrollbar-track\{background:transparent\}/.test(siteCss)) {
   throw new Error("assets: compact language picker is missing");
 }
+if (/\.header-links a[\s{:.[]/.test(siteCss)) {
+  throw new Error("assets: .header-links descendant anchor rules override .language-option layout; scope to .header-links>a");
+}
+if (!/\.header-links>a\{display:inline-flex/.test(siteCss) || !/\.language-option\{display:grid/.test(siteCss)) {
+  throw new Error("assets: language menu options must stack as grid rows");
+}
 try {
   execFileSync(process.execPath, ["--check", path.join(site, "assets/docs-site.js")], { stdio: "pipe" });
 } catch (err) {