0.5.0 is the first element quality release, covering every A, B and C element. Components rebuild cleanly when moved or re-populated, keyboard and screen-reader access is fixed across the C components, and several XSS paths are closed. Themes gain a --btn-border-width hook,…
Aggregated most-visited lens. Fetches from an analytics endpoint and degrades gracefully when the endpoint is unavailable, returns 5xx, or returns an empty list.
The aggregated counterpart to <recently-visited>. Where that surface is local-only, this one consumes site-wide aggregate data from an analytics endpoint and shows the most-visited pages.
The default endpoint /api/analytics/popular is not yet implemented in the VB site — the component degrades to a friendly explanatory message when the endpoint is unavailable, returns 5xx, or returns an empty list. Sites that don't run analytics can hide it via display: none or simply not place the element.
<popularity-index limit="10" window="7d" data-meta-src="/pages.json"></popularity-index>| Attribute | Type | Default | Description |
|---|---|---|---|
analytics-src | string | "/api/analytics/popular" | Endpoint URL that returns popularity data |
data-meta-src | string | — | Optional pages.json URL used to enrich each entry with title/topic/provenance metadata when the endpoint returns sparse data |
data-lens-src | string | — | The lens family's shared pages.json URL (forwarded by <content-lens>). Used only as the metadata source when data-meta-src is unset — never as the analytics endpoint |
limit | number | 10 | Max entries shown |
window | string | — | Optional time-window query forwarded as ?window=24h (or 7d, 30d) |
The component expects the endpoint to respond with JSON in either of these shapes:
<!--[CDATA[{ "pages": [ { "url": "/docs/concepts/document-provenance/", "title": "Document Provenance", "views": 1234 }, { "url": "/glossary/", "title": "Glossary", "views": 980 }]}]]-->or simply an array. Each entry must carry url; title and views are optional but improve the rendered list. If data-meta-src is set, missing titles fall back to the matching pages.json record.