feat: widen the webui library surface for consumers building their own pages

[netomi]

Stack: 1 of 6. Split out of #2027 so each part can be reviewed on its own. Base: main.

All commits here are @gnugomez's, cherry-picked with -x.

This is the part of #2027 that has nothing to do with download analytics: it widens what the published openvsx-webui package exposes, so a deployment can build its own pages on top of it.

• Pill component, with CategoryPill refactored onto it, and shared page primitives lifted out (page-primitives.tsx, focusOutline)
• Navbar chrome moved to a context (navbar-chrome-context.tsx), replacing extension-tint-context.tsx; scroll-to-top.tsx becomes scroll-restoration.tsx
• userLoading and account-menu entries exposed to consumers, via page-settings and MainContext
• Admin dashboard made extensible: a consumer can contribute pages, merged into the nav by category (nav-types.ts)
• The above re-exported from src/index.ts

Why it is first in the stack

It is independent of everything else in #2027, and it is a published API change — the surface other deployments compile against. That deserves a focused look at naming and stability, which is exactly what does not happen when it arrives as 30 of 114 files behind a feature.

It is also not purely additive: extension-tint-context.tsx is deleted and scroll-to-top renamed, so it changes existing chrome behaviour.

Notes on the split

Two things were adjusted while rebasing onto current main:

• menu-content.tsx conflicted with the publish overhaul (feat: publish extensions overhaul #2098) that landed since. Resolved by keeping both: main's PublishRoutes/PublishButton/useShortcut imports alongside this branch's ComponentType/useCallback/useMemo/Button/useNavigate.
• admin-dashboard.tsx conflicted with the Search Index page (feat: add a search index page to the admin dashboard #2121). Resolved by keeping the /search-index route and the contributed-pages splat, on the navItems rename.

One commit is mine rather than cherry-picked: the vite server.deps.inline entry. The new dashboard spec is the first test to mount a page reaching @mui/x-charts (the rate-limiting usage-stats chart, already on main), x-data-grid and x-date-pickers, whose ESM builds import directory paths Node's resolver rejects.

The @mui/x-charts entry is needed here on its own merits — I initially deferred it as analytics-related and that was wrong; it comes from a chart already on main.

Verification

yarn test 274 passing across 54 files, yarn lint clean, tsc --noEmit clean.

Refs #2027, #2025

[Copilot]

🟡 Changes recommended

The new consumer-provided admin-page path handling and navbar-blur extension hook contract need hardening/clarification to avoid invalid consumer input causing routing failures and to make the new exported behavior unambiguous.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

This PR broadens the published openvsx-webui package’s public surface so downstream deployments can build custom pages and extend chrome/menus/dashboard while reusing Open VSX’s core UI primitives and contexts.

Changes:

• Adds new exported UI primitives and shared styles (Pill, lifted page primitives like compactControl, glassSurface, etc.) and refactors existing components to use them.
• Replaces the extension-tint context with a new navbar-chrome context (tint + blur-depth extension) and renames scroll behavior to ScrollRestoration.
• Exposes additional extension points via PageSettings and exports (user menu contributions, admin dashboard contributed pages, MainContext additions, request/utils exports), with new unit tests covering these extension points.

File summaries

File	Description
webui/vite.config.mts	Inlines specific MUI X deps in Vitest’s Vite server to avoid ESM resolution issues in tests.
webui/test/unit/support/test-providers.tsx	Adds TestEntryShell + renderInEntryShell and updates MainContext test defaults for userLoading.
webui/test/unit/support/menu-queries.ts	Adds menu label query helper avoiding jsdom role-query crashes.
webui/test/unit/pages/user/avatar.spec.tsx	Adds tests for contributed desktop user-menu entries and their styling/behavior.
webui/test/unit/pages/admin-dashboard/admin-dashboard.spec.tsx	Adds tests for contributed admin pages (routing + nav grouping + shadow protection).
webui/test/unit/main.spec.tsx	Adds tests asserting MainContext.userLoading behavior during initial user fetch.
webui/test/unit/default/menu-content.spec.tsx	Adds tests for contributed mobile user-menu entries and styling.
webui/src/pages/user/avatar.tsx	Adds support for contributed user-menu entries via PageSettings.elements.userMenuContent.
webui/src/pages/search/search-header.tsx	Reuses shared compactControl styling primitive.
webui/src/pages/extension-detail/extension-detail.tsx	Switches to new navbar-chrome context and updates scroll behavior comment reference.
webui/src/pages/admin-dashboard/nav-types.ts	Introduces AdminPage and AdminPageCategory types for consumer-contributed dashboard pages.
webui/src/pages/admin-dashboard/admin-dashboard.tsx	Merges contributed admin pages into nav + routes, and builds route name map from merged nav.
webui/src/page-settings.ts	Adds userMenuContent and adminPages extension points + user-menu entry prop types.
webui/src/main.tsx	Exposes userLoading on MainContext.
webui/src/layout/scroll-restoration.tsx	Renames ScrollToTop to ScrollRestoration and documents current limitations.
webui/src/layout/app-navbar.tsx	Consumes navbar-chrome blur extent to stretch blur fan for pinned sections.
webui/src/layout/app-layout.tsx	Swaps tint provider for NavbarChromeProvider and uses ScrollRestoration.
webui/src/index.ts	Re-exports new/expanded public API surface for consumers (contexts, providers, primitives, utils, types).
webui/src/default/theme.tsx	Disables popover scroll lock and aligns popover paper styling with floating-paper treatment.
webui/src/default/menu-content.tsx	Adds contributed user-menu entries to mobile menu and keeps entry components stable.
webui/src/context/navbar-chrome-context.tsx	Adds new navbar-chrome context (tint + blur depth) and associated hooks/provider.
webui/src/context/extension-tint-context.tsx	Removes old extension tint context (superseded by navbar-chrome context).
webui/src/context.ts	Adds userLoading to the MainContext shape.
webui/src/components/pill.tsx	Adds new Pill primitive used by category pills and exported for consumers.
webui/src/components/page-primitives.tsx	Lifts shared primitives (e.g., MonoSlash, glassSurface, compactControl).
webui/src/components/extension-searchfield.tsx	Uses lifted MonoSlash from page-primitives.
webui/src/components/category-pill.tsx	Refactors CategoryPill onto the new Pill primitive.
webui/src/app-providers.tsx	Updates provider-stack docs to reflect navbar-chrome context.
webui/CHANGELOG.md	Documents new exports/extension points and behavior/context renames.

Review details

• Files reviewed: 29/29 changed files
• Comments generated: 3
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[netomi]

I tested this PR locally, so I think we can merge that already in for the 1.2.0 release.