sourcey 3.3.5 → 3.3.7

package/README.md

@@ -5,7 +5,7 @@
 Sourcey is an open source documentation platform. Point it at an OpenAPI spec, add markdown guides, get a complete docs site. Static HTML you own; no dashboard, no monthly bill, no API calls to render your own documentation. Deploy anywhere.
 
 [![npm](https://img.shields.io/npm/v/sourcey)](https://www.npmjs.com/package/sourcey)
-[![build](https://img.shields.io/github/actions/workflow/status/sourcey/sourcey/ci.yml?branch=master)](https://github.com/sourcey/sourcey/actions)
+[![build](https://img.shields.io/github/actions/workflow/status/nilstate/sourcey/ci.yml?branch=master)](https://github.com/nilstate/sourcey/actions)
 [![node](https://img.shields.io/node/v/sourcey)](https://nodejs.org)
 
 ```bash
@@ -14,7 +14,7 @@ npx sourcey init
 
 ![Sourcey](assets/screenshot.jpg)
 
-**[Live demo](https://cheesestore.github.io/)** · [Documentation](https://sourcey.com/docs) · [GitHub](https://github.com/sourcey/sourcey)
+**[Live demo](https://cheesestore.github.io/)** · [Documentation](https://sourcey.com/docs) · [GitHub](https://github.com/nilstate/sourcey)
 
 ## Features
 
@@ -159,7 +159,7 @@ sourcey validate api.yaml         Validate a spec file
 ## Development
 
 ```bash
-git clone https://github.com/sourcey/sourcey.git
+git clone https://github.com/nilstate/sourcey.git
 cd sourcey && npm install
 npm run build && npm test
 

package/dist/cli.js

@@ -162,4 +162,3 @@ const main = defineCommand({
     },
 });
 runMain(main);
-//# sourceMappingURL=cli.js.map

package/dist/client/index.js

@@ -5,4 +5,3 @@ import "./scroll-tracker.js";
 import "./tabs.js";
 import "./theme-toggle.js";
 import "./search.js";
-//# sourceMappingURL=index.js.map

package/dist/components/App.js

@@ -10,4 +10,3 @@ export function App({ spec, options, navigation, currentPage, site }) {
     const content = options.embeddable ? (_jsx(Page, {})) : (_jsxs("html", { lang: "en", children: [_jsx(Head, {}), _jsxs("body", { id: "sourcey", children: [_jsx(Page, {}), _jsx("script", { src: `${options.assetBase}sourcey.js`, defer: true })] })] }));
     return (_jsx(SiteContext.Provider, { value: site, children: _jsx(SpecContext.Provider, { value: spec, children: _jsx(OptionsContext.Provider, { value: options, children: _jsx(NavigationContext.Provider, { value: navigation, children: _jsx(PageContext.Provider, { value: currentPage, children: content }) }) }) }) }));
 }
-//# sourceMappingURL=App.js.map

package/dist/components/layout/Head.js

@@ -53,4 +53,3 @@ export function Head() {
   `;
     return (_jsxs("head", { children: [_jsx("meta", { charset: "utf-8" }), _jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }), _jsx("title", { children: pageTitle }), _jsx("meta", { name: "description", content: pageDescription }), _jsx("meta", { name: "sourcey-search", content: `${options.assetBase}search-index.json` }), _jsx("style", { dangerouslySetInnerHTML: { __html: themeCSS } }), _jsx("style", { dangerouslySetInnerHTML: { __html: langIconCSS() } }), site.customCSS && _jsx("style", { dangerouslySetInnerHTML: { __html: site.customCSS } }), _jsx("script", { dangerouslySetInnerHTML: { __html: `(function(){var t=localStorage.getItem('sourcey-theme');if(t==='dark')document.documentElement.classList.add('dark')})()` } }), googleFontsUrl && (_jsxs(_Fragment, { children: [_jsx("link", { rel: "preconnect", href: "https://fonts.googleapis.com" }), _jsx("link", { rel: "preconnect", href: "https://fonts.gstatic.com", crossOrigin: "anonymous" }), _jsx("link", { rel: "stylesheet", href: googleFontsUrl })] })), _jsx("link", { rel: "stylesheet", href: `${options.assetBase}sourcey.css` }), site.favicon && _jsx("link", { rel: "icon", href: site.favicon })] }));
 }
-//# sourceMappingURL=Head.js.map

package/dist/components/layout/Header.js

@@ -46,4 +46,3 @@ export function Header() {
                                         : "text-[rgb(var(--color-gray-600))] dark:text-[rgb(var(--color-gray-400))] hover:text-[rgb(var(--color-gray-800))] dark:hover:text-[rgb(var(--color-gray-300))]"}`, children: [tab.label, isActive ? (_jsx("div", { class: "absolute bottom-0 h-[1.5px] w-full left-0 bg-[rgb(var(--color-primary))] dark:bg-[rgb(var(--color-primary-light))]" })) : (_jsx("div", { class: "absolute bottom-0 h-[1.5px] w-full left-0 group-hover:bg-[rgb(var(--color-gray-200))] dark:group-hover:bg-[rgb(var(--color-gray-700))]" }))] }, tab.slug));
                             }) }) }))] })] }));
 }
-//# sourceMappingURL=Header.js.map

package/dist/components/layout/Page.js

@@ -90,4 +90,3 @@ export function Page() {
             : DefaultLayout;
     return (_jsxs("div", { id: "page", class: "relative antialiased text-[rgb(var(--color-gray-500))] dark:text-[rgb(var(--color-gray-400))]", children: [_jsx(Header, {}), _jsx("span", { class: "fixed inset-0 bg-[rgb(var(--color-background-light))] dark:bg-[rgb(var(--color-background-dark))] -z-10 pointer-events-none" }), _jsx(Layout, {}), _jsx("div", { id: "search-dialog", role: "dialog", "aria-label": "Search", children: _jsxs("div", { class: "search-dialog-inner", children: [_jsxs("div", { class: "search-input-row", children: [_jsx("svg", { xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 20 20", fill: "currentColor", class: "search-input-icon", children: _jsx("path", { "fill-rule": "evenodd", d: "M9 3.5a5.5 5.5 0 1 0 0 11 5.5 5.5 0 0 0 0-11ZM2 9a7 7 0 1 1 12.452 4.391l3.328 3.329a.75.75 0 1 1-1.06 1.06l-3.329-3.328A7 7 0 0 1 2 9Z", "clip-rule": "evenodd" }) }), _jsx("input", { id: "search-input", type: "text", placeholder: "Search docs...", autocomplete: "off", spellcheck: false })] }), _jsx("div", { id: "search-results" }), _jsxs("div", { class: "search-footer", children: [_jsxs("span", { class: "search-footer-hint", children: [_jsx("kbd", { children: "\u2191\u2193" }), " navigate"] }), _jsxs("span", { class: "search-footer-hint", children: [_jsx("kbd", { children: "\u21B5" }), " select"] }), _jsxs("span", { class: "search-footer-hint", children: [_jsx("kbd", { children: "esc" }), " close"] })] })] }) })] }));
 }
-//# sourceMappingURL=Page.js.map

package/dist/components/layout/Sidebar.js

@@ -54,4 +54,3 @@ export function Sidebar() {
                                     return (_jsx("li", { children: _jsxs("a", { href: link.href, target: "_blank", rel: "noopener noreferrer", class: "flex items-center gap-2.5 text-[rgb(var(--color-gray-600))] hover:text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-400))] dark:hover:text-[rgb(var(--color-gray-200))]", children: [link.type !== "link" && _jsx(SocialIcon, { type: link.type }), _jsx("span", { children: label })] }) }, link.href));
                                 }), primaryAction && (_jsx("li", { children: _jsxs("a", { href: primaryAction.href, target: "_blank", class: "group relative flex items-center justify-center px-4 py-2 text-sm font-medium", children: [_jsx("span", { class: "absolute inset-0 bg-[rgb(var(--color-primary-dark))] rounded-lg group-hover:opacity-90" }), _jsx("span", { class: "z-10 text-white", children: primaryAction.label })] }) }))] }) }))] })] }));
 }
