sourcey 3.4.10 → 3.5.0

package/dist/og/generate-og-image.js

@@ -0,0 +1,198 @@
+import satori from "satori";
+import { Resvg } from "@resvg/resvg-js";
+import { readFile } from "node:fs/promises";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// ---------------------------------------------------------------------------
+// Font loading (cached across all pages)
+// ---------------------------------------------------------------------------
+let fontsCache = null;
+async function loadFonts() {
+    if (fontsCache)
+        return fontsCache;
+    // Works from both src/ (dev) and dist/ (published)
+    const fontsDir = resolve(__dirname, "fonts");
+    const [regular, bold] = await Promise.all([
+        readFile(resolve(fontsDir, "Inter-Regular.ttf")),
+        readFile(resolve(fontsDir, "Inter-Bold.ttf")),
+    ]);
+    fontsCache = {
+        regular: regular.buffer.slice(regular.byteOffset, regular.byteOffset + regular.byteLength),
+        bold: bold.buffer.slice(bold.byteOffset, bold.byteOffset + bold.byteLength),
+    };
+    return fontsCache;
+}
+// ---------------------------------------------------------------------------
+// OG card template
+// ---------------------------------------------------------------------------
+function rgbCss(triplet) {
+    return `rgb(${triplet.replace(/ /g, ", ")})`;
+}
+function rgbaCss(triplet, alpha) {
+    return `rgba(${triplet.replace(/ /g, ", ")}, ${alpha})`;
+}
+function ogCard({ title, description, siteName, theme, logo }) {
+    const primary = rgbCss(theme.colors.primary);
+    const primaryGlow = rgbaCss(theme.colors.primary, 0.18);
+    const displayTitle = title.length > 90 ? title.slice(0, 87) + "..." : title;
+    const displayDesc = description
+        ? description.length > 160 ? description.slice(0, 157) + "..." : description
+        : undefined;
+    return {
+        type: "div",
+        props: {
+            style: {
+                display: "flex",
+                flexDirection: "column",
+                width: "100%",
+                height: "100%",
+                backgroundColor: "#0f172a",
+                padding: "72px",
+                fontFamily: "Inter",
+                backgroundImage: `radial-gradient(ellipse 70% 50% at 20% 70%, ${primaryGlow}, transparent 70%)`,
+            },
+            children: [
+                // Brand block: logo (or coloured mark) + site name, top-left
+                {
+                    type: "div",
+                    props: {
+                        style: { display: "flex", alignItems: "center", gap: "14px" },
+                        children: [
+                            logo
+                                ? {
+                                    type: "img",
+                                    props: {
+                                        src: logo,
+                                        width: 48,
+                                        height: 48,
+                                        style: { borderRadius: "8px" },
+                                    },
+                                }
+                                : {
+                                    type: "div",
+                                    props: {
+                                        style: {
+                                            width: "14px",
+                                            height: "14px",
+                                            backgroundColor: primary,
+                                            borderRadius: "4px",
+                                        },
+                                    },
+                                },
+                            ...(siteName
+                                ? [
+                                    {
+                                        type: "div",
+                                        props: {
+                                            style: {
+                                                fontSize: 28,
+                                                fontWeight: 700,
+                                                color: "#ffffff",
+                                                letterSpacing: "-0.02em",
+                                            },
+                                            children: siteName,
+                                        },
+                                    },
+                                ]
+                                : []),
+                        ],
+                    },
+                },
+                // Middle: vertical accent bar + title + description
+                {
+                    type: "div",
+                    props: {
+                        style: {
+                            display: "flex",
+                            flex: 1,
+                            alignItems: "center",
+                            marginTop: "48px",
+                        },
+                        children: [
+                            {
+                                type: "div",
+                                props: {
+                                    style: {
+                                        width: "4px",
+                                        alignSelf: "stretch",
+                                        backgroundColor: primary,
+                                        borderRadius: "2px",
+                                        marginRight: "32px",
+                                    },
+                                },
+                            },
+                            {
+                                type: "div",
+                                props: {
+                                    style: { display: "flex", flexDirection: "column", flex: 1 },
+                                    children: [
+                                        {
+                                            type: "div",
+                                            props: {
+                                                style: {
+                                                    fontSize: 64,
+                                                    fontWeight: 700,
+                                                    color: "#ffffff",
+                                                    lineHeight: 1.1,
+                                                    letterSpacing: "-0.02em",
+                                                    display: "-webkit-box",
+                                                    WebkitLineClamp: 2,
+                                                    WebkitBoxOrient: "vertical",
+                                                    overflow: "hidden",
+                                                },
+                                                children: displayTitle,
+                                            },
+                                        },
+                                        ...(displayDesc
+                                            ? [
+                                                {
+                                                    type: "div",
+                                                    props: {
+                                                        style: {
+                                                            fontSize: 26,
+                                                            fontWeight: 400,
+                                                            color: "#cbd5e1",
+                                                            marginTop: "24px",
+                                                            lineHeight: 1.4,
+                                                            letterSpacing: "-0.005em",
+                                                            display: "-webkit-box",
+                                                            WebkitLineClamp: 2,
+                                                            WebkitBoxOrient: "vertical",
+                                                            overflow: "hidden",
+                                                        },
+                                                        children: displayDesc,
+                                                    },
+                                                },
+                                            ]
+                                            : []),
+                                    ],
+                                },
+                            },
+                        ],
+                    },
+                },
+            ],
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export async function generateOgImage(options) {
+    const fonts = await loadFonts();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const svg = await satori(ogCard(options), {
+        width: 1200,
+        height: 630,
+        fonts: [
+            { name: "Inter", data: fonts.regular, weight: 400, style: "normal" },
+            { name: "Inter", data: fonts.bold, weight: 700, style: "normal" },
+        ],
+    });
+    const resvg = new Resvg(svg, {
+        fitTo: { mode: "width", value: 1200 },
+    });
+    const png = resvg.render();
+    return Buffer.from(png.asPng());
+}

package/dist/renderer/changelog-feed.d.ts

@@ -0,0 +1,18 @@
+import type { ChangelogPage } from "../core/markdown-loader.js";
+import type { NormalizedChangelogVersion } from "../core/types.js";
+export interface ChangelogFeedOptions {
+    atomPath: string;
+    rssPath: string;
+    pagePath: string;
+    buildDate?: Date;
+    siteName: string;
+    title?: string;
+    description?: string;
+    versionHref(version: NormalizedChangelogVersion): string;
+}
+export interface ChangelogFeedFiles {
+    atom: string;
+    rss: string;
+}
+export declare function generateChangelogFeeds(page: ChangelogPage, options: ChangelogFeedOptions): ChangelogFeedFiles;
+//# sourceMappingURL=changelog-feed.d.ts.map

package/dist/renderer/changelog-feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-feed.d.ts","sourceRoot":"","sources":["../../src/renderer/changelog-feed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAAC;CAC1D;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,kBAAkB,CAsEpB"}

package/dist/renderer/changelog-feed.js

@@ -0,0 +1,91 @@
+export function generateChangelogFeeds(page, options) {
+    const buildDate = options.buildDate ?? new Date();
+    const updated = page.changelog.versions
+        .map((version) => version.date ? new Date(`${version.date}T00:00:00Z`) : null)
+        .find(Boolean) ?? buildDate;
+    const title = options.title ?? [options.siteName, page.title].filter(Boolean).join(" ").trim();
+    const description = options.description ?? page.description ?? `${page.title} feed`;
+    const feedId = toFeedId(options.atomPath);
+    const atomEntries = page.changelog.versions.map((version) => {
+        const href = options.versionHref(version);
+        const content = renderVersionHtml(version);
+        const updatedAt = version.date ? new Date(`${version.date}T00:00:00Z`) : updated;
+        const label = version.version ?? "Unreleased";
+        return [
+            "  <entry>",
+            `    <title>${escapeXml(label)}</title>`,
+            `    <id>${escapeXml(toFeedId(href))}</id>`,
+            `    <link href="${escapeXml(href)}" />`,
+            `    <updated>${updatedAt.toISOString()}</updated>`,
+            `    <content type="html">${escapeXml(content)}</content>`,
+            "  </entry>",
+        ].join("\n");
+    }).join("\n");
+    const atom = [
+        `<?xml version="1.0" encoding="UTF-8"?>`,
+        `<feed xmlns="http://www.w3.org/2005/Atom">`,
+        `  <title>${escapeXml(title)}</title>`,
+        `  <id>${escapeXml(feedId)}</id>`,
+        `  <updated>${updated.toISOString()}</updated>`,
+        `  <subtitle>${escapeXml(description)}</subtitle>`,
+        `  <link rel="self" href="${escapeXml(options.atomPath)}" />`,
+        `  <link href="${escapeXml(options.pagePath)}" />`,
+        page.changelog.versions.length ? atomEntries : "",
+        `</feed>`,
+    ].filter(Boolean).join("\n");
+    const rssItems = page.changelog.versions.map((version) => {
+        const href = options.versionHref(version);
+        const label = version.version ?? "Unreleased";
+        const pubDate = version.date
+            ? new Date(`${version.date}T00:00:00Z`)
+            : updated;
+        return [
+            "    <item>",
+            `      <title>${escapeXml(label)}</title>`,
+            `      <link>${escapeXml(href)}</link>`,
+            `      <guid>${escapeXml(href)}</guid>`,
+            `      <pubDate>${pubDate.toUTCString()}</pubDate>`,
+            `      <description>${escapeXml(renderVersionHtml(version))}</description>`,
+            "    </item>",
+        ].join("\n");
+    }).join("\n");
+    const rss = [
+        `<?xml version="1.0" encoding="UTF-8"?>`,
+        `<rss version="2.0">`,
+        `  <channel>`,
+        `    <title>${escapeXml(title)}</title>`,
+        `    <link>${escapeXml(options.pagePath)}</link>`,
+        `    <description>${escapeXml(description)}</description>`,
+        page.changelog.versions.length ? rssItems : "",
+        `  </channel>`,
+        `</rss>`,
+    ].filter(Boolean).join("\n");
+    return { atom, rss };
+}
+function renderVersionHtml(version) {
+    const summary = version.summary ? `<p>${escapeHtml(version.summary)}</p>` : "";
+    const sections = version.sections.map((section) => {
+        const items = section.entries.map((entry) => `<li>${entry.html}</li>`).join("");
+        return `<section><h3>${escapeHtml(section.label)}</h3><ul>${items}</ul></section>`;
+    }).join("");
+    return `<article><h2>${escapeHtml(version.version ?? "Unreleased")}</h2>${summary}${sections}</article>`;
+}
+function escapeXml(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+function toFeedId(value) {
+    if (value.startsWith("http://") || value.startsWith("https://"))
+        return value;
+    return `urn:sourcey:${value.replace(/^\/+/, "").replace(/\//g, ":")}`;
+}

package/dist/renderer/context.d.ts

@@ -1,7 +1,12 @@
 import type { NormalizedSpec } from "../core/types.js";
 import type { SiteNavigation } from "../core/navigation.js";
-import type { MarkdownPage } from "../core/markdown-loader.js";
-import type { NavbarLink, ResolvedTheme } from "../config.js";
+import type { ChangelogPage, MarkdownPage } from "../core/markdown-loader.js";
+import type { NavbarLink, PrettyUrls, ResolvedChangelogConfig, ResolvedTheme } from "../config.js";
+export interface AlternateLink {
+    href: string;
+    type: string;
+    title?: string;
+}
 /**
  * Options that control rendering behavior.
  */
@@ -10,6 +15,12 @@ export interface RenderOptions {
     embeddable: boolean;
     /** Base URL for assets (CSS, JS) */
     assetBase: string;
+    /** Canonical absolute URL for the current page, when configured. */
+    pageUrl?: string;
+    /** Public URL for the OG image for this page. */
+    ogImageUrl?: string;
+    /** Alternate link tags to emit for the current page. */
+    alternateLinks?: AlternateLink[];
 }
 /**
  * Full context available to all components during rendering.
@@ -21,11 +32,16 @@ export interface RenderContext {
 /**
  * What the current page is rendering.
  */
-export interface CurrentPage {
-    kind: "spec" | "markdown";
-    spec?: NormalizedSpec;
-    markdown?: MarkdownPage;
-}
+export type CurrentPage = {
+    kind: "spec";
+    spec: NormalizedSpec;
+} | {
+    kind: "markdown";
+    markdown: MarkdownPage;
+} | {
+    kind: "changelog";
+    changelog: ChangelogPage;
+};
 /**
  * Preact context for passing spec data to deeply nested components.
  */
@@ -47,6 +63,9 @@ export declare const PageContext: import("preact").Context<CurrentPage>;
  */
 export interface SiteConfig {
     name: string;
+    siteUrl?: string;
+    baseUrl: string;
+    prettyUrls: PrettyUrls;
     theme: ResolvedTheme;
     logo?: {
         light?: string;
@@ -70,6 +89,7 @@ export interface SiteConfig {
         links: NavbarLink[];
     };
     customCSS?: string;
+    changelog: ResolvedChangelogConfig;
 }
 export declare const SiteContext: import("preact").Context<SiteConfig>;
 //# sourceMappingURL=context.d.ts.map

package/dist/renderer/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/renderer/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,0CAA+C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,cAAc,yCAGzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,0CAA+C,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,WAAW,uCAA4C,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE;QAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,QAAQ,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC3F,MAAM,EAAE;QAAE,KAAK,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,WAAW,sCAA2C,CAAC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/renderer/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEnG,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,aAAa,CAAA;CAAE,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,WAAW,0CAA+C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,cAAc,yCAGzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,0CAA+C,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,WAAW,uCAA4C,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE;QAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,QAAQ,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC3F,MAAM,EAAE;QAAE,KAAK,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,uBAAuB,CAAC;CACpC;AAED,eAAO,MAAM,WAAW,sCAA2C,CAAC"}

package/dist/renderer/html-builder.d.ts

@@ -1,5 +1,5 @@
 import type { NormalizedSpec } from "../core/types.js";
-import type { CurrentPage, SiteConfig } from "./context.js";
+import type { AlternateLink, RenderOptions, CurrentPage, SiteConfig } from "./context.js";
 import type { SiteNavigation } from "../core/navigation.js";
 export interface BuildOutput {
     htmlPath: string;
@@ -11,7 +11,14 @@ export interface SitePage {
     spec: NormalizedSpec;
     tabSlug: string;
     pageSlug: string;
+    /** Relative path to the generated OG image (set during build) */
+    ogImagePath?: string;
+    alternateLinks?: AlternateLink[];
 }
+export declare function createRenderOptions(page: SitePage, site: SiteConfig, options?: {
+    embeddable?: boolean;
+    assetBase?: string;
+}): RenderOptions;
 /**
  * Build a documentation site.
  */
@@ -20,5 +27,7 @@ export declare function buildSite(pages: SitePage[], navigation: SiteNavigation,
     searchIndex?: string;
     llmsTxt?: string;
     llmsFullTxt?: string;
+    ogImages?: Map<string, Buffer>;
+    extraFiles?: Map<string, string | Buffer>;
 }): Promise<BuildOutput>;
 //# sourceMappingURL=html-builder.d.ts.map

package/dist/renderer/html-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-builder.d.ts","sourceRoot":"","sources":["../../src/renderer/html-builder.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAiB,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA0B5D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/F,OAAO,CAAC,WAAW,CAAC,CAuDtB"}
+{"version":3,"file":"html-builder.d.ts","sourceRoot":"","sources":["../../src/renderer/html-builder.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA2B5D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,aAAa,CAcf;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC3C,GACA,OAAO,CAAC,WAAW,CAAC,CA8EtB"}

package/dist/renderer/html-builder.js

@@ -6,6 +6,7 @@ import tailwindcss from "@tailwindcss/vite";
 import preact from "@preact/preset-vite";
 import { renderPage } from "./static-renderer.js";
 import { withActivePage } from "../core/navigation.js";
+import { isAbsoluteHttpUrl, toAbsoluteUrl, toPublicPath } from "../site-url.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const projectRoot = resolve(__dirname, "../..");
 async function exists(path) {
@@ -30,6 +31,20 @@ async function resolveAssetPaths() {
     const sourceyCssPath = await exists(srcCss) ? srcCss : distCss;
     return { clientEntry, sourceyCssPath };
 }
+export function createRenderOptions(page, site, options) {
+    const assetBase = options?.assetBase ?? "";
+    const pagePublicPath = toPublicPath(page.outputPath, site.baseUrl, site.prettyUrls);
+    return {
+        embeddable: options?.embeddable ?? false,
+        assetBase,
+        pageUrl: site.siteUrl ? toAbsoluteUrl(pagePublicPath, site.siteUrl) : undefined,
+        ogImageUrl: page.ogImagePath ? resolveRenderHref(page.ogImagePath, assetBase, site) : undefined,
+        alternateLinks: page.alternateLinks?.map((link) => ({
+            ...link,
+            href: resolveRenderHref(link.href, assetBase, site),
+        })),
+    };
+}
 /**
  * Build a documentation site.
  */
@@ -42,10 +57,10 @@ export async function buildSite(pages, navigation, outputDir, site, options) {
         await mkdir(pageDir, { recursive: true });
         const depth = page.outputPath.split("/").length - 1;
         const assetBase = depth > 0 ? "../".repeat(depth) : "";
-        const renderOptions = {
-            embeddable: options?.embeddable ?? false,
+        const renderOptions = createRenderOptions(page, site, {
+            embeddable: options?.embeddable,
             assetBase,
-        };
+        });
         const activeNav = withActivePage(navigation, page.tabSlug, page.pageSlug);
         const html = renderPage(page.spec, renderOptions, activeNav, page.currentPage, site);
         await writeFile(resolve(resolvedDir, page.outputPath), html, "utf-8");
@@ -53,7 +68,10 @@ export async function buildSite(pages, navigation, outputDir, site, options) {
     if (pages.length > 0 && pages[0].outputPath !== "index.html") {
         const first = pages[0];
         const activeNav = withActivePage(navigation, first.tabSlug, first.pageSlug);
-        const renderOptions = { embeddable: options?.embeddable ?? false, assetBase: "" };
+        const renderOptions = createRenderOptions(first, site, {
+            embeddable: options?.embeddable,
+            assetBase: "",
+        });
         const html = renderPage(first.spec, renderOptions, activeNav, first.currentPage, site);
         await writeFile(resolve(resolvedDir, "index.html"), html, "utf-8");
     }
@@ -67,7 +85,11 @@ export async function buildSite(pages, navigation, outputDir, site, options) {
     if (options?.llmsFullTxt) {
         await writeFile(resolve(resolvedDir, "llms-full.txt"), options.llmsFullTxt, "utf-8");
     }
-    const urls = pages.map(p => `  <url><loc>${p.outputPath}</loc></url>`);
+    const urls = pages.map((page) => {
+        const publicPath = toPublicPath(page.outputPath, site.baseUrl, site.prettyUrls);
+        const loc = site.siteUrl ? toAbsoluteUrl(publicPath, site.siteUrl) : publicPath;
+        return `  <url><loc>${loc}</loc></url>`;
+    });
     const sitemap = [
         `<?xml version="1.0" encoding="UTF-8"?>`,
         `<!-- Generated by Sourcey https://sourcey.com -->`,
@@ -76,8 +98,39 @@ export async function buildSite(pages, navigation, outputDir, site, options) {
         `</urlset>`,
     ].join("\n");
     await writeFile(resolve(resolvedDir, "sitemap.xml"), sitemap, "utf-8");
+    // Write generated OG images
+    if (options?.ogImages) {
+        for (const [path, data] of options.ogImages) {
+            const fullPath = resolve(resolvedDir, path);
+            await mkdir(dirname(fullPath), { recursive: true });
+            await writeFile(fullPath, data);
+        }
+    }
+    if (options?.extraFiles) {
+        for (const [path, data] of options.extraFiles) {
+            const fullPath = resolve(resolvedDir, path);
+            await mkdir(dirname(fullPath), { recursive: true });
+            await writeFile(fullPath, data);
+        }
+    }
     return { htmlPath: resolve(resolvedDir, "index.html"), outputDir: resolvedDir };
 }
+function resolveRenderHref(pathOrUrl, assetBase, site) {
+    if (!pathOrUrl ||
+        pathOrUrl.startsWith("#") ||
+        pathOrUrl.startsWith("mailto:") ||
+        pathOrUrl.startsWith("data:") ||
+        isAbsoluteHttpUrl(pathOrUrl)) {
+        return pathOrUrl;
+    }
+    if (site.siteUrl) {
+        return toAbsoluteUrl(toPublicPath(pathOrUrl, site.baseUrl), site.siteUrl);
+    }
+    if (site.baseUrl) {
+        return toPublicPath(pathOrUrl, site.baseUrl);
+    }
+    return `${assetBase}${pathOrUrl}`;
+}
 /**
  * Build client JS + Tailwind CSS via Vite.
  * Same plugins as the dev server — preact() + tailwindcss().

package/dist/renderer/llms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llms.d.ts","sourceRoot":"","sources":["../../src/renderer/llms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,UAAU,GACf,MAAM,CA4CR;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,UAAU,GACf,MAAM,CA8BR"}
+{"version":3,"file":"llms.d.ts","sourceRoot":"","sources":["../../src/renderer/llms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,UAAU,GACf,MAAM,CAyDR;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,UAAU,GACf,MAAM,CAgCR"}