svelte-docsmith 0.10.0 → 0.11.0

package/dist/components/chrome/version-banner.svelte

@@ -1,12 +1,7 @@
 <script lang="ts">
 	import TriangleAlert from '@lucide/svelte/icons/triangle-alert';
 	import ArrowRight from '@lucide/svelte/icons/arrow-right';
-	import {
-		mapPathToVersion,
-		scopeContent,
-		type ResolvedVersion,
-		type DocsContentItem
-	} from '../../core/index.js';
+	import type { ResolvedVersion } from '../../core/index.js';
 
 	// Rendered by DocsShell only on an archived version, to warn a reader who
 	// landed there (usually from a search engine) and give them a one-click path
@@ -15,23 +10,13 @@
 	const {
 		active,
 		current,
-		pathname,
-		content
+		href
 	}: {
 		active: ResolvedVersion;
 		current: ResolvedVersion;
-		pathname: string;
-		content: DocsContentItem[];
+		/** This page under the current version, from the resolved page view. */
+		href: string;
 	} = $props();
-
-	const currentHref = $derived(
-		mapPathToVersion(
-			pathname,
-			active,
-			current,
-			scopeContent(content, current.id).map((c) => c.path)
-		)
-	);
 </script>
 
 <div class="docsmith-version-banner" role="note">
@@ -39,7 +24,7 @@
 	<p>
 		You're reading the <strong>{active.label}</strong> docs. The current version is
 		<strong>{current.label}</strong>.
-		<a href={currentHref}>View this page in {current.label} <ArrowRight size={14} /></a>
+		<a {href}>View this page in {current.label} <ArrowRight size={14} /></a>
 	</p>
 </div>
 

package/dist/components/chrome/version-banner.svelte.d.ts

@@ -1,9 +1,9 @@
-import { type ResolvedVersion, type DocsContentItem } from '../../core/index.js';
+import type { ResolvedVersion } from '../../core/index.js';
 type $$ComponentProps = {
     active: ResolvedVersion;
     current: ResolvedVersion;
-    pathname: string;
-    content: DocsContentItem[];
+    /** This page under the current version, from the resolved page view. */
+    href: string;
 };
 declare const VersionBanner: import("svelte").Component<$$ComponentProps, {}, "">;
 type VersionBanner = ReturnType<typeof VersionBanner>;

package/dist/components/chrome/version-switcher.svelte

@@ -4,60 +4,50 @@
 	import * as DropdownMenu from '../shadcn/dropdown-menu/index.js';
 	import Check from '@lucide/svelte/icons/check';
 	import ChevronsUpDown from '@lucide/svelte/icons/chevrons-up-down';
-	import {
-		mapPathToVersion,
-		scopeContent,
-		type ResolvedVersion,
-		type DocsContentItem
-	} from '../../core/index.js';
+	import type { VersionLink } from '../../core/index.js';
 
+	// Purely presentational: where each version leads is resolved once, with the
+	// rest of the page view, in `core/docs-page.ts`.
 	const {
-		versions,
-		active,
-		pathname,
-		content
+		links
 	}: {
-		/** All declared versions, in switcher order. */
-		versions: ResolvedVersion[];
-		/** The version the current page belongs to. */
-		active: ResolvedVersion;
-		/** The current normalized pathname, e.g. `/docs/v2/intro`. */
-		pathname: string;
-		/** Full content index, to map the current page into the chosen version. */
-		content: DocsContentItem[];
+		/** Every declared version and its destination, in switcher order. */
+		links: VersionLink[];
 	} = $props();
 