-//# sourceMappingURL=Sidebar.js.map

package/dist/components/layout/TableOfContents.js

@@ -23,4 +23,3 @@ export function TableOfContents({ headings }) {
         return null;
     return (_jsx("aside", { id: "toc", class: "hidden xl:flex self-start sticky xl:flex-col max-w-[28rem] z-[21]", style: "height: calc(100vh - var(--header-height) - 2.5rem); top: calc(var(--header-height) + 2.5rem)", children: _jsx("div", { class: "z-10 hidden xl:flex box-border max-h-full pl-10 w-[19rem]", children: _jsxs("div", { class: "text-[rgb(var(--color-gray-600))] text-sm leading-6 w-[16.5rem] overflow-y-auto space-y-2 pb-4 -mt-10 pt-10", children: [_jsx("h5", { class: "font-semibold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: "On this page" }), _jsx("nav", { children: _jsx(TocList, { headings: headings }) })] }) }) }));
 }
-//# sourceMappingURL=TableOfContents.js.map

package/dist/components/openapi/CodeSamples.js

@@ -17,4 +17,3 @@ export function CodeSamplesExamples({ operation, serverUrl, codeSampleLangs }) {
                 return (_jsx("div", { class: `code-lang-panel${i === 0 ? " active" : ""}`, "data-lang-panel": String(i), children: _jsx("div", { class: "relative w-full px-4 py-3.5 text-sm leading-6 bg-[rgb(var(--color-code-block-light))] dark:bg-[rgb(var(--color-code-block-dark))] overflow-x-auto", style: "font-variant-ligatures: none", children: _jsx("div", { class: "font-mono whitespace-pre text-xs leading-[1.35rem] code-block", dangerouslySetInnerHTML: { __html: html } }) }) }, i));
             })] }));
 }
-//# sourceMappingURL=CodeSamples.js.map

package/dist/components/openapi/Definition.js

@@ -9,4 +9,3 @@ export function Definition({ name, schema }) {
     const id = `definition-${htmlId(name)}`;
     return (_jsxs("div", { id: id, class: "py-8 border-t border-[rgb(var(--color-gray-100))] dark:border-[rgb(var(--color-gray-800))]", "data-traverse-target": id, children: [_jsx("a", { id: `/definitions/${name}` }), _jsx("header", { class: "mb-4", children: _jsxs("div", { class: "flex items-baseline gap-2", children: [_jsx("h2", { class: "text-xl font-bold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: name }), _jsx("span", { class: "text-sm text-[rgb(var(--color-gray-500))] font-normal", children: schema.type ?? "object" })] }) }), _jsxs("div", { class: "flex flex-col xl:flex-row gap-8", children: [_jsx("div", { class: "flex-1 min-w-0", children: _jsx(SchemaView, { schema: schema }) }), _jsx("aside", { class: "hidden xl:block w-[28rem] shrink-0 sticky self-start", style: "top: calc(var(--header-height) + 2.5rem)", children: _jsx(ExampleView, { schema: schema, title: "Example" }) })] }), _jsx("div", { class: "xl:hidden mt-6", children: _jsx(ExampleView, { schema: schema, title: "Example" }) })] }));
 }
-//# sourceMappingURL=Definition.js.map

package/dist/components/openapi/EndpointBar.js

@@ -17,4 +17,3 @@ export function EndpointBar({ method, path, serverUrl }) {
     const segments = path.split("/").filter(Boolean);
     return (_jsxs("div", { class: "flex items-center gap-2 rounded-[var(--radius)] border border-[rgb(var(--color-gray-200)/0.7)] dark:border-[rgb(var(--color-border-dark-subtle)/0.1)] px-3 py-2.5 mb-6 overflow-hidden", children: [_jsx("div", { class: `rounded-lg font-bold px-1.5 py-0.5 text-sm leading-5 shrink-0 ${colorClass}`, children: method.toUpperCase() }), _jsxs("div", { class: "flex items-center overflow-x-auto flex-1 no-scrollbar gap-0.5 font-mono", children: [_jsx("span", { class: "text-sm text-[rgb(var(--color-gray-500))] dark:text-[rgb(var(--color-gray-500))] shrink-0", children: serverUrl }), segments.map((seg, i) => (_jsxs("span", { class: "flex items-center shrink-0", children: [_jsx("span", { class: "text-sm text-[rgb(var(--color-gray-400))]", children: "/" }), _jsx("span", { class: "text-sm font-medium text-[rgb(var(--color-gray-800))] dark:text-[rgb(var(--color-gray-50))]", children: seg })] }, i)))] })] }));
 }
-//# sourceMappingURL=EndpointBar.js.map

package/dist/components/openapi/Introduction.js

@@ -11,4 +11,3 @@ export function Introduction() {
     const { info, servers } = spec;
     return (_jsxs("div", { id: "introduction", "data-traverse-target": "introduction", class: "mb-8", children: [info.description && (_jsx(Markdown, { content: info.description, class: "max-w-none" })), info.termsOfService && (_jsx("p", { class: "mt-4 text-sm text-[rgb(var(--color-gray-500))]", children: _jsx("a", { href: info.termsOfService, class: "text-[rgb(var(--color-primary))] dark:text-[rgb(var(--color-primary-light))]", children: "Terms of Service" }) })), info.contact?.email && (_jsxs("p", { class: "mt-2 text-sm text-[rgb(var(--color-gray-500))]", children: ["Contact: ", _jsx("a", { href: `mailto:${info.contact.email}`, class: "text-[rgb(var(--color-primary))] dark:text-[rgb(var(--color-primary-light))]", children: info.contact.email })] })), servers.length > 0 && (_jsxs("div", { class: "mt-6 rounded-[var(--radius)] border border-[rgb(var(--color-gray-200)/0.7)] dark:border-[rgb(var(--color-border-dark-subtle)/0.1)] overflow-x-auto", children: [_jsxs("div", { class: "px-4 py-2.5 text-xs font-semibold text-[rgb(var(--color-gray-600))] dark:text-[rgb(var(--color-gray-300))] border-b border-[rgb(var(--color-gray-200)/0.7)] dark:border-[rgb(var(--color-border-dark-subtle)/0.1)]", children: ["Base URL", servers.length > 1 ? "s" : ""] }), servers.map((s, i) => (_jsxs("div", { class: `flex items-baseline gap-3 px-4 py-2 ${i > 0 ? "border-t border-[rgb(var(--color-gray-100))] dark:border-[rgb(var(--color-gray-800))]" : ""}`, children: [_jsx("code", { class: "font-mono text-sm text-[rgb(var(--color-gray-800))] dark:text-[rgb(var(--color-gray-200))]", children: s.url }), s.description && (_jsx("span", { class: "text-xs text-[rgb(var(--color-gray-500))]", children: s.description }))] }, i)))] }))] }));
 }
-//# sourceMappingURL=Introduction.js.map

package/dist/components/openapi/Operation.js

@@ -28,4 +28,3 @@ function bodyMediaType(body) {
     const types = Object.keys(body.content);
     return types.length ? types[0] : undefined;
 }
-//# sourceMappingURL=Operation.js.map

package/dist/components/openapi/Parameters.js

@@ -7,4 +7,3 @@ export function Parameters({ parameters }) {
         return null;
     return (_jsx("div", { class: "params-list", children: parameters.map((param) => (_jsxs("div", { class: "param-item", children: [_jsxs("div", { class: "param-header", children: [_jsx("code", { class: "param-name", children: param.name }), param.schema && (_jsx("span", { class: "param-type", children: _jsx(SchemaDatatype, { schema: param.schema }) })), param.required && _jsx(RequiredBadge, {}), param.deprecated && _jsx(DeprecatedBadge, {}), _jsx("span", { class: "param-in", children: param.in })] }), param.description && (_jsx("div", { class: "param-description", children: _jsx(Markdown, { content: param.description }) }))] }, `${param.in}-${param.name}`))) }));
 }
-//# sourceMappingURL=Parameters.js.map

package/dist/components/openapi/RequestBody.js

@@ -23,4 +23,3 @@ export function RequestBodyExample({ body }) {
         return null;
     return _jsx(ExampleView, { schema: content.schema, title: "Request Body" });
 }
-//# sourceMappingURL=RequestBody.js.map

package/dist/components/openapi/Responses.js

@@ -68,4 +68,3 @@ function getResponseSchema(r) {
     const firstMedia = Object.values(r.content)[0];
     return firstMedia?.schema ?? null;
 }
-//# sourceMappingURL=Responses.js.map

package/dist/components/openapi/Security.js

@@ -30,4 +30,3 @@ export function SecurityDefinitions() {
                                                         .map(([s, desc]) => `${s} — ${desc}`)
                                                         .join(", ")] }))] }, flowType))) })), scheme.type === "openIdConnect" && scheme.openIdConnectUrl && (_jsxs("p", { class: "mt-1", children: ["OpenID Connect:", " ", _jsx("a", { href: scheme.openIdConnectUrl, class: "text-[rgb(var(--color-primary))] dark:text-[rgb(var(--color-primary-light))]", children: scheme.openIdConnectUrl })] }))] })] }, name))) })] }));
 }
