Changelog, page 5

2026

Jul 23, 2026

#36 738c8a0 Thanks @mvvmm! - Merge partial headings into the parent page’s TOC. <Render file="..." /> partials that contain literal markdown headings (## Foo) now contribute those headings to the parent page’s “On this page” table of contents, in document order, recursively. Pass partialHeadings: { resolvePartialId } to getDocsPageProps() / getCollectionPageProps() to customise how <Render> attributes map to a partial collection id.

Jul 22, 2026

Jul 22, 2026

#27 1ebfb6c Thanks @MohamedH1998! - Add icon to sidebar groups — an optional leading icon (astro-icon name) before the group label. Set it two ways: on a directory’s index frontmatter (sidebar: { group: { icon: "ph:…" } }) or on a config sidebar.items group entry ({ label, icon: "ph:…", autogenerate: … }). Threaded through the group schema, SidebarGroupItem / SidebarConfigItem types, and the sidebar tree builder (both the content-derived and config-defined paths).

Jul 22, 2026

#27 1ebfb6c Thanks @MohamedH1998! - Align the sidebar, add a mobile “On this page” TOC, and tighten the docs layout’s mobile and horizontal-overflow handling.
- Sidebar + TOC: the sidebar filter gains a press / to focus kbd hint and a placeholder prop; sidebar groups render an optional leading icon (from sidebar.group.icon); and a sticky native-<select> “On this page” TOC now appears under the page title on viewports below xl, where the desktop TOC rail hides.
- Mobile sidebar drawer: the drawer no longer dims or blurs the page — it slides in over a transparent overlay so the page copy stays readable, with a hairline edge instead of a shadow. Both the drawer panel and the desktop sidebar now paint their own background and contain overscroll, fixing a “no background” flash on fast/momentum scroll.
- Tabs: a tab strip wider than its column now scrolls horizontally (scrollbar hidden) instead of leaking past the page width, and the active tab is scrolled into view on activate/restore.
- Prose: long unbroken tokens (URLs, hashes) wrap within the content column via overflow-wrap: break-word instead of overflowing the page; code blocks and wide tables keep their own scroll handling.

Jul 22, 2026

#24 52d5a0c Thanks @MohamedH1998! - Fix scaffolded starter behavior across client-side navigations and add a 404 page.
- Re-run component initializers on astro:page-load so interactive components (code groups, dialogs, popovers, file trees, search) keep working after ClientRouter/view-transition navigations.
- Scope the search dialog’s global key handler to a module variable instead of an <html> attribute, preventing a duplicate Cmd+K handler from stacking on each navigation.
- Mark inline SVG icons with is:inline so they render reliably.
- Ship a default 404.astro page in the starter.

Jul 21, 2026

#22 7ec9715 Thanks @MohamedH1998! - Republish with npm provenance attestations. Supersedes 0.6.0 / 0.5.0, which published without provenance and before the repo was public.

Jul 21, 2026

#22 7ec9715 Thanks @MohamedH1998! - Republish with npm provenance attestations. Supersedes 0.6.0 / 0.5.0, which published without provenance and before the repo was public.

Jul 21, 2026

Jul 21, 2026

#18 24fd3b0 Thanks @MohamedH1998! - Fix @shikijs/types dedup so Code.astro typechecks in consuming sites

The published dist inlined a local copy of @shikijs/types’s ShikiTransformer surface instead of importing it, so defaultCodeTransformers never deduped against the @shikijs/types that Astro’s <Code> uses — breaking astro check in scaffolded sites. The build now keeps @shikijs/types and @shikijs/transformers as external type imports in the emitted .d.ts, and @shikijs/types is a runtime dependency (^4.2.0) so the import resolves for consumers. No API or runtime behavior change.

Releases before these are in the project changelog.