-	function select(target: ResolvedVersion) {
-		if (target.id === active.id) return;
-		const paths = scopeContent(content, target.id).map((c) => c.path);
-		goto(mapPathToVersion(pathname, active, target, paths));
+	const active = $derived(links.find((link) => link.active));
+
+	function select(link: VersionLink) {
+		if (link.active) return;
+		goto(link.href);
 	}
 </script>
 
-<DropdownMenu.Root>
-	<DropdownMenu.Trigger>
-		{#snippet child({ props })}
-			<Button
-				variant="outline"
-				size="sm"
-				class="h-8 gap-1.5 px-2.5 font-medium"
-				aria-label={`Documentation version: ${active.label}. Change version`}
-				{...props}
-			>
-				<span class="truncate">{active.label}</span>
-				<ChevronsUpDown class="size-3.5 shrink-0 opacity-60" aria-hidden="true" />
-			</Button>
-		{/snippet}
-	</DropdownMenu.Trigger>
-	<DropdownMenu.Content align="start" class="w-44">
-		{#each versions as version (version.id)}
-			<DropdownMenu.Item onSelect={() => select(version)} class="gap-2">
-				<Check
-					class="size-4 {version.id === active.id ? 'opacity-100' : 'opacity-0'}"
-					aria-hidden="true"
-				/>
-				<span class="flex-1 truncate">{version.label}</span>
-			</DropdownMenu.Item>
-		{/each}
-	</DropdownMenu.Content>
-</DropdownMenu.Root>
+<!-- Nothing to switch from without an active version, which only happens on an
+     unversioned site, where the header doesn't render this at all. -->
+{#if active}
+	<DropdownMenu.Root>
+		<DropdownMenu.Trigger>
+			{#snippet child({ props })}
+				<Button
+					variant="outline"
+					size="sm"
+					class="h-8 gap-1.5 px-2.5 font-medium"
+					aria-label={`Documentation version: ${active.label}. Change version`}
+					{...props}
+				>
+					<span class="truncate">{active.label}</span>
+					<ChevronsUpDown class="size-3.5 shrink-0 opacity-60" aria-hidden="true" />
+				</Button>
+			{/snippet}
+		</DropdownMenu.Trigger>
+		<DropdownMenu.Content align="start" class="w-44">
+			{#each links as link (link.id)}
+				<DropdownMenu.Item onSelect={() => select(link)} class="gap-2">
+					<Check class="size-4 {link.active ? 'opacity-100' : 'opacity-0'}" aria-hidden="true" />
+					<span class="flex-1 truncate">{link.label}</span>
+				</DropdownMenu.Item>
+			{/each}
+		</DropdownMenu.Content>
+	</DropdownMenu.Root>
+{/if}

package/dist/components/chrome/version-switcher.svelte.d.ts

@@ -1,13 +1,7 @@
-import { type ResolvedVersion, type DocsContentItem } from '../../core/index.js';
+import type { VersionLink } from '../../core/index.js';
 type $$ComponentProps = {
-    /** All declared versions, in switcher order. */
-    versions: ResolvedVersion[];
-    /** The version the current page belongs to. */
-    active: ResolvedVersion;
-    /** The current normalized pathname, e.g. `/docs/v2/intro`. */
-    pathname: string;
-    /** Full content index, to map the current page into the chosen version. */
-    content: DocsContentItem[];
+    /** Every declared version and its destination, in switcher order. */
+    links: VersionLink[];
 };
 declare const VersionSwitcher: import("svelte").Component<$$ComponentProps, {}, "">;
 type VersionSwitcher = ReturnType<typeof VersionSwitcher>;

package/dist/components/docs-page-context.d.ts

@@ -0,0 +1,20 @@
+import type { DocsPageView } from '../core/index.js';
+/** A live read of the page view: `view` re-reads the shell's `$derived`. */
+export type DocsPageContext = {
+    readonly view: DocsPageView;
+};
+/**
+ * Publish the page view. `DocsShell` calls this once, with a getter rather than
+ * a value, so readers see the current `$derived` rather than the one that
+ * existed at init.
+ */
+export declare function setDocsPage(view: () => DocsPageView): void;
+/**
+ * Read the page view. `getContext` only works during init, so this hands back
+ * an accessor rather than a snapshot: hold it at init, read `.view` where the
+ * value is used, and the read stays reactive.
+ *
+ * Throws outside `DocsShell`. Every caller is internal chrome the shell renders
+ * itself, so an absent context is a wiring bug, not a supported mode.
+ */
+export declare function useDocsPage(): DocsPageContext;

package/dist/components/docs-page-context.js

@@ -0,0 +1,41 @@
+/**
+ * The resolved page view, on context.
+ *
+ * `core/docs-page.ts` decides what the page is; this is the single route that
+ * decision travels to the chrome. Publishing it once is what keeps the headers
+ * from taking props described in terms of their grandchildren, and the search
+ * scope from being pushed into shared mutable state by an effect.
+ *
+ * Sits at the root of `components/` rather than in a concern folder of its own:
+ * `core/` stays free of any Svelte import, and both `layouts/` and `chrome/`
+ * read this, so it can't live in either without one importing the other.
+ */
+import { getContext, setContext } from 'svelte';
+const KEY = Symbol('docsmith-page');
+/**
+ * Publish the page view. `DocsShell` calls this once, with a getter rather than
+ * a value, so readers see the current `$derived` rather than the one that
+ * existed at init.
+ */
+export function setDocsPage(view) {
+    setContext(KEY, view);
+}
+/**
+ * Read the page view. `getContext` only works during init, so this hands back
+ * an accessor rather than a snapshot: hold it at init, read `.view` where the
+ * value is used, and the read stays reactive.
+ *
+ * Throws outside `DocsShell`. Every caller is internal chrome the shell renders
+ * itself, so an absent context is a wiring bug, not a supported mode.
+ */
+export function useDocsPage() {
+    const get = getContext(KEY);
+    if (!get) {
+        throw new Error('[svelte-docsmith] this component must be rendered inside <DocsShell>.');
+    }
+    return {
+        get view() {
+            return get();
+        }
+    };
+}

package/dist/components/layouts/docs-header.svelte

@@ -7,46 +7,32 @@
 	import { useSearch } from '../../search/context.svelte.js';
 	import ThemeToggle from '../chrome/theme-toggle.svelte';
 	import VersionSwitcher from '../chrome/version-switcher.svelte';
-	import type {
-		DocsmithConfig,
-		DocsmithLink,
-		DocsContentItem,
-		ResolvedVersion
-	} from '../../core/index.js';
+	import type { DocsmithConfig, DocsmithLink } from '../../core/index.js';
 	import BookOpenText from '@lucide/svelte/icons/book-open-text';
 	import type { Snippet } from 'svelte';
-	import { page } from '$app/state';
 	import { cn } from '../../utils/cn.js';
 	import { normalizePath } from '../../utils/normalize-path.js';
+	import { useDocsPage } from '../docs-page-context.js';
 
 	const {
 		config,
 		logo,
-		actions,
-		versions = [],
-		active,
-		content = [],
-		pathname = ''
+		actions
 	}: {
 		config: DocsmithConfig;
 		/** Custom logo mark; defaults to a book icon in a primary-tinted chip. */
 		logo?: Snippet;
 		/** Extra header controls, rendered before the theme toggle. */
 		actions?: Snippet;
-		/** Declared versions; renders the switcher once there's more than one. */
-		versions?: ResolvedVersion[];
-		/** The active version, for the switcher's current selection. */
-		active?: ResolvedVersion;
-		/** Content index, so the switcher can map the current page across versions. */
-		content?: DocsContentItem[];
-		/** Current normalized pathname, for the switcher's page mapping. */
-		pathname?: string;
 	} = $props();
 
 	// Present only when the consumer passed a `search` loader to DocsShell.
 	const search = useSearch();
 
-	const current = $derived(normalizePath(page.url.pathname));
+	// Everything about the page being read comes off the shell's one resolved
+	// view, including the normalized path the nav highlights against.
+	const docsPage = useDocsPage();
+	const current = $derived(docsPage.view.pathname);
 
 	/**
 	 * A header link is usually the entry point to a whole section rather than a
@@ -109,9 +95,9 @@
 				</nav>
 			{/if}
 
-			{#if versions.length > 1 && active}
+			{#if docsPage.view.versionLinks.length > 1}
 				<div class="px-1">
-					<VersionSwitcher {versions} {active} {content} {pathname} />
+					<VersionSwitcher links={docsPage.view.versionLinks} />
 				</div>
 			{:else if config.version}
 				<div class="px-2">

package/dist/components/layouts/docs-header.svelte.d.ts

@@ -1,4 +1,4 @@
-import type { DocsmithConfig, DocsContentItem, ResolvedVersion } from '../../core/index.js';
+import type { DocsmithConfig } from '../../core/index.js';
 import type { Snippet } from 'svelte';
 type $$ComponentProps = {
     config: DocsmithConfig;
@@ -6,14 +6,6 @@ type $$ComponentProps = {
     logo?: Snippet;
     /** Extra header controls, rendered before the theme toggle. */
     actions?: Snippet;
-    /** Declared versions; renders the switcher once there's more than one. */
-    versions?: ResolvedVersion[];
-    /** The active version, for the switcher's current selection. */
-    active?: ResolvedVersion;
-    /** Content index, so the switcher can map the current page across versions. */
-    content?: DocsContentItem[];
-    /** Current normalized pathname, for the switcher's page mapping. */
-    pathname?: string;
 };
 declare const DocsHeader: import("svelte").Component<$$ComponentProps, {}, "">;
 type DocsHeader = ReturnType<typeof DocsHeader>;

package/dist/components/layouts/docs-mobile-header.svelte

@@ -1,11 +1,6 @@
 <script lang="ts">
 	import { page } from '$app/state';
-	import type {
-		DocsmithConfig,
-		NavGroup,
-		DocsContentItem,
-		ResolvedVersion
-	} from '../../core/index.js';
+	import type { DocsmithConfig, NavGroup } from '../../core/index.js';
 	import type { TocItem } from '../../toc/index.js';
 	import DocsSidebar from './docs-sidebar.svelte';
 	import TableOfContents from '../chrome/table-of-contents.svelte';
@@ -17,6 +12,7 @@
 	import { Separator } from '../shadcn/separator/index.js';
 	import * as Sheet from '../shadcn/sheet/index.js';
 	import { useSearch } from '../../search/context.svelte.js';
+	import { useDocsPage } from '../docs-page-context.js';
 	import BookOpenText from '@lucide/svelte/icons/book-open-text';
 	import Menu from '@lucide/svelte/icons/menu';
 	import PanelRight from '@lucide/svelte/icons/panel-right';
@@ -30,11 +26,7 @@
 		tocItems = [],
 		tocActiveId = null,
 		logo,
-		actions,
-		versions = [],
-		active,
-		content = [],
-		pathname = ''
+		actions
 	}: {
 		config: DocsmithConfig;
 		/** Sidebar groups; omit on non-doc pages (the landing/`page` layout). */
@@ -47,17 +39,10 @@
 		tocActiveId?: string | null;
 		logo?: Snippet;
 		actions?: Snippet;
-		/** Declared versions; renders the switcher in the drawer once there's more than one. */
-		versions?: ResolvedVersion[];
-		/** The active version, for the switcher's current selection. */
-		active?: ResolvedVersion;
-		/** Content index, so the switcher can map the current page across versions. */
-		content?: DocsContentItem[];
-		/** Current normalized pathname, for the switcher's page mapping. */
-		pathname?: string;
 	} = $props();
 
 	const search = useSearch();
+	const docsPage = useDocsPage();
 
 	let isMenuOpen = $state(false);
 	let isTocOpen = $state(false);
@@ -95,9 +80,9 @@
 						<span class="inline-block">{config.title}</span>
 					</a>
 				</div>
-				{#if versions.length > 1 && active}
+				{#if docsPage.view.versionLinks.length > 1}
 					<div class="px-7 pb-3">
-						<VersionSwitcher {versions} {active} {content} {pathname} />
+						<VersionSwitcher links={docsPage.view.versionLinks} />
 					</div>
 				{/if}
 				<ScrollArea class="my-4 h-[calc(100vh-8rem)] pb-10 pl-2">

package/dist/components/layouts/docs-mobile-header.svelte.d.ts

@@ -1,4 +1,4 @@
-import type { DocsmithConfig, NavGroup, DocsContentItem, ResolvedVersion } from '../../core/index.js';
+import type { DocsmithConfig, NavGroup } from '../../core/index.js';
 import type { TocItem } from '../../toc/index.js';
 import type { Snippet } from 'svelte';
 type $$ComponentProps = {
@@ -13,14 +13,6 @@ type $$ComponentProps = {
     tocActiveId?: string | null;
     logo?: Snippet;
     actions?: Snippet;
-    /** Declared versions; renders the switcher in the drawer once there's more than one. */
-    versions?: ResolvedVersion[];
-    /** The active version, for the switcher's current selection. */
-    active?: ResolvedVersion;
-    /** Content index, so the switcher can map the current page across versions. */
-    content?: DocsContentItem[];
-    /** Current normalized pathname, for the switcher's page mapping. */
-    pathname?: string;
 };
 declare const DocsMobileHeader: import("svelte").Component<$$ComponentProps, {}, "">;
 type DocsMobileHeader = ReturnType<typeof DocsMobileHeader>;

package/dist/components/layouts/docs-shell.svelte

@@ -10,6 +10,7 @@
 	} from '../../core/index.js';
 	import { createToc } from '../../toc/index.js';
 	import { createSearchState } from '../../search/context.svelte.js';
+	import { setDocsPage } from '../docs-page-context.js';
 	import Search from '../chrome/search.svelte';
 	import BackgroundPattern from '../chrome/background-pattern.svelte';
 	import ThemeProvider from '../chrome/theme-provider.svelte';
@@ -107,7 +108,7 @@
 	// `search` loader is static for the shell's lifetime, so reading it once at
 	// init is intentional.
 	// svelte-ignore state_referenced_locally
-	const searchState = search ? createSearchState() : undefined;
+	if (search) createSearchState();
 
 	// Every rule about the page being read is resolved in one pure module
 	// (`core/docs-page.ts`): the active version and the content scoped to it, the
@@ -125,16 +126,23 @@
 		})
 	);
 
-	// Keep the search palette scoped to the version currently being read.
-	$effect(() => {
-		if (searchState) searchState.version = view.activeVersionId;
-	});
+	// One route to the chrome. The headers, the switcher and the search palette
+	// read what they need off this instead of taking it as props through two
+	// intermediate layers.
+	setDocsPage(() => view);
 
+	// `timeZone: 'UTC'` is not cosmetic. `lastUpdated` is a calendar day, which
+	// parses to UTC midnight, so formatting in the ambient zone shifts it a day
+	// west of UTC — and shifts it on the client but not on the server, so the
+	// rendered date changes under hydration.
 	const lastUpdatedLabel = $derived.by(() =>
 		view.lastUpdated
-			? new Intl.DateTimeFormat('en', { year: 'numeric', month: 'short', day: 'numeric' }).format(
-					view.lastUpdated
-				)
+			? new Intl.DateTimeFormat('en', {
+					year: 'numeric',
+					month: 'short',
+					day: 'numeric',
+					timeZone: 'UTC'
+				}).format(view.lastUpdated)
 			: undefined
 	);
 	const showFooterMeta = $derived(Boolean(view.editHref || lastUpdatedLabel));
@@ -145,6 +153,16 @@
 
 	const breadcrumbs = $derived(view.breadcrumbs.map((title) => ({ title })));
 
+	// The archived-version banner, or nothing. Its "view this page in <current>"
+	// link is the current version's entry in the same list the switcher renders,
+	// so the two can't disagree about where the reader lands.
+	const archivedBanner = $derived.by(() => {
+		const { isArchived, activeVersion, currentVersion, versionLinks } = view;
+		if (!isArchived || !activeVersion || !currentVersion) return undefined;
+		const href = versionLinks.find((link) => link.id === currentVersion.id)?.href;
+		return href ? { active: activeVersion, current: currentVersion, href } : undefined;
+	});
+
 	// In-page TOC, scanned from the rendered content and re-scanned after every
 	// navigation (client-side included) so it never goes stale.
 	let contentEl = $state<HTMLElement | null>(null);
@@ -194,15 +212,7 @@
 
 	<!-- One header system everywhere: DocsHeader on desktop, DocsMobileHeader
 	     below lg. The `page` layout just omits the sidebar nav and in-page TOC. -->
-	<DocsHeader
-		{config}
-		{logo}
-		{actions}
-		{versions}
-		active={view.activeVersion}
-		{content}
-		pathname={view.pathname}
-	/>
+	<DocsHeader {config} {logo} {actions} />
 
 	{#if layout === 'page'}
 		<DocsMobileHeader {config} {logo} {actions} />
@@ -219,10 +229,6 @@
 			tocActiveId={toc.activeId}
 			{logo}
 			{actions}
-			{versions}
-			active={view.activeVersion}
-			{content}
-			pathname={view.pathname}
 		/>
 
 		<div class="mx-auto flex w-full max-w-7xl flex-1 gap-12 px-4 md:px-6 lg:px-8 lg:pt-10">
@@ -234,13 +240,8 @@
 				tabindex="-1"
 				class="min-w-0 flex-1 py-6 lg:py-0"
 			>
-				{#if view.isArchived && view.activeVersion && view.currentVersion}
-					<VersionBanner
-						active={view.activeVersion}
-						current={view.currentVersion}
-						pathname={view.pathname}
-						{content}
-					/>
+				{#if archivedBanner}
+					<VersionBanner {...archivedBanner} />
 				{/if}
 
 				<div class="flex items-start justify-between gap-4">

package/dist/core/changelog.d.ts

@@ -19,7 +19,10 @@ export type ChangelogGroup = {
 export type ChangelogRelease = {
     /** Version string as it appears in the changelog, e.g. `0.8.0`. */
     version: string;
-    /** Release date (ISO) from the git history, when it can be determined. */
+    /**
+     * Release day (`YYYY-MM-DD`) from the git history, when it can be determined.
+     * Rendered as a UTC calendar day, so it reads the same for every reader.
+     */
     date?: string;
     groups: ChangelogGroup[];
     /**

package/dist/core/content.d.ts

@@ -23,7 +23,12 @@ export type DocsContentItem = {
     description?: string;
     /** Source file path relative to the app cwd, for the "Edit this page" link. */
     sourcePath?: string;
-    /** Last git commit date (ISO) for the page's source file. */
+    /**
+     * The day (`YYYY-MM-DD`) the page's source file last changed, from git, or
+     * from the page's own `lastUpdated` frontmatter when it has one. A calendar
+     * day rather than a timestamp: it is rendered as a UTC day, so it reads the
+     * same for every reader and matches on the server and the client.
+     */
     lastUpdated?: string;
     /** Estimated reading time in whole minutes (at ~200 wpm), min 1. */
     readingTime?: number;

package/dist/core/docs-page.d.ts

@@ -13,6 +13,15 @@ import { type NavGroup, type NavItem } from './nav.js';
 import { type ResolvedVersion } from './version.js';
 /** The page's build-time headings, as extracted into the content index. */
 type PageToc = NonNullable<DocsContentItem['toc']>;
+/** One declared version, and where switching to it should take the reader. */
+export type VersionLink = {
+    id: string;
+    label: string;
+    /** This page under that version, or its landing when the page isn't there. */
+    href: string;
+    /** Whether this is the version being read. */
+    active: boolean;
+};
 /** Everything `DocsShell` renders about the current page. */
 export type DocsPageView = {
     /** The current path, trailing slash stripped. Match content against this. */
@@ -53,6 +62,12 @@ export type DocsPageView = {
     breadcrumbs: string[];
     /** The page's server-rendered TOC, from {@link entry}. */
     toc: PageToc;
+    /**
+     * Every declared version with the URL that keeps the reader on this page, in
+     * switcher order. Empty on an unversioned site, so the switcher and the
+     * archived-version banner both render off this one list.
+     */
+    versionLinks: VersionLink[];
 };
 /**
  * Resolve the page being read. `pathname` is taken raw (normalized here, so the

package/dist/core/docs-page.js

@@ -1,5 +1,5 @@
 import { navFromContent, flattenNav, navTrail } from './nav.js';
-import { activeVersion, currentVersion, scopeContent } from './version.js';
+import { activeVersion, currentVersion, mapPathToVersion, scopeContent } from './version.js';
 import { normalizePath } from '../utils/normalize-path.js';
 /**
  * Resolve the page being read. `pathname` is taken raw (normalized here, so the
@@ -43,10 +43,27 @@ export function resolveDocsPage(input) {
         next: pageIndex >= 0 && pageIndex < flatNav.length - 1 ? flatNav[pageIndex + 1] : undefined,
         title,
         breadcrumbs,
-        toc: entry?.toc ?? []
+        toc: entry?.toc ?? [],
+        versionLinks: active
+            ? versions.map((version) => ({
+                id: version.id,
+                label: version.label,
+                // Switching to the version already being read is a no-op, so its
+                // link is this page. Mapping it like the others would send a reader
+                // who is off the docs tree to the docs landing instead.
+                href: version.id === active.id
+                    ? pathname
+                    : mapPathToVersion(pathname, active, version, scopeContent(content, version.id).map((item) => item.path)),
+                active: version.id === active.id
+            }))
+            : []
     };
 }
-/** An ISO stamp as a Date, or `undefined` when absent or unparseable. */
+/**
+ * A `YYYY-MM-DD` day as a Date, or `undefined` when absent or unparseable. The
+ * result is UTC midnight, so it must be formatted in UTC to read back as the
+ * same day.
+ */
 function parseDate(iso) {
     if (!iso)
         return undefined;

package/dist/core/index.d.ts

@@ -2,4 +2,4 @@ export { defineConfig, type DocsmithConfig, type DocsmithLink, type DocsmithFoot
 export type { DocsContentItem, SearchDoc, LlmsDoc } from './content.js';
 export { resolveVersions, activeVersion, currentVersion, currentOnly, scopeContent, mapPathToVersion, type DocsVersion, type DocsVersions, type ResolvedVersion } from './version.js';
 export { navFromContent, flattenNav, navTrail, isNavGroup, type NavItem, type NavGroup, type NavNode } from './nav.js';
-export { resolveDocsPage, type DocsPageView } from './docs-page.js';
+export { resolveDocsPage, type DocsPageView, type VersionLink } from './docs-page.js';