-//# sourceMappingURL=Security.js.map

package/dist/components/openapi/Tags.js

@@ -7,4 +7,3 @@ export function Tags({ tags, serverUrl }) {
             .filter((t) => !t.hidden)
             .map((tag) => (_jsxs("div", { class: "mt-12", children: [_jsxs("div", { id: `tag-${htmlId(tag.name)}`, "data-traverse-target": `tag-${htmlId(tag.name)}`, class: "mb-6", children: [_jsx("h1", { class: "text-xl font-bold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))] mb-2", children: tag.name }), tag.description && (_jsx(Markdown, { content: tag.description, class: "text-sm max-w-none" }))] }), tag.operations.map((op) => (_jsx(Operation, { operation: op, serverUrl: serverUrl }, `${op.method}-${op.path}`)))] }, tag.name))) }));
 }
-//# sourceMappingURL=Tags.js.map

package/dist/components/schema/ExampleView.js

@@ -13,4 +13,3 @@ export function ExampleView({ schema, title }) {
     const html = highlightCode(json, "json");
     return (_jsxs("div", { class: "code-group not-prose", children: [title && (_jsxs("div", { class: "relative flex items-center justify-between gap-2 px-3", children: [_jsx("div", { class: "flex min-w-0 items-center gap-1.5 font-medium text-xs leading-6 my-1 mb-1.5", children: _jsx("span", { class: "truncate text-[rgb(var(--color-stone-950))] dark:text-[rgb(var(--color-stone-50))]", children: title }) }), _jsx("div", { class: "flex shrink-0 items-center justify-end gap-1.5", children: _jsx(CopyButton, {}) })] })), _jsxs("div", { class: "relative w-full px-4 py-3.5 text-sm leading-6 bg-[rgb(var(--color-code-block-light))] dark:bg-[rgb(var(--color-code-block-dark))] overflow-x-auto", style: "font-variant-ligatures: none", children: [!title && (_jsx("div", { class: "absolute top-3 right-4 z-10", children: _jsx(CopyButton, {}) })), _jsx("div", { class: "font-mono whitespace-pre text-xs leading-[1.35rem]", dangerouslySetInnerHTML: { __html: html } })] })] }));
 }
-//# sourceMappingURL=ExampleView.js.map

package/dist/components/schema/SchemaDatatype.js

@@ -37,4 +37,3 @@ function formatBaseType(schema) {
     const type = Array.isArray(schema.type) ? schema.type.join(" | ") : schema.type;
     return type ?? "any";
 }
-//# sourceMappingURL=SchemaDatatype.js.map

package/dist/components/schema/SchemaView.js

@@ -41,4 +41,3 @@ function PropertyRow({ name, schema, required, depth, maxDepth, }) {
             (schema.items.properties || schema.items.allOf || schema.items.oneOf || schema.items.anyOf));
     return (_jsxs("div", { class: "param-item", children: [_jsxs("div", { class: "param-header", children: [_jsx("code", { class: "param-name", children: name }), _jsx("span", { class: "param-type", children: _jsx(SchemaDatatype, { schema: schema }) }), required && _jsx(RequiredBadge, {}), schema.readOnly && _jsx(ReadOnlyBadge, {}), schema.writeOnly && _jsx(Badge, { children: "write only" }), schema.deprecated && _jsx(DeprecatedBadge, {})] }), schema.description && (_jsx("div", { class: "param-description", children: _jsx(Markdown, { content: schema.description }) })), hasInner && (_jsxs("details", { class: "schema-expandable", children: [_jsxs("summary", { class: "schema-expandable-toggle", children: [_jsx("svg", { class: "schema-expandable-icon", viewBox: "0 0 256 512", width: "8", height: "8", children: _jsx("path", { fill: "currentColor", d: "M249.3 235.8c10.2 12.6 9.5 31.1-2.2 42.8l-128 128c-9.2 9.2-22.9 11.9-34.9 6.9S64.5 396.9 64.5 384l0-256c0-12.9 7.8-24.6 19.8-29.6s25.7-2.2 34.9 6.9l128 128 2.2 2.4z" }) }), "Show child attributes"] }), _jsx("div", { class: "schema-expandable-content", children: _jsx(SchemaView, { schema: schema.type === "array" && schema.items ? schema.items : schema, depth: depth + 1, maxDepth: maxDepth }) })] }))] }));
 }
-//# sourceMappingURL=SchemaView.js.map

package/dist/components/ui/Badge.js

@@ -11,4 +11,3 @@ export function DeprecatedBadge() {
 export function ReadOnlyBadge() {
     return (_jsx("span", { class: "whitespace-nowrap rounded-md bg-[rgb(var(--color-gray-100)/0.5)] px-2 py-0.5 text-xs font-medium text-[rgb(var(--color-gray-600))] dark:bg-[rgb(var(--color-surface-dark-tint)/0.05)] dark:text-[rgb(var(--color-gray-200))]", children: "read only" }));
 }
-//# sourceMappingURL=Badge.js.map

package/dist/components/ui/CopyButton.js

@@ -7,4 +7,3 @@ import { COPY_ICON_PATH_1, COPY_ICON_PATH_2 } from "../../utils/copy-svg.js";
 export function CopyButton() {
     return (_jsxs("div", { class: "relative z-10 select-none", children: [_jsx("button", { "aria-label": "Copy code", class: "copy-btn peer group/copy flex size-[26px] items-center justify-center rounded-md backdrop-blur", type: "button", "data-copy-source": "code", children: _jsxs("svg", { class: "size-4 text-[rgb(var(--color-stone-400))] group-hover/copy:text-[rgb(var(--color-stone-500))] dark:text-[rgb(255_255_255/0.4)] dark:group-hover/copy:text-[rgb(255_255_255/0.6)]", fill: "none", height: "18", viewBox: "0 0 18 18", width: "18", xmlns: "http://www.w3.org/2000/svg", children: [_jsx("title", { children: "Copy" }), _jsx("path", { d: COPY_ICON_PATH_1, stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" }), _jsx("path", { d: COPY_ICON_PATH_2, stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" })] }) }), _jsx("div", { "aria-hidden": "true", class: "copy-tooltip absolute top-[2.75rem] left-1/2 -translate-x-1/2 -translate-y-1/2 whitespace-nowrap rounded-lg bg-[rgb(var(--color-primary-dark))] px-1.5 py-0.5 text-white text-xs opacity-0 peer-hover:opacity-100 transition-opacity pointer-events-none", children: "Copy" })] }));
 }
-//# sourceMappingURL=CopyButton.js.map

package/dist/components/ui/Logo.js

@@ -6,4 +6,3 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "preact/jsx-ru
 export function Logo({ href, logo, name, height = "h-7" }) {
     return (_jsx("a", { href: href, class: "select-none inline-block", children: logo?.light ? (_jsxs(_Fragment, { children: [_jsx("img", { src: logo.light, alt: name || "Home", class: `w-auto ${height} object-contain block dark:hidden` }), _jsx("img", { src: logo.dark ?? logo.light, alt: name || "Home", class: `w-auto ${height} object-contain hidden dark:block` })] })) : (_jsx("span", { class: "text-sm font-semibold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: name || "Docs" })) }));
 }
-//# sourceMappingURL=Logo.js.map

package/dist/components/ui/Markdown.js

@@ -10,4 +10,3 @@ export function Markdown({ content, inline, class: className }) {
     const cls = className ? `prose prose-gray dark:prose-invert ${className}` : "prose prose-gray dark:prose-invert";
     return (_jsx("div", { class: cls, dangerouslySetInnerHTML: { __html: html } }));
 }
-//# sourceMappingURL=Markdown.js.map

package/dist/components/ui/SectionLabel.js

@@ -6,4 +6,3 @@ import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
 export function SectionLabel({ children, meta }) {
     return (_jsxs("div", { class: "flex items-baseline border-b pb-2.5 border-[rgb(var(--color-gray-100))] dark:border-[rgb(var(--color-gray-800))] w-full mb-4", children: [_jsx("h4", { class: "flex-1 mb-0 text-sm font-semibold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: children }), meta && (_jsx("div", { class: "flex items-center gap-2 text-xs font-medium font-mono text-[rgb(var(--color-gray-500))]", children: meta }))] }));
 }
-//# sourceMappingURL=SectionLabel.js.map

package/dist/components/ui/SocialIcon.js

@@ -65,4 +65,3 @@ export function SocialIcon({ type }) {
         return null;
     return (_jsx("svg", { viewBox: icon.viewBox, fill: "currentColor", class: "w-5 h-5", dangerouslySetInnerHTML: { __html: icon.path } }));
 }
-//# sourceMappingURL=SocialIcon.js.map

package/dist/config.d.ts

@@ -53,6 +53,7 @@ export interface SourceyConfig {
         links?: NavbarLink[];
     };
 }
+export type DoxygenIndexStyle = "auto" | "rich" | "structured" | "flat" | "none";
 export interface DoxygenConfig {
     /** Path to Doxygen XML output directory */
     xml: string;
@@ -60,6 +61,15 @@ export interface DoxygenConfig {
     language?: string;
     /** Use Doxygen groups for navigation grouping */
     groups?: boolean;
+    /**
+     * Index page style for the API reference landing page.
+     * - "auto": pick the best format based on available data (default)
+     * - "rich": card grid with module descriptions (requires groups with descriptions)
+     * - "structured": grouped list of types by module/namespace
+     * - "flat": alphabetical list categorized by kind (classes, structs, etc.)
+     * - "none" or false: no index page, land on the first API page
+     */
+    index?: DoxygenIndexStyle | false;
 }
 export interface TabConfig {
     tab: string;
@@ -128,6 +138,7 @@ export interface ResolvedDoxygenConfig {
     xml: string;
     language: string;
     groups: boolean;
+    index: DoxygenIndexStyle;
 }
 export interface ResolvedTab {
     label: string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -159,6 +159,7 @@ async function resolveTabs(tabs, configDir) {
                     xml: absXml,
                     language: tab.doxygen.language ?? "cpp",
                     groups: tab.doxygen.groups ?? false,
+                    index: tab.doxygen.index === false ? "none" : (tab.doxygen.index ?? "auto"),
                 },
             });
         }
@@ -261,4 +262,3 @@ async function assertExists(filePath, label) {
         throw new Error(`${label} not found: ${filePath}`);
     }
 }
-//# sourceMappingURL=config.js.map

package/dist/core/converter.js

@@ -26,4 +26,3 @@ export async function convertToOpenApi3(parsed) {
         source: parsed.source,
     };
 }
-//# sourceMappingURL=converter.js.map

package/dist/core/doxygen-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doxygen-loader.d.ts","sourceRoot":"","sources":["../../src/core/doxygen-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAA6B,MAAM,iBAAiB,CAAC;AAM1E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,CAwExB"}
+{"version":3,"file":"doxygen-loader.d.ts","sourceRoot":"","sources":["../../src/core/doxygen-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAA6B,MAAM,iBAAiB,CAAC;AAM1E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,CA4FxB"}

package/dist/core/doxygen-loader.js

@@ -31,16 +31,13 @@ export async function loadDoxygenTab(config, tabSlug, tabLabel) {
     // Build navigation: namespace index pages first, then classes alphabetically
     const groups = [];
     for (const [key, items] of groupMap) {
-        // Use the group overview page's title as the sidebar label if available
         const groupPage = items.find((i) => i.kind === "group");
         const label = groupPage?.title ?? key;
         const sorted = items.sort((a, b) => {
-            // Group overview page always first
             if (a.kind === "group" && b.kind !== "group")
                 return -1;
             if (a.kind !== "group" && b.kind === "group")
                 return 1;
-            // Then namespace index pages
             if (a.kind === "namespace" && b.kind !== "namespace")
                 return -1;
             if (a.kind !== "namespace" && b.kind === "namespace")
@@ -56,6 +53,25 @@ export async function loadDoxygenTab(config, tabSlug, tabLabel) {
             })),
         });
     }
+    // Generate index page
+    const indexStyle = resolveIndexStyle(config.index, groupMap, pages);
+    if (indexStyle !== "none") {
+        const indexSlug = "index";
+        const indexHtml = buildIndexHtml(indexStyle, tabSlug, tabLabel, groupMap, pages);
+        const indexHeadings = indexStyle === "rich" ? [] : extractHeadings(indexHtml);
+        pages.set(indexSlug, {
+            title: tabLabel,
+            description: "",
+            slug: indexSlug,
+            html: indexHtml,
+            headings: indexHeadings,
+            sourcePath: config.xml,
+        });
+        groups.unshift({
+            label: tabLabel,
+            items: [{ label: "Overview", href: `${tabSlug}/${indexSlug}.html`, id: indexSlug }],
+        });
+    }
     const firstItem = groups[0]?.items[0];
     return {
         pages,
@@ -68,10 +84,148 @@ export async function loadDoxygenTab(config, tabSlug, tabLabel) {
         },
     };
 }
+/**
+ * Resolve "auto" to a concrete style based on the data we have.
+ */
+function resolveIndexStyle(configured, groupMap, pages) {
+    if (configured !== "auto")
+        return configured;
+    // Tiny projects — no index needed
+    if (pages.size < 5)
+        return "none";
+    // Check if we have groups with descriptions
+    const groupsWithDesc = [...groupMap.values()]
+        .map((items) => items.find((i) => i.kind === "group"))
+        .filter((g) => !!g)
+        .filter((g) => pages.get(g.slug)?.description);
+    if (groupsWithDesc.length >= 2)
+        return "rich";
+    // Check if we have meaningful grouping (multiple groups/namespaces)
+    if (groupMap.size >= 2)
+        return "structured";
+    return "flat";
+}
+/**
+ * Build index page HTML using sourcey's existing component markup.
+ */
+function buildIndexHtml(style, tabSlug, _tabLabel, groupMap, pages) {
+    if (style === "rich")
+        return buildRichIndex(tabSlug, groupMap, pages);
+    if (style === "structured")
+        return buildStructuredIndex(tabSlug, groupMap, pages);
+    return buildFlatIndex(tabSlug, groupMap);
+}
+/**
+ * Rich: card grid with module name, description, and type count.
+ * Uses sourcey's card-group/card-item CSS.
+ */
+function buildRichIndex(tabSlug, groupMap, pages) {
+    const cards = [];
+    for (const [, items] of groupMap) {
+        const groupEntry = items.find((i) => i.kind === "group");
+        if (!groupEntry)
+            continue;
+        const page = pages.get(groupEntry.slug);
+        if (!page)
+            continue;
+        const typeCount = items.filter((i) => i.kind !== "group" && i.kind !== "namespace").length;
+        const href = `${tabSlug}/${groupEntry.slug}.html`;
+        const desc = page.description || "";
+        const meta = typeCount > 0
+            ? `<p style="margin:0.5rem 0 0;font-size:0.8rem;opacity:0.5">${typeCount} type${typeCount !== 1 ? "s" : ""}</p>`
+            : "";
+        cards.push(`<a href="${href}" class="card-item">` +
+            `<div class="card-item-inner">` +
+            `<h3 class="card-item-title">${escHtml(page.title)}</h3>` +
+            (desc ? `<div class="card-item-content"><p>${escHtml(desc)}</p>${meta}</div>` : `<div class="card-item-content">${meta}</div>`) +
+            `</div></a>`);
+    }
+    // Also include groups without a group page (orphan namespaces)
+    for (const [key, items] of groupMap) {
+        const hasGroup = items.some((i) => i.kind === "group");
+        if (hasGroup)
+            continue;
+        const typeCount = items.filter((i) => i.kind !== "namespace").length;
+        if (typeCount === 0)
+            continue;
+        const firstItem = items[0];
+        const href = `${tabSlug}/${firstItem.slug}.html`;
+        cards.push(`<a href="${href}" class="card-item">` +
+            `<div class="card-item-inner">` +
+            `<h3 class="card-item-title">${escHtml(key)}</h3>` +
+            `<div class="card-item-content"><p style="margin:0;font-size:0.8rem;opacity:0.5">${typeCount} type${typeCount !== 1 ? "s" : ""}</p></div>` +
+            `</div></a>`);
+    }
+    if (cards.length === 0)
+        return "";
+    const cols = cards.length <= 2 ? "2" : "3";
+    return `<div class="card-group not-prose" data-cols="${cols}">\n${cards.join("\n")}\n</div>`;
+}
+/**
+ * Structured: grouped list of types by module/namespace.
+ * Rendered as markdown headings with link lists.
+ */
+function buildStructuredIndex(tabSlug, groupMap, pages) {
+    const sections = [];
+    for (const [key, items] of groupMap) {
+        const groupEntry = items.find((i) => i.kind === "group");
+        const title = groupEntry ? (pages.get(groupEntry.slug)?.title ?? key) : key;
+        const types = items.filter((i) => i.kind !== "group" && i.kind !== "namespace");
+        if (types.length === 0 && !groupEntry)
+            continue;
+        const links = [];
+        if (groupEntry) {
+            links.push(`- [Overview](${tabSlug}/${groupEntry.slug}.html)`);
+        }
+        for (const t of types) {
+            links.push(`- [${t.title}](${tabSlug}/${t.slug}.html)`);
+        }
+        sections.push(`### ${title}\n\n${links.join("\n")}`);
+    }
+    return renderMarkdown(sections.join("\n\n"));
+}
+/**
+ * Flat: alphabetical list categorized by kind.
+ */
+function buildFlatIndex(tabSlug, groupMap) {
+    const byKind = new Map();
+    for (const [, items] of groupMap) {
+        for (const item of items) {
+            if (item.kind === "group" || item.kind === "namespace")
+                continue;
+            const label = kindLabel(item.kind);
+            if (!byKind.has(label))
+                byKind.set(label, []);
+            byKind.get(label).push(item);
+        }
+    }
+    const sections = [];
+    for (const [label, items] of byKind) {
+        const sorted = items.sort((a, b) => a.title.localeCompare(b.title));
+        const links = sorted.map((i) => `- [${i.title}](${tabSlug}/${i.slug}.html)`).join("\n");
+        sections.push(`### ${label}\n\n${links}`);
+    }
+    return renderMarkdown(sections.join("\n\n"));
+}
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
 function lastSegment(name) {
     if (!name)
         return undefined;
     const parts = name.split("::");
     return parts[parts.length - 1] || name;
 }
-//# sourceMappingURL=doxygen-loader.js.map
+function escHtml(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function kindLabel(kind) {
+    switch (kind) {
+        case "class": return "Classes";
+        case "struct": return "Structs";
+        case "enum": return "Enums";
+        case "union": return "Unions";
+        case "typedef": return "Type Aliases";
+        default: return kind.charAt(0).toUpperCase() + kind.slice(1) + "s";
+    }
+}

package/dist/core/loader.js

@@ -89,4 +89,3 @@ function detectVersion(raw) {
 function isUrl(source) {
     return source.startsWith("http://") || source.startsWith("https://");
 }
-//# sourceMappingURL=loader.js.map

package/dist/core/markdown-loader.js

@@ -257,4 +257,3 @@ function extractFirstHeading(md) {
 export function slugFromPath(filePath) {
     return htmlId(basename(filePath, extname(filePath)));
 }
-//# sourceMappingURL=markdown-loader.js.map

package/dist/core/navigation.js

@@ -105,4 +105,3 @@ export function buildSiteNavigation(tabs) {
 export function withActivePage(nav, tabSlug, pageSlug) {
     return { ...nav, activeTabSlug: tabSlug, activePageSlug: pageSlug };
 }
-//# sourceMappingURL=navigation.js.map

package/dist/core/normalizer.js

@@ -469,4 +469,3 @@ function str(value, fallback) {
 function optStr(value) {
     return typeof value === "string" ? value : undefined;
 }
-//# sourceMappingURL=normalizer.js.map

package/dist/core/parser.js

@@ -31,4 +31,3 @@ export async function parseSpec(loaded) {
         throw new Error(`Failed to parse OpenAPI spec: ${message}`);
     }
 }
-//# sourceMappingURL=parser.js.map

package/dist/core/search-indexer.js

@@ -70,4 +70,3 @@ export function buildSearchIndex(specs, pages, navigation, assetBase = "/") {
 function stripHtml(html) {
     return html.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
 }
-//# sourceMappingURL=search-indexer.js.map

package/dist/core/types.js

@@ -4,4 +4,3 @@
  * before rendering, so components never need to know the source format.
  */
 export {};
-//# sourceMappingURL=types.js.map

package/dist/dev-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../src/dev-server.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0H7E"}
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../src/dev-server.ts"],"names":[],"mappings":"AAqCA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoW7E"}

package/dist/dev-server.js

@@ -1,5 +1,5 @@
 import { createServer as createViteServer } from "vite";
-import { resolve, dirname, extname } from "node:path";
+import { resolve, dirname, extname, basename, relative } from "node:path";
 import { readFile, access } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 import { loadConfig, resolveConfigFromRaw, tabPath } from "./config.js";
@@ -24,6 +24,13 @@ async function exists(path) {
         return false;
     }
 }
+function log(msg) {
+    const t = new Date().toLocaleTimeString([], { hour12: false, hour: "2-digit", minute: "2-digit", second: "2-digit" });
+    console.log(`  \x1b[2m${t}\x1b[0m ${msg}`);
+}
+function shortPath(p) {
+    return relative(process.cwd(), p) || basename(p);
+}
 export async function startDevServer(options) {
     const { port } = options;
     const configPath = resolve(process.cwd(), "sourcey.config.ts");
@@ -43,6 +50,27 @@ export async function startDevServer(options) {
             }
         }
     }
+    function buildFileToContent(cfg) {
+        const map = new Map();
+        map.set(configPath, { kind: "config" });
+        for (const tab of cfg.tabs) {
+            if (tab.openapi) {
+                map.set(resolve(tab.openapi), { kind: "openapi", tabSlug: tab.slug, specPath: tab.openapi });
+            }
+            if (tab.doxygen) {
+                map.set(resolve(tab.doxygen.xml), { kind: "doxygen", tabSlug: tab.slug, xmlDir: tab.doxygen.xml });
+            }
+            if (tab.groups) {
+                for (const group of tab.groups) {
+                    for (const pagePath of group.pages) {
+                        map.set(resolve(pagePath), { kind: "markdown", tabSlug: tab.slug, pagePath });
+                    }
+                }
+            }
+        }
+        return map;
+    }
+    let fileToContent = buildFileToContent(config);
     // Resolve source paths for Vite dev serving.
     // Prefer src/ (local dev) but fall back to dist/ (npm install).
     const projectRoot = resolve(__dirname, "..");
@@ -52,19 +80,145 @@ export async function startDevServer(options) {
     const clientEntry = resolve(projectRoot, hasSrc ? "src/client/index.ts" : "dist/client/index.js");
     const ssrRendererPath = resolve(projectRoot, hasSrc ? "src/renderer/static-renderer.ts" : "dist/renderer/static-renderer.js");
     let vite;
+    let cache = null;
+    let cachePromise = null;
+    function fullRebuild() {
+        if (!cachePromise) {
+            const start = performance.now();
+            log("building site data...");
+            cachePromise = (async () => {
+                const data = await loadSiteData(config.tabs);
+                const siteConfig = await buildSiteConfig(config);
+                const result = { data, siteConfig };
+                cache = result;
+                cachePromise = null;
+                const ms = Math.round(performance.now() - start);
+                log(`ready \x1b[2m(${data.pageMap.size} pages in ${ms}ms)\x1b[0m`);
+                return result;
+            })().catch((err) => {
+                cachePromise = null;
+                throw err;
+            });
+        }
+        return cachePromise;
+    }
+    function getCached() {
+        if (cache)
+            return Promise.resolve(cache);
+        return fullRebuild();
+    }
+    // Incremental patch: reload only the piece that changed, then reassemble
+    // siteTabs + pageMap from the patched data. Falls back to full rebuild if
+    // the cache isn't warm yet.
+    async function incrementalUpdate(content) {
+        // Capture current cache; if a full rebuild replaces it while we await,
+        // we abandon this patch (the rebuild already produced fresh data).
+        const snapshot = cache;
+        if (!snapshot) {
+            await fullRebuild();
+            return;
+        }
+        const { data } = snapshot;
+        const start = performance.now();
+        if (content.kind === "markdown") {
+            const slug = slugFromPath(content.pagePath);
+            log(`reloading ${shortPath(content.pagePath)}`);
+            const page = await loadMarkdownPage(content.pagePath, slug);
+            if (cache !== snapshot)
+                return;
+            const pageKey = tabPath(content.tabSlug, `${slug}.html`);
+            const existing = data.pageMap.get(pageKey);
+            if (existing) {
+                existing.currentPage = { kind: "markdown", markdown: page };
+            }
+            rebuildTabNav(data, config.tabs, content.tabSlug);
+        }
+        else if (content.kind === "doxygen") {
+            const tab = config.tabs.find((t) => t.slug === content.tabSlug);
+            if (!tab?.doxygen)
+                return;
+            log(`rebuilding doxygen tab "${tab.label}"`);
+            const { pages, navTab } = await loadDoxygenTab(tab.doxygen, tab.slug, tab.label);
+            if (cache !== snapshot)
+                return;
+            for (const [key, entry] of data.pageMap) {
+                if (entry.tabSlug === content.tabSlug)
+                    data.pageMap.delete(key);
+            }
+            for (const [slug, page] of pages) {
+                data.pageMap.set(tabPath(tab.slug, `${slug}.html`), {
+                    spec: data.primarySpec,
+                    currentPage: { kind: "markdown", markdown: page },
+                    tabSlug: tab.slug,
+                    pageSlug: slug,
+                });
+            }
+            const idx = data.siteTabs.findIndex((t) => t.slug === content.tabSlug);
+            if (idx !== -1)
+                data.siteTabs[idx] = navTab;
+            else
+                data.siteTabs.push(navTab);
+        }
+        else if (content.kind === "openapi") {
+            log(`reparsing spec ${shortPath(content.specPath)}`);
+            const loaded = await loadSpec(content.specPath);
+            const parsed = await parseSpec(loaded);
+            const openapi3 = await convertToOpenApi3(parsed);
+            const spec = normalizeSpec(openapi3);
+            if (cache !== snapshot)
+                return;
+            data.specsBySlug.set(content.tabSlug, spec);
+            const pageKey = tabPath(content.tabSlug, "index.html");
+            const existing = data.pageMap.get(pageKey);
+            if (existing) {
+                existing.currentPage = { kind: "spec", spec };
+                existing.spec = spec;
+            }
+            const tab = config.tabs.find((t) => t.slug === content.tabSlug);
+            if (tab) {
+                const navTab = buildNavFromSpec(spec, tab.slug);
+                navTab.label = tab.label;
+                const idx = data.siteTabs.findIndex((t) => t.slug === content.tabSlug);
+                if (idx !== -1)
+                    data.siteTabs[idx] = navTab;
+            }
+        }
+        const ms = Math.round(performance.now() - start);
+        log(`updated \x1b[2m(${ms}ms)\x1b[0m`);
+    }
+    // Rebuild navigation for a single markdown tab from cached page data
+    function rebuildTabNav(data, tabs, tabSlug) {
+        const tab = tabs.find((t) => t.slug === tabSlug);
+        if (!tab?.groups)
+            return;
+        const pagesByPath = new Map();
+        for (const group of tab.groups) {
+            for (const pagePath of group.pages) {
+                const slug = slugFromPath(pagePath);
+                const pageKey = tabPath(tab.slug, `${slug}.html`);
+                const entry = data.pageMap.get(pageKey);
+                if (entry?.currentPage.kind === "markdown") {
+                    pagesByPath.set(pagePath, entry.currentPage.markdown);
+                }
+            }
+        }
+        const navTab = buildNavFromPages(tab, pagesByPath);
+        const idx = data.siteTabs.findIndex((t) => t.slug === tabSlug);
+        if (idx !== -1)
+            data.siteTabs[idx] = navTab;
+    }
     // Reload config through Vite SSR (bypasses Node's module cache)
     async function reloadConfig() {
         const configMod = await vite.ssrLoadModule(configPath);
         return resolveConfigFromRaw(configMod.default, process.cwd());
     }
     async function render(url) {
-        // Load render-path modules through Vite's SSR graph so invalidateAll() works.
-        // Static imports would survive invalidation and serve stale output.
+        // Load renderer through Vite's SSR graph so invalidateAll() picks up
+        // component changes. Site data uses static imports (file reads only).
         const { renderPage } = await vite.ssrLoadModule(ssrRendererPath);
-        const mdLoader = await vite.ssrLoadModule(resolve(projectRoot, hasSrc ? "src/core/markdown-loader.ts" : "dist/core/markdown-loader.js"));
-        const { siteTabs, primarySpec, pageMap } = await loadSiteData(config.tabs, mdLoader.loadMarkdownPage);
+        const { data, siteConfig: site } = await getCached();
+        const { siteTabs, pageMap } = data;
         const navigation = buildSiteNavigation(siteTabs);
-        const site = await buildSiteConfig(config);
         let pagePath = url.replace(/^\//, "").replace(/\/$/, "");
         if (!pagePath || pagePath === "index.html") {
             const firstKey = pageMap.keys().next().value;
@@ -82,11 +236,29 @@ export async function startDevServer(options) {
         const renderOptions = { embeddable: false, assetBase: "/" };
         let html = renderPage(pageData.spec, renderOptions, activeNav, pageData.currentPage, site);
         // Rewrite asset paths for Vite HMR
-        html = html.replace(/<link rel="stylesheet" href="[^"]*sourcey\.css"[^>]*\/>/, `<link rel="stylesheet" href="/@fs${tailwindCssPath}" />\n<link rel="stylesheet" href="/@fs${sourceyCssPath}?direct" />`);
+        // Preact outputs <link ... href="/sourcey.css"/> (no space before />)
+        html = html.replace(/<link rel="stylesheet" href="[^"]*sourcey\.css"\s*\/?>/, `<link rel="stylesheet" href="/@fs${tailwindCssPath}" />\n<link rel="stylesheet" href="/@fs${sourceyCssPath}?direct" />`);
         html = html.replace(/<script src="[^"]*sourcey\.js"[^>]*><\/script>/, `<script type="module" src="/@fs${clientEntry}"></script>`);
-        html = html.replace(/<script src="[^"]*sourcey\.js"[^>]*\/>/, `<script type="module" src="/@fs${clientEntry}"></script>`);
+        html = html.replace(/<script src="[^"]*sourcey\.js"\s*\/?>/, `<script type="module" src="/@fs${clientEntry}"></script>`);
         return html;
     }
+    async function buildSearchIndexForDev() {
+        const { data: { siteTabs, pageMap, specsBySlug } } = await getCached();
+        const navigation = buildSiteNavigation(siteTabs);
+        const markdownPagesByTab = new Map();
+        for (const tab of config.tabs) {
+            if (tab.groups || tab.doxygen) {
+                const tabPages = [];
+                for (const [, entry] of pageMap) {
+                    if (entry.tabSlug === tab.slug && entry.currentPage.kind === "markdown") {
+                        tabPages.push(entry.currentPage.markdown);
+                    }
+                }
+                markdownPagesByTab.set(tab.slug, tabPages);
+            }
+        }
+        return buildSearchIndex(specsBySlug, markdownPagesByTab, navigation);
+    }
     const viteConfig = {
         root: process.cwd(),
         server: {
@@ -100,7 +272,7 @@ export async function startDevServer(options) {
             sourceyPlugin({
                 watchPaths,
                 render,
-                searchIndex: () => buildSearchIndexForDev(config),
+                searchIndex: buildSearchIndexForDev,
             }),
         ],
         clearScreen: false,
@@ -110,18 +282,50 @@ export async function startDevServer(options) {
         },
     };
     vite = await createViteServer(viteConfig);
-    // Reload config when sourcey.config.ts changes
+    // Incremental rebuild when content files change
     vite.watcher.on("change", async (file) => {
-        if (file === configPath) {
+        // Check direct match first (markdown pages, spec files, config)
+        let content = fileToContent.get(file);
+        // For .xml files inside a doxygen directory, map to the parent tab
+        if (!content && extname(file) === ".xml") {
+            for (const [, c] of fileToContent) {
+                if (c.kind === "doxygen" && file.startsWith(resolve(c.xmlDir))) {
+                    content = c;
+                    break;
+                }
+            }
+        }
+        if (!content)
+            return;
+        if (content.kind === "config") {
+            log("config changed, reloading...");
             config = await reloadConfig();
+            fileToContent = buildFileToContent(config);
+            for (const path of fileToContent.keys()) {
+                vite.watcher.add(path);
+            }
+            cache = null;
+            cachePromise = null;
+            fullRebuild().catch((err) => {
+                console.error("  Site data rebuild failed:", err.message);
+            });
+        }
+        else {
+            incrementalUpdate(content).catch((err) => {
+                console.error("  Incremental update failed:", err.message);
+            });
         }
     });
     await vite.listen();
     console.log(`\n  Sourcey dev server running at http://localhost:${port}`);
     console.log(`  Watching: ${watchPaths.length} content file${watchPaths.length === 1 ? "" : "s"} + components + CSS (HMR)`);
     console.log(`  Press Ctrl+C to stop\n`);
+    // Build in background — server is listening, first request waits for this
+    fullRebuild().catch((err) => {
+        console.error("  Initial site data build failed:", err.message);
+    });
 }
-async function loadSiteData(tabs, loadMarkdownPageFn = loadMarkdownPage) {
+async function loadSiteData(tabs) {
     const specsBySlug = new Map();
     const siteTabs = [];
     const pageMap = new Map();
@@ -168,7 +372,7 @@ async function loadSiteData(tabs, loadMarkdownPageFn = loadMarkdownPage) {
             for (const group of tab.groups) {
                 for (const pagePath of group.pages) {
                     const slug = slugFromPath(pagePath);
-                    const page = await loadMarkdownPageFn(pagePath, slug);
+                    const page = await loadMarkdownPage(pagePath, slug);
                     pagesByPath.set(pagePath, page);
                     pageMap.set(tabPath(tab.slug, `${slug}.html`), {
                         spec: primarySpec,
@@ -214,23 +418,6 @@ async function loadCustomCSS(paths) {
     }
     return parts.join("\n");
 }
-async function buildSearchIndexForDev(config) {
-    const { siteTabs, pageMap, specsBySlug } = await loadSiteData(config.tabs);
-    const navigation = buildSiteNavigation(siteTabs);
-    const markdownPagesByTab = new Map();
-    for (const tab of config.tabs) {
-        if (tab.groups || tab.doxygen) {
-            const tabPages = [];
-            for (const [, entry] of pageMap) {
-                if (entry.tabSlug === tab.slug && entry.currentPage.kind === "markdown") {
-                    tabPages.push(entry.currentPage.markdown);
-                }
-            }
-            markdownPagesByTab.set(tab.slug, tabPages);
-        }
-    }
-    return buildSearchIndex(specsBySlug, markdownPagesByTab, navigation);
-}
 const MIME_TYPES = {
     ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg",
     ".gif": "image/gif", ".svg": "image/svg+xml", ".webp": "image/webp",
@@ -245,4 +432,3 @@ async function resolveAssetUrl(pathOrUrl) {
     const data = await readFile(abs);
     return `data:${mime};base64,${data.toString("base64")}`;
 }
-//# sourceMappingURL=dev-server.js.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,aAAa,CAAC;AAc/D,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAY3E;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtC;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0G5F;AA2ID,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,aAAa,CAAC;AAc/D,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAY3E;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtC;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0G5F;AAgKD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 import { readFile } from "node:fs/promises";
-import { resolve, extname } from "node:path";
+import { resolve, extname, posix } from "node:path";
 import { loadSpec } from "./core/loader.js";
 import { convertToOpenApi3 } from "./core/converter.js";
 import { parseSpec } from "./core/parser.js";
@@ -99,7 +99,7 @@ export async function buildSiteDocs(options = {}) {
     // Resolve internal links in markdown pages.
     // Builds a map from every plausible href to the correct output path,
     // then rewrites matching href attributes in each page's HTML.
-    resolveInternalLinks(sitePages);
+    resolveInternalLinks(sitePages, config);
     // Build search index
     const markdownPagesByTab = new Map();
     for (const tab of tabs) {
@@ -192,7 +192,7 @@ async function resolveAssetUrl(pathOrUrl) {
  * rewrites matching href values so they resolve on static file servers
  * that don't support extensionless URLs.
  */
-function resolveInternalLinks(pages) {
+function resolveInternalLinks(pages, config) {
     // Build a map from every plausible clean path to the output path.
     // e.g. "components" -> "components.html", "config/ref-theme-tokens" -> "config/ref-theme-tokens.html"
     const pathMap = new Map();
@@ -201,6 +201,10 @@ function resolveInternalLinks(pages) {
         const clean = out.replace(/\.html$/, ""); // "components" or "config/ref-theme-tokens"
         pathMap.set(clean, out);
     }
+    // Repo source link base: e.g. "https://github.com/user/repo/tree/main"
+    const repoBase = config.repo?.replace(/\/$/, "");
+    const branch = config.editBranch;
+    const sourceBase = repoBase && branch ? `${repoBase}/tree/${branch}` : undefined;
     for (const page of pages) {
         if (page.currentPage.kind !== "markdown" || !page.currentPage.markdown)
             continue;
@@ -218,8 +222,8 @@ function resolveInternalLinks(pages) {
             // Split off hash fragment
             const [path, hash] = href.split("#", 2);
             const hashSuffix = hash ? `#${hash}` : "";
-            // Normalize: strip leading slash, trailing slash
-            const clean = path.replace(/^\/+/, "").replace(/\/+$/, "");
+            // Normalize: strip leading slash, trailing slash, and .md extension
+            const clean = path.replace(/^\/+/, "").replace(/\/+$/, "").replace(/\.md$/, "");
             // Skip if already has .html extension
             if (clean.endsWith(".html"))
                 return _match;
@@ -235,13 +239,26 @@ function resolveInternalLinks(pages) {
                     break;
                 candidate = candidate.substring(slash + 1);
             }
-            if (!target)
-                return _match;
-            // Build relative path from this page to the target
-            const relativePath = toRoot + target;
-            return `href="${relativePath}${hashSuffix}"`;
+            if (target) {
+                // Build relative path from this page to the target
+                const relativePath = toRoot + target;
+                return `href="${relativePath}${hashSuffix}"`;
+            }
+            // If the link contains ../ and we have a repo URL configured,
+            // resolve it relative to the markdown source file. Links to docs
+            // pages are already handled above (pathMap lookup catches them after
+            // .md stripping and prefix stripping). What remains are links to
+            // repo source code outside the docs directory.
+            if (sourceBase && href.includes("../") && md.sourcePath) {
+                const sourceDir = posix.dirname(md.sourcePath);
+                const resolved = posix.normalize(posix.join(sourceDir, path));
+                // Only rewrite if the path stays inside the repo root
+                if (!resolved.startsWith("..")) {
+                    return `href="${sourceBase}/${resolved}${hashSuffix}"`;
+                }
+            }
+            return _match;
         });
     }
 }
 export { defineConfig } from "./config.js";
-//# sourceMappingURL=index.js.map

package/dist/init.js

@@ -267,4 +267,3 @@ import { myFunction } from "my-package";
         consola.log("");
     },
 });
-//# sourceMappingURL=init.js.map

package/dist/renderer/context.js

@@ -19,4 +19,3 @@ export const NavigationContext = createContext(null);
  */
 export const PageContext = createContext(null);
 export const SiteContext = createContext(null);
-//# sourceMappingURL=context.js.map

package/dist/renderer/html-builder.js

@@ -96,4 +96,3 @@ async function buildAssets(outputDir) {
     const builtCSS = await readFile(resolve(outputDir, "sourcey.css"), "utf-8").catch(() => "");
     await writeFile(resolve(outputDir, "sourcey.css"), builtCSS + "\n" + componentCSS, "utf-8");
 }
-//# sourceMappingURL=html-builder.js.map

package/dist/renderer/static-renderer.js

@@ -14,4 +14,3 @@ export function renderPage(spec, options, navigation, currentPage, site) {
     }
     return `<!DOCTYPE html>\n${html}`;
 }
-//# sourceMappingURL=static-renderer.js.map

package/dist/utils/code-samples.js

@@ -223,4 +223,3 @@ function indent(str, spaces) {
     const pad = " ".repeat(spaces);
     return str.replace(/\n/g, "\n" + pad);
 }
-//# sourceMappingURL=code-samples.js.map

package/dist/utils/copy-svg.js

@@ -6,4 +6,3 @@ export const COPY_ICON_PATH_1 = "M14.25 5.25H7.25C6.14543 5.25 5.25 6.14543 5.25
 export const COPY_ICON_PATH_2 = "M2.80103 11.998L1.77203 5.07397C1.61003 3.98097 2.36403 2.96397 3.45603 2.80197L10.38 1.77297C11.313 1.63397 12.19 2.16297 12.528 3.00097";
 /** Raw HTML string for server-rendered contexts (markdown code blocks). */
 export const COPY_ICON_SVG = `<svg fill="none" height="18" viewBox="0 0 18 18" width="18" xmlns="http://www.w3.org/2000/svg"><title>Copy</title><path d="${COPY_ICON_PATH_1}" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/><path d="${COPY_ICON_PATH_2}" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/></svg>`;
-//# sourceMappingURL=copy-svg.js.map

package/dist/utils/example-generator.js

@@ -120,4 +120,3 @@ function mergeAllOfExamples(schemas, seen) {
     }
     return Object.keys(merged).length > 0 ? merged : undefined;
 }
-//# sourceMappingURL=example-generator.js.map

package/dist/utils/highlighter.js

@@ -59,4 +59,3 @@ export function highlightCode(code, lang) {
         defaultColor: false,
     });
 }
-//# sourceMappingURL=highlighter.js.map

package/dist/utils/html-id.js

@@ -8,4 +8,3 @@ export function htmlId(value) {
         .replace(/[^a-z0-9]+/g, "-")
         .replace(/^-+|-+$/g, "");
 }
-//# sourceMappingURL=html-id.js.map

package/dist/utils/http.js

@@ -94,4 +94,3 @@ export function methodColor(method) {
             return "bg-gray-500";
     }
 }
-//# sourceMappingURL=http.js.map

package/dist/utils/icons.js

@@ -56,4 +56,3 @@ export function renderIcon(name) {
         return "";
     return `<svg class="card-icon" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor">${path}</svg>`;
 }
-//# sourceMappingURL=icons.js.map

package/dist/utils/lang-icons.js

@@ -84,4 +84,3 @@ export function langIconCSS() {
     }
     return rules.join("\n");
 }
-//# sourceMappingURL=lang-icons.js.map

package/dist/utils/markdown.js

@@ -77,4 +77,3 @@ export function renderMarkdownInline(input) {
         return "";
     return marked.parseInline(input, { async: false });
 }
-//# sourceMappingURL=markdown.js.map

package/dist/vite-plugin.js

@@ -95,4 +95,3 @@ export function sourceyPlugin(options) {
         },
     };
 }
-//# sourceMappingURL=vite-plugin.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sourcey",
-  "version": "3.3.5",
+  "version": "3.3.7",
   "description": "Open source documentation platform. API references, guides, static output.",
   "type": "module",
   "engines": {
@@ -69,10 +69,10 @@
   "license": "AGPL-3.0-only",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/sourcey/sourcey.git"
+    "url": "git+https://github.com/nilstate/sourcey.git"
   },
   "bugs": {
-    "url": "https://github.com/sourcey/sourcey/issues"
+    "url": "https://github.com/nilstate/sourcey/issues"
   },
-  "homepage": "https://github.com/sourcey/sourcey#readme"
+  "homepage": "https://github.com/nilstate/sourcey#readme"
 }