svelte-docsmith 0.8.0 → 0.9.0

package/dist/components/landing/hero.svelte

@@ -0,0 +1,70 @@
+<script lang="ts">
+	import type { Snippet } from 'svelte';
+
+	const {
+		title,
+		description,
+		eyebrow,
+		actions,
+		media
+	}: {
+		/** The headline. Pass a snippet instead of a string to mark part of it up. */
+		title: string | Snippet;
+		/** Supporting paragraph below the headline. */
+		description?: string | Snippet;
+		/** A pill, badge, or announcement link sitting above the headline. */
+		eyebrow?: Snippet;
+		/** Call-to-action buttons. */
+		actions?: Snippet;
+		/**
+		 * The second column: a code sample, screenshot, or live demo. Without it the
+		 * hero collapses to a single centred column.
+		 */
+		media?: Snippet;
+	} = $props();
+</script>
+
+<!-- Renders either a plain string or a snippet, so simple pages stay simple. -->
+{#snippet content(value: string | Snippet)}
+	{#if typeof value === 'string'}{value}{:else}{@render value()}{/if}
+{/snippet}
+
+<section
+	class="mx-auto grid max-w-7xl items-center gap-12 px-4 pt-16 pb-20 md:px-6 lg:gap-10 lg:px-8 lg:pt-24 lg:pb-28 {media
+		? 'lg:grid-cols-[1.05fr_1fr]'
+		: 'max-w-3xl text-center'}"
+>
+	<div class="min-w-0">
+		{#if eyebrow}
+			{@render eyebrow()}
+		{/if}
+
+		<h1
+			class="text-5xl font-semibold tracking-[-0.03em] text-balance sm:text-6xl lg:text-[4.25rem] lg:leading-[1.02] {eyebrow
+				? 'mt-6'
+				: ''}"
+		>
+			{@render content(title)}
+		</h1>
+
+		{#if description}
+			<p
+				class="text-muted-foreground mt-6 max-w-xl text-lg leading-relaxed text-pretty {media
+					? ''
+					: 'mx-auto'}"
+			>
+				{@render content(description)}
+			</p>
+		{/if}
+
+		{#if actions}
+			<div class="mt-8 flex flex-wrap items-center gap-3 {media ? '' : 'justify-center'}">
+				{@render actions()}
+			</div>
+		{/if}
+	</div>
+
+	{#if media}
+		<div class="min-w-0">{@render media()}</div>
+	{/if}
+</section>

package/dist/components/landing/hero.svelte.d.ts

@@ -0,0 +1,19 @@
+import type { Snippet } from 'svelte';
+type $$ComponentProps = {
+    /** The headline. Pass a snippet instead of a string to mark part of it up. */
+    title: string | Snippet;
+    /** Supporting paragraph below the headline. */
+    description?: string | Snippet;
+    /** A pill, badge, or announcement link sitting above the headline. */
+    eyebrow?: Snippet;
+    /** Call-to-action buttons. */
+    actions?: Snippet;
+    /**
+     * The second column: a code sample, screenshot, or live demo. Without it the
+     * hero collapses to a single centred column.
+     */
+    media?: Snippet;
+};
+declare const Hero: import("svelte").Component<$$ComponentProps, {}, "">;
+type Hero = ReturnType<typeof Hero>;
+export default Hero;

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

@@ -4,10 +4,14 @@
 	import { Separator } from '../shadcn/separator/index.js';
 	import GithubIcon from '../icons/github.svelte';
 	import SearchTrigger from '../chrome/search-trigger.svelte';
+	import { useSearch } from '../../search/context.svelte.js';
 	import ThemeToggle from '../chrome/theme-toggle.svelte';
-	import type { DocsmithConfig } 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';
 
 	const {
 		config,
@@ -21,6 +25,26 @@
 		actions?: Snippet;
 	} = $props();
 
+	// Present only when the consumer passed a `search` loader to DocsShell.
+	const search = useSearch();
+
+	const current = $derived(normalizePath(page.url.pathname));
+
+	/**
+	 * A header link is usually the entry point to a whole section rather than a
+	 * page you sit on: "Docs" points at `/docs/introduction`, and should stay lit
+	 * while the reader moves through `/docs/*`. So match the link's first segment,
+	 * not the exact path. The root is exempt, since every path starts with `/`.
+	 */
+	function isActive(link: DocsmithLink): boolean {
+		if (link.external) return false;
+		const href = normalizePath(link.href);
+		if (href === current) return true;
+		if (href === '/') return false;
+		const section = '/' + href.split('/').filter(Boolean)[0];
+		return current === section || current.startsWith(section + '/');
+	}
+
 	let isScrolled = $state(false);
 </script>
 
@@ -55,7 +79,11 @@
 							href={link.href}
 							target={link.external ? '_blank' : undefined}
 							rel={link.external ? 'noopener noreferrer' : undefined}
-							class="text-muted-foreground hover:text-foreground rounded-md px-3 py-1.5 text-sm font-medium transition-colors"
+							aria-current={isActive(link) ? 'page' : undefined}
+							class={cn(
+								'hover:text-foreground rounded-md px-3 py-1.5 text-sm font-medium transition-colors',
+								isActive(link) ? 'text-foreground bg-muted/60' : 'text-muted-foreground'
+							)}
 						>
 							{link.label}
 						</a>
@@ -76,7 +104,12 @@
 
 			<SearchTrigger />
 
-			<Separator orientation="vertical" class="bg-border/40 mx-1 min-h-0 h-6" />
+			<!-- The separator divides the search trigger from the action icons, so
+			     it only earns its place when there is a trigger to divide from.
+			     Without this a site that hasn't wired search shows a stray rule. -->
+			{#if search}
+				<Separator orientation="vertical" class="bg-border/40 mx-1 min-h-0 h-6" />
+			{/if}
 
 			<div class="flex items-center gap-0.5">
 				{#if actions}

package/dist/components/markdown/pre.svelte

@@ -6,18 +6,102 @@
 
 	const clipboard = useClipboard();
 
-	const { children }: { children: Snippet } = $props();
+	const {
+		title,
+		lineNumbers = false,
+		startLine = 1,
+		children
+	}: {
+		/** Filename or caption, from the fence's `title=` metadata. */
+		title?: string;
+		/** Number the lines, from `showLineNumbers`. */
+		lineNumbers?: boolean;
+		/** First line's number, from `startLine=`. */
+		startLine?: number;
+		children: Snippet;
+	} = $props();
+
+	/**
+	 * Twoslash popups are absolutely positioned inside the code block, which is a
+	 * scroll container, so anything reaching past its edges is clipped: a hover
+	 * near the last line shows a sliver of the type and nothing else. CSS can't
+	 * fix this, because a horizontally scrolling element must also clip
+	 * vertically. So on hover the popup is promoted to fixed positioning, whose
+	 * containing block is the viewport rather than the scroller.
+	 *
+	 * Without JavaScript the popup still opens on hover, clipped as before, so
+	 * this only ever improves on the CSS-only behaviour.
+	 */
+	function unclipPopups(node: HTMLElement) {
+		const GAP = 6;
+
+		const place = (event: Event) => {
+			const target = event.target as HTMLElement | null;
+			const trigger = target?.closest?.('.twoslash-hover') as HTMLElement | null;
+			if (!trigger) return;
+			const popup = trigger.querySelector('.twoslash-popup-container') as HTMLElement | null;
+			if (!popup) return;
+
+			// Measure while visible but before committing a position, so the popup's
+			// own width decides whether it flips to stay on screen.
+			popup.style.position = 'fixed';
+			popup.style.left = '0px';
+			popup.style.top = '0px';
+			const rect = trigger.getBoundingClientRect();
+			const { width, height } = popup.getBoundingClientRect();
+
+			const left = Math.max(8, Math.min(rect.left, window.innerWidth - width - 8));
+			// Below the token unless that would run off the bottom, then above it.
+			const below = rect.bottom + GAP;
+			const top = below + height > window.innerHeight - 8 ? rect.top - height - GAP : below;
+
+			popup.style.left = `${left}px`;
+			popup.style.top = `${Math.max(8, top)}px`;
+		};
+
+		const reset = (event: Event) => {
+			const trigger = (event.target as HTMLElement | null)?.closest?.(
+				'.twoslash-hover'
+			) as HTMLElement | null;
+			const popup = trigger?.querySelector('.twoslash-popup-container') as HTMLElement | null;
+			if (popup) popup.removeAttribute('style');
+		};
+
+		node.addEventListener('mouseover', place);
+		node.addEventListener('mouseout', reset);
+		return {
+			destroy() {
+				node.removeEventListener('mouseover', place);
+				node.removeEventListener('mouseout', reset);
+			}
+		};
+	}
 </script>
 
-<div class="rounded-md overflow-hidden bg-muted mt-2 shadow-md text-sm relative">
+<div class="rounded-md overflow-hidden bg-muted mt-2 shadow-md text-sm relative" use:unclipPopups>
+	{#if title}
+		<!-- The filename bar doubles as the copy button's row, so the button stops
+		     floating over the first line of code when a title is present. -->
+		<div class="docsmith-code-title">
+			<span class="docsmith-code-title-text">{title}</span>
+			<CopyButton copied={clipboard.copied} onclick={() => clipboard.copy()} class="bg-muted" />
+		</div>
+	{/if}
+
 	<ScrollArea orientation="both" class="relative">
-		<CopyButton
-			copied={clipboard.copied}
-			onclick={() => clipboard.copy()}
-			class="bg-muted absolute top-2 right-2 z-10"
-		/>
+		{#if !title}
+			<CopyButton
+				copied={clipboard.copied}
+				onclick={() => clipboard.copy()}
+				class="bg-muted absolute top-2 right-2 z-10"
+			/>
+		{/if}
 
-		<pre class="not-prose shiki max-h-[32rem] flex shrink" use:clipboard.readText>
+		<pre
+			class="not-prose shiki max-h-[32rem] flex shrink"
+			class:docsmith-line-numbers={lineNumbers}
+			style={lineNumbers && startLine !== 1 ? `--docsmith-line-start: ${startLine - 1}` : undefined}
+			use:clipboard.readText>
 			{@render children()}
 		</pre>
 	</ScrollArea>
@@ -44,6 +128,64 @@
 		padding-inline: 1rem;
 	}
 
+	/* --- Filename bar --- */
+	.docsmith-code-title {
+		display: flex;
+		align-items: center;
+		justify-content: space-between;
+		gap: 0.75rem;
+		padding: 0.4rem 0.5rem 0.4rem 1rem;
+		border-bottom: 1px solid var(--border);
+		background: color-mix(in oklch, var(--muted) 60%, var(--background));
+	}
+	.docsmith-code-title-text {
+		font-family: var(--font-mono, ui-monospace, monospace);
+		font-size: 0.78rem;
+		color: var(--muted-foreground);
+		overflow-wrap: anywhere;
+	}
+
+	/* --- Line numbers ---
+	   A CSS counter on Shiki's existing per-line spans, so numbering adds no DOM
+	   and stays out of the text the copy button reads. `--docsmith-line-start`
+	   offsets the counter for a snippet lifted out of a larger file. */
+	:global(pre.docsmith-line-numbers code) {
+		counter-reset: docsmith-line var(--docsmith-line-start, 0);
+	}
+	:global(pre.docsmith-line-numbers span.line) {
+		counter-increment: docsmith-line;
+		position: relative;
+		padding-inline-start: 3.2rem;
+	}
+	:global(pre.docsmith-line-numbers span.line::before) {
+		content: counter(docsmith-line);
+		position: absolute;
+		left: 0;
+		width: 2.4rem;
+		text-align: right;
+		color: color-mix(in oklch, var(--muted-foreground) 65%, transparent);
+		/* Numbers are decoration, not content: keep them out of selections and
+		   off the clipboard. */
+		user-select: none;
+	}
+	/* The diff gutter glyph would collide with the number, so shift it over. */
+	:global(pre.docsmith-line-numbers span.line.diff::before) {
+		content: counter(docsmith-line);
+	}
+	:global(pre.docsmith-line-numbers span.line.diff::after) {
+		position: absolute;
+		left: 2.7rem;
+		font-weight: 600;
+	}
+	:global(pre.docsmith-line-numbers span.line.diff.add::after) {
+		content: '+';
+		color: oklch(0.6 0.15 150);
+	}
+	:global(pre.docsmith-line-numbers span.line.diff.remove::after) {
+		content: '−';
+		color: oklch(0.58 0.19 25);
+	}
+
 	/* Two tiers of annotation. EMPHASIS (highlight, word) tints with the theme's
 	   --primary, so it reads as the brand pointing at a line and recolors with
 	   the active theme. SEMANTIC (diff, error, warning) uses fixed OKLCH hues so
@@ -125,6 +267,94 @@
 		}
 	}
 
+	/* --- Twoslash hovers ---
+	   Restyled from @shikijs/twoslash's rich theme onto our tokens so the popup
+	   belongs to the site in both colour schemes. Underline marks a token as
+	   inspectable; the popup is a hidden sibling revealed on hover. `unclipPopups`
+	   then promotes it to fixed positioning so the code block's scrolling does not
+	   clip it — see the comment there. */
+	:global(pre .twoslash-hover) {
+		position: relative;
+		border-bottom: 1px dotted color-mix(in oklch, var(--muted-foreground) 55%, transparent);
+	}
+	:global(pre .twoslash-popup-container) {
+		position: absolute;
+		z-index: 40;
+		display: none;
+		left: 0;
+		top: 1.6em;
+		/* Shrink to the type's own width so a short signature isn't a wide slab;
+		   the script measures this before choosing a position. */
+		width: max-content;
+		max-width: min(32rem, 78vw);
+		padding: 0.5rem 0.7rem;
+		border: 1px solid var(--border);
+		border-radius: var(--radius, 0.5rem);
+		background: var(--popover, var(--card));
+		color: var(--popover-foreground, var(--foreground));
+		box-shadow: 0 8px 24px rgb(0 0 0 / 0.18);
+		white-space: pre-wrap;
+		text-align: left;
+		font-size: 0.85em;
+		line-height: 1.5;
+	}
+	:global(pre .twoslash-hover:hover .twoslash-popup-container) {
+		display: block;
+	}
+	/* The signature keeps Shiki's own colours and monospace. */
+	:global(pre .twoslash-popup-code) {
+		display: block;
+		font-family: var(--font-mono, ui-monospace, monospace);
+		white-space: pre-wrap;
+	}
+
+	/* Prose, by contrast, is prose. Inside a <pre> it would otherwise inherit
+	   monospace and whatever token colour the hovered span happened to carry,
+	   which reads as more code rather than an explanation of it. */
+	:global(pre .twoslash-popup-docs) {
+		/* The dark-theme swap repaints every span inside `.shiki` with
+		   `--shiki-dark`, which these spans inherit from whichever token was
+		   hovered — so docs took on the colour of the word above them. Redefining
+		   the variable here resolves it to prose colours instead of fighting an
+		   `!important` rule. */
+		--shiki-dark: var(--muted-foreground);
+		margin-top: 0.5rem;
+		padding-top: 0.5rem;
+		border-top: 1px solid var(--border);
+		font-family: var(--font-sans, ui-sans-serif, system-ui, sans-serif);
+		font-size: 0.92em;
+		line-height: 1.55;
+		color: var(--muted-foreground);
+		white-space: normal;
+	}
+
+	/* Each @param is its own line: the tags are inline spans, so without this
+	   they run together into one paragraph. */
+	:global(pre .twoslash-popup-docs-tags) {
+		display: flex;
+		flex-direction: column;
+		gap: 0.35rem;
+	}
+	:global(pre .twoslash-popup-docs-tag) {
+		display: block;
+	}
+	:global(pre .twoslash-popup-docs-tag-value) {
+		--shiki-dark: var(--muted-foreground);
+		color: var(--muted-foreground);
+	}
+	/* And the tag name needs a gap, or it reads as "@paramcallbackfn". */
+	:global(pre .twoslash-popup-docs-tag-name) {
+		--shiki-dark: var(--primary);
+		margin-right: 0.4em;
+		font-family: var(--font-mono, ui-monospace, monospace);
+		font-size: 0.92em;
+		color: var(--primary);
+	}
+	/* A snippet that deliberately shows an error (// @errors:) marks the line. */
+	:global(pre .twoslash-error) {
+		background: color-mix(in oklch, oklch(0.62 0.2 25) 14%, transparent);
+	}
+
 	/* --- Word highlight (// [!code word:name]): a primary-tinted inline pill --- */
 	:global(pre .highlighted-word) {
 		border-radius: 0.3rem;

package/dist/components/markdown/pre.svelte.d.ts

@@ -1,5 +1,11 @@
 import type { Snippet } from 'svelte';
 type $$ComponentProps = {
+    /** Filename or caption, from the fence's `title=` metadata. */
+    title?: string;
+    /** Number the lines, from `showLineNumbers`. */
+    lineNumbers?: boolean;
+    /** First line's number, from `startLine=`. */
+    startLine?: number;
     children: Snippet;
 };
 declare const Pre: import("svelte").Component<$$ComponentProps, {}, "">;

package/dist/core/changelog.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The record types for the generated changelog index. The `docsmith()` Vite
+ * plugin parses your package's `CHANGELOG.md` at build time and emits these as
+ * the `svelte-docsmith/changelog` virtual module, so every release becomes a
+ * page and a feed entry without being written twice.
+ */
+/** One group of changes within a release, e.g. "Minor Changes". */
+export type ChangelogGroup = {
+    /** The group heading as written, e.g. `Minor Changes` or `Patch Changes`. */
+    kind: string;
+    /**
+     * Each entry's body as HTML, rendered from markdown at build time with the
+     * changeset's commit hash removed. HTML rather than markdown so a consuming
+     * site needs no runtime renderer.
+     */
+    items: string[];
+};
+/** One released version. */
+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. */
+    date?: string;
+    groups: ChangelogGroup[];
+    /**
+     * A hand-written page for this release, when `src/routes/changelog/<version>/`
+     * exists. The generated entry is the fallback, so a release that deserves a
+     * proper write-up can have one without the rest going undocumented.
+     */
+    path?: string;
+};

package/dist/core/changelog.js

@@ -0,0 +1,7 @@
+/**
+ * The record types for the generated changelog index. The `docsmith()` Vite
+ * plugin parses your package's `CHANGELOG.md` at build time and emits these as
+ * the `svelte-docsmith/changelog` virtual module, so every release becomes a
+ * page and a feed entry without being written twice.
+ */
+export {};

package/dist/fallbacks/changelog.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `svelte-docsmith/changelog` — the generated release index.
+ *
+ * At build time the `docsmith()` Vite plugin (in `vite.config.ts`) intercepts
+ * this import and replaces it with your package's `CHANGELOG.md`, parsed into
+ * releases and dated from git. This file is only the fallback that runs when
+ * the plugin is missing — see {@link missingPluginError}.
+ */
+import type { ChangelogRelease } from '../core/changelog.js';
+export declare const releases: ChangelogRelease[];

package/dist/fallbacks/changelog.js

@@ -0,0 +1,3 @@
+import { missingPluginError } from './missing-plugin.js';
+export const releases = [];
+throw missingPluginError('changelog');

package/dist/generate/feed.d.ts

@@ -0,0 +1,35 @@
+import type { ChangelogRelease } from '../core/changelog.js';
+/** Site details the feed needs beyond the releases themselves. */
+export type FeedSite = {
+    /** Canonical origin, e.g. `https://docs.example.com`. */
+    url: string;
+    /** Feed title, usually the site title. */
+    title: string;
+    /** One-line feed description. */
+    description?: string;
+    /** Path the changelog lives at. Default: `/changelog`. */
+    path?: string;
+};
+/**
+ * Build an Atom feed body from parsed changelog releases. Framework-agnostic:
+ * wire it into a SvelteKit `src/routes/changelog.xml/+server.ts` over the
+ * generated `svelte-docsmith/changelog` index.
+ *
+ * ```ts
+ * import { releases } from 'svelte-docsmith/changelog';
+ * import { generateFeed } from 'svelte-docsmith';
+ *
+ * export const prerender = true;
+ * export function GET() {
+ *   const body = generateFeed(releases, {
+ *     url: 'https://my-docs.dev',
+ *     title: 'My Library'
+ *   });
+ *   return new Response(body, { headers: { 'content-type': 'application/atom+xml' } });
+ * }
+ * ```
+ *
+ * Atom rather than RSS because it requires an unambiguous per-entry id and
+ * update timestamp, which is exactly what a version and its release date give.
+ */
+export declare function generateFeed(releases: ChangelogRelease[], site: FeedSite): string;

package/dist/generate/feed.js

@@ -0,0 +1,80 @@
+const escapeXml = (s) => s.replace(/[&<>'"]/g, (c) => {
+    switch (c) {
+        case '&':
+            return '&amp;';
+        case '<':
+            return '&lt;';
+        case '>':
+            return '&gt;';
+        case "'":
+            return '&apos;';
+        default:
+            return '&quot;';
+    }
+});
+/** A release's entries flattened to plain text, grouped by kind. */
+function summarise(release) {
+    return release.groups
+        .map((group) => `${group.kind}\n\n${group.items.map((item) => `- ${item}`).join('\n\n')}`)
+        .join('\n\n');
+}
+/**
+ * Build an Atom feed body from parsed changelog releases. Framework-agnostic:
+ * wire it into a SvelteKit `src/routes/changelog.xml/+server.ts` over the
+ * generated `svelte-docsmith/changelog` index.
+ *
+ * ```ts
+ * import { releases } from 'svelte-docsmith/changelog';
+ * import { generateFeed } from 'svelte-docsmith';
+ *
+ * export const prerender = true;
+ * export function GET() {
+ *   const body = generateFeed(releases, {
+ *     url: 'https://my-docs.dev',
+ *     title: 'My Library'
+ *   });
+ *   return new Response(body, { headers: { 'content-type': 'application/atom+xml' } });
+ * }
+ * ```
+ *
+ * Atom rather than RSS because it requires an unambiguous per-entry id and
+ * update timestamp, which is exactly what a version and its release date give.
+ */
+export function generateFeed(releases, site) {
+    const origin = site.url.replace(/\/$/, '');
+    const path = site.path ?? '/changelog';
+    const feedUrl = `${origin}${path}.xml`;
+    // A feed needs an updated timestamp; fall back to now when no release
+    // carries a date, so the document stays valid.
+    const updated = releases.find((r) => r.date)?.date ?? new Date().toISOString();
+    const entries = releases
+        .map((release) => {
+        const link = release.path
+            ? `${origin}${release.path}`
+            : `${origin}${path}#${release.version}`;
+        return [
+            '\t<entry>',
+            `\t\t<title>${escapeXml(release.version)}</title>`,
+            `\t\t<id>${escapeXml(link)}</id>`,
+            `\t\t<link href="${escapeXml(link)}" />`,
+            `\t\t<updated>${escapeXml(release.date ?? updated)}</updated>`,
+            `\t\t<content type="text">${escapeXml(summarise(release))}</content>`,
+            '\t</entry>'
+        ].join('\n');
+    })
+        .join('\n');
+    return [
+        '<?xml version="1.0" encoding="utf-8"?>',
+        '<feed xmlns="http://www.w3.org/2005/Atom">',
+        `\t<title>${escapeXml(site.title)}</title>`,
+        site.description ? `\t<subtitle>${escapeXml(site.description)}</subtitle>` : '',
+        `\t<id>${escapeXml(feedUrl)}</id>`,
+        `\t<link href="${escapeXml(origin + path)}" />`,
+        `\t<link rel="self" href="${escapeXml(feedUrl)}" />`,
+        `\t<updated>${escapeXml(updated)}</updated>`,
+        entries,
+        '</feed>'
+    ]
+        .filter(Boolean)
+        .join('\n');
+}

package/dist/index.d.ts

@@ -18,7 +18,15 @@ export { default as FileTree } from './components/docs/file-tree.svelte';
 export { default as FileTreeItem } from './components/docs/file-tree-item.svelte';
 export { default as PropsTable } from './components/docs/props-table.svelte';
 export { default as Prop } from './components/docs/prop.svelte';
+export { default as Hero } from './components/landing/hero.svelte';
+export { default as FeatureGrid } from './components/landing/feature-grid.svelte';
+export { default as Feature } from './components/landing/feature.svelte';
+export { default as CTA } from './components/landing/cta.svelte';
+export { default as Action } from './components/landing/action.svelte';
 export { defineConfig, type DocsmithConfig, type DocsContentItem, type SearchDoc, type LlmsDoc } from './core/index.js';
 export { createSearchEngine, type SearchEngine, type SearchResult } from './search/create-search.js';
 export { generateSitemap, type SitemapEntry } from './generate/sitemap.js';
 export { generateLlmsTxt, generateLlmsFullTxt, type LlmsSite } from './generate/llms.js';
+export { default as Changelog } from './components/changelog/changelog.svelte';
+export type { ChangelogRelease, ChangelogGroup } from './core/changelog.js';
+export { generateFeed, type FeedSite } from './generate/feed.js';

package/dist/index.js

@@ -23,6 +23,12 @@ export { default as FileTree } from './components/docs/file-tree.svelte';
 export { default as FileTreeItem } from './components/docs/file-tree-item.svelte';
 export { default as PropsTable } from './components/docs/props-table.svelte';
 export { default as Prop } from './components/docs/prop.svelte';
+// Landing page sections (for the marketing page in front of your docs)
+export { default as Hero } from './components/landing/hero.svelte';
+export { default as FeatureGrid } from './components/landing/feature-grid.svelte';
+export { default as Feature } from './components/landing/feature.svelte';
+export { default as CTA } from './components/landing/cta.svelte';
+export { default as Action } from './components/landing/action.svelte';
 // Config
 export { defineConfig } from './core/index.js';
 // Search engine (framework-agnostic; for building a custom search UI over the
@@ -33,3 +39,6 @@ export { generateSitemap } from './generate/sitemap.js';
 // llms.txt (framework-agnostic; wire into `llms.txt/+server.ts` and
 // `llms-full.txt/+server.ts` over the generated `svelte-docsmith/llms` index)
 export { generateLlmsTxt, generateLlmsFullTxt } from './generate/llms.js';
+// Changelog (the generated `svelte-docsmith/changelog` index, plus its feed)
+export { default as Changelog } from './components/changelog/changelog.svelte';
+export { generateFeed } from './generate/feed.js';