sourcey 2.0.2

package/dist/dev-server.js

@@ -0,0 +1,202 @@
+import { createServer as createViteServer } from "vite";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadConfig, hasNavigation, configFromSpec } from "./config.js";
+import { loadSpec } from "./core/loader.js";
+import { convertToOpenApi3 } from "./core/converter.js";
+import { parseSpec } from "./core/parser.js";
+import { normalizeSpec } from "./core/normalizer.js";
+import { buildNavFromSpec, buildNavFromPages, buildSiteNavigation, withActivePage } from "./core/navigation.js";
+import { loadMarkdownPage, slugFromPath } from "./core/markdown-loader.js";
+import { buildSearchIndex } from "./core/search-indexer.js";
+import { sourceyPlugin } from "./vite-plugin.js";
+import tailwindcss from "@tailwindcss/vite";
+import preact from "@preact/preset-vite";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Start a Vite-powered dev server for Sourcey.
+ *
+ * Uses Vite's ssrLoadModule() to render TSX components from source,
+ * so component changes are reflected instantly without a build step.
+ * CSS uses native Vite HMR. Spec/markdown changes trigger full reload.
+ */
+export async function startDevServer(options) {
+    const { specSource, port, logo, favicon } = options;
+    // Resolve config
+    let config = await loadConfig();
+    if (specSource && !hasNavigation(config)) {
+        config = configFromSpec(specSource, { logo, favicon });
+    }
+    else if (!hasNavigation(config) && !specSource) {
+        console.error("\nError: No spec file provided and no sourcey.json with navigation found.\n");
+        process.exit(1);
+    }
+    if (logo)
+        config.logo = logo;
+    if (favicon)
+        config.favicon = favicon;
+    const tabs = config.navigation;
+    // Collect watch paths
+    const watchPaths = [];
+    for (const tab of tabs) {
+        if (tab.spec)
+            watchPaths.push(resolve(tab.spec));
+        if (tab.groups) {
+            for (const group of tab.groups) {
+                for (const pagePath of group.pages) {
+                    watchPaths.push(resolve(pagePath));
+                }
+            }
+        }
+    }
+    // Resolve source paths for Vite dev serving
+    const projectRoot = resolve(__dirname, "..");
+    const tailwindCssPath = resolve(projectRoot, "src/themes/default/main.css");
+    const sourceyCssPath = resolve(projectRoot, "src/themes/default/sourcey.css");
+    const clientEntry = resolve(projectRoot, "src/client/index.ts");
+    // Path to the SSR entry point (source TSX, loaded via Vite)
+    const ssrRendererPath = resolve(projectRoot, "src/renderer/static-renderer.ts");
+    // We'll store the vite server reference so the render function can use ssrLoadModule
+    let vite;
+    // SSR render function: loads the renderer from source via Vite on every call
+    async function render(url) {
+        const configDir = process.cwd();
+        // Load the renderer module from source TSX via Vite's SSR transform
+        const { renderPage } = await vite.ssrLoadModule(ssrRendererPath);
+        // Build site data (specs, pages, navigation)
+        const { siteTabs, primarySpec, pageMap } = await loadSiteData(tabs, configDir, config);
+        const navigation = buildSiteNavigation(siteTabs);
+        // Normalise URL to match page keys
+        let pagePath = url.replace(/^\//, "").replace(/\/$/, "");
+        if (!pagePath || pagePath === "index.html") {
+            const firstKey = pageMap.keys().next().value;
+            if (!firstKey)
+                return null;
+            pagePath = firstKey;
+        }
+        if (!pagePath.endsWith(".html")) {
+            pagePath += "/index.html";
+        }
+        const pageData = pageMap.get(pagePath);
+        if (!pageData)
+            return null;
+        const activeNav = withActivePage(navigation, pageData.tabSlug, pageData.pageSlug);
+        const renderOptions = { embeddable: false, singleFile: false, assetBase: "/" };
+        let html = renderPage(pageData.spec, renderOptions, activeNav, pageData.currentPage);
+        // 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}" />`);
+        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>`);
+        return html;
+    }
+    const viteConfig = {
+        root: process.cwd(),
+        server: {
+            port,
+            strictPort: true,
+            hmr: true,
+        },
+        plugins: [
+            preact(),
+            tailwindcss(),
+            sourceyPlugin({
+                watchPaths,
+                render,
+                searchIndex: () => buildSearchIndexForDev(config),
+            }),
+        ],
+        clearScreen: false,
+        logLevel: "warn",
+        optimizeDeps: {
+            exclude: ["sourcey"],
+        },
+    };
+    vite = await createViteServer(viteConfig);
+    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`);
+}
+async function loadSiteData(tabs, configDir, config) {
+    const specsBySlug = new Map();
+    const siteTabs = [];
+    const pageMap = new Map();
+    for (const tabConfig of tabs) {
+        if (!tabConfig.spec)
+            continue;
+        const specPath = resolve(configDir, tabConfig.spec);
+        const loaded = await loadSpec(specPath);
+        const parsed = await parseSpec(loaded);
+        const openapi3 = await convertToOpenApi3(parsed);
+        const spec = normalizeSpec(openapi3);
+        if (config.logo)
+            spec.info.logo = config.logo;
+        if (config.favicon)
+            spec.info.favicon = config.favicon;
+        specsBySlug.set(tabConfig.slug, spec);
+    }
+    const primarySpec = specsBySlug.values().next().value ?? {
+        info: { title: "", version: "", description: "", logo: config.logo, favicon: config.favicon },
+        servers: [], tags: [], operations: [], schemas: {}, securitySchemes: {}, webhooks: [],
+    };
+    for (const tabConfig of tabs) {
+        if (tabConfig.spec) {
+            const spec = specsBySlug.get(tabConfig.slug);
+            const tab = buildNavFromSpec(spec, tabConfig.slug);
+            tab.label = tabConfig.label;
+            siteTabs.push(tab);
+            pageMap.set(`${tabConfig.slug}/index.html`, {
+                spec,
+                currentPage: { kind: "spec", spec },
+                tabSlug: tabConfig.slug,
+                pageSlug: "introduction",
+            });
+        }
+        else if (tabConfig.groups) {
+            const pagesByPath = new Map();
+            for (const group of tabConfig.groups) {
+                for (const pagePath of group.pages) {
+                    const fullPath = resolve(configDir, pagePath);
+                    const slug = slugFromPath(pagePath);
+                    const page = await loadMarkdownPage(fullPath, slug);
+                    pagesByPath.set(pagePath, page);
+                    pageMap.set(`${tabConfig.slug}/${slug}.html`, {
+                        spec: primarySpec,
+                        currentPage: { kind: "markdown", markdown: page },
+                        tabSlug: tabConfig.slug,
+                        pageSlug: slug,
+                    });
+                }
+            }
+            const tab = buildNavFromPages(tabConfig, pagesByPath);
+            siteTabs.push(tab);
+        }
+    }
+    return { siteTabs, primarySpec, pageMap };
+}
+async function buildSearchIndexForDev(config) {
+    const tabs = config.navigation;
+    const configDir = process.cwd();
+    const { siteTabs, pageMap } = await loadSiteData(tabs, configDir, config);
+    const navigation = buildSiteNavigation(siteTabs);
+    const specsBySlug = new Map();
+    const markdownPagesByTab = new Map();
+    for (const [, entry] of pageMap) {
+        if (entry.currentPage.kind === "spec") {
+            specsBySlug.set(entry.tabSlug, entry.spec);
+        }
+    }
+    for (const tabConfig of tabs) {
+        if (tabConfig.groups) {
+            const tabPages = [];
+            for (const [, entry] of pageMap) {
+                if (entry.tabSlug === tabConfig.slug && entry.currentPage.kind === "markdown") {
+                    tabPages.push(entry.currentPage.markdown);
+                }
+            }
+            markdownPagesByTab.set(tabConfig.slug, tabPages);
+        }
+    }
+    return buildSearchIndex(specsBySlug, markdownPagesByTab, navigation);
+}
+//# sourceMappingURL=dev-server.js.map

package/dist/dev-server.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import type { NormalizedSpec } from "./core/types.js";
+import type { SourceyConfig } from "./config.js";
+export interface ThemeOverrides {
+    /** CSS custom property overrides, e.g. { "--color-accent": "#e11d48" } */
+    [key: string]: string;
+}
+export interface BuildOptions {
+    /** Path or URL to the OpenAPI/Swagger spec file */
+    specSource: string;
+    /** Output directory (default: "dist") */
+    outputDir?: string;
+    /** Path to a custom logo file */
+    logo?: string;
+    /** Path to a custom favicon */
+    favicon?: string;
+    /** Generate embeddable output (no <html>/<body> wrapper) */
+    embeddable?: boolean;
+    /** Skip writing files to disk (useful for validation) */
+    skipWrite?: boolean;
+    /** CSS custom property overrides for theming */
+    themeOverrides?: ThemeOverrides;
+}
+export interface BuildResult {
+    /** The normalized spec that was processed */
+    spec: NormalizedSpec;
+    /** Output directory where files were written */
+    outputDir: string;
+    /** Number of pages generated */
+    pageCount: number;
+}
+/**
+ * Build API documentation from a single OpenAPI/Swagger spec.
+ * Wraps the spec in a single-tab site and renders through the modern layout.
+ */
+export declare function buildDocs(options: BuildOptions): Promise<BuildResult>;
+export interface SiteBuildOptions {
+    /** Path to directory containing sourcey.json (default: cwd) */
+    configDir?: string;
+    /** Output directory (default: "dist") */
+    outputDir?: string;
+    /** Pre-loaded config (skips loading from disk) */
+    config?: SourceyConfig;
+    /** Skip writing files to disk */
+    skipWrite?: boolean;
+    /** Generate embeddable output (no <html>/<body> wrapper) */
+    embeddable?: boolean;
+}
+export interface SiteBuildResult {
+    /** Output directory where files were written */
+    outputDir: string;
+    /** Number of pages generated */
+    pageCount: number;
+    /** @internal specs by tab slug, for buildDocs compat */
+    _specs?: Map<string, NormalizedSpec>;
+}
+/**
+ * Build a documentation site from a config.
+ * This is the single rendering path for all modes.
+ */
+export declare function buildSiteDocs(options?: SiteBuildOptions): Promise<SiteBuildResult>;
+export type { NormalizedSpec, NormalizedOperation, NormalizedTag, NormalizedSchema, NormalizedParameter, NormalizedRequestBody, NormalizedResponse, } from "./core/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAC;AAQhE,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAMD,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gDAAgD;IAChD,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,IAAI,EAAE,cAAc,CAAC;IACrB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAiB3E;AAMD,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwG5F;AAwBD,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,166 @@
+import { readFile } from "node:fs/promises";
+import { resolve, extname } from "node:path";
+import { loadSpec } from "./core/loader.js";
+import { convertToOpenApi3 } from "./core/converter.js";
+import { parseSpec } from "./core/parser.js";
+import { normalizeSpec } from "./core/normalizer.js";
+import { buildSite as buildSiteHtml } from "./renderer/html-builder.js";
+import { loadConfig, hasNavigation, configFromSpec } from "./config.js";
+import { loadMarkdownPage, slugFromPath } from "./core/markdown-loader.js";
+import { buildNavFromSpec, buildNavFromPages, buildSiteNavigation } from "./core/navigation.js";
+import { buildSearchIndex } from "./core/search-indexer.js";
+/**
+ * Build API documentation from a single OpenAPI/Swagger spec.
+ * Wraps the spec in a single-tab site and renders through the modern layout.
+ */
+export async function buildDocs(options) {
+    const config = configFromSpec(options.specSource, {
+        logo: options.logo,
+        favicon: options.favicon,
+    });
+    config.theme = options.themeOverrides;
+    const result = await buildSiteDocs({
+        config,
+        outputDir: options.outputDir,
+        skipWrite: options.skipWrite,
+        embeddable: options.embeddable,
+    });
+    // Find the spec that was loaded for backward compat
+    const spec = result._specs?.values().next().value ?? createMinimalSpec(config);
+    return { spec, outputDir: result.outputDir, pageCount: result.pageCount };
+}
+/**
+ * Build a documentation site from a config.
+ * This is the single rendering path for all modes.
+ */
+export async function buildSiteDocs(options = {}) {
+    const configDir = resolve(options.configDir ?? process.cwd());
+    const outputDir = resolve(options.outputDir ?? "dist");
+    // Load config from disk or use provided
+    const config = options.config ?? await loadConfig(configDir);
+    if (!hasNavigation(config)) {
+        throw new Error("No navigation config found. Provide a sourcey.json with navigation, or pass a spec file.");
+    }
+    const tabs = config.navigation;
+    const sitePages = [];
+    const siteTabs = [];
+    // Load all specs
+    const specsBySlug = new Map();
+    for (const tabConfig of tabs) {
+        if (!tabConfig.spec)
+            continue;
+        const specPath = resolve(configDir, tabConfig.spec);
+        const loaded = await loadSpec(specPath);
+        const parsed = await parseSpec(loaded);
+        const openapi3 = await convertToOpenApi3(parsed);
+        const spec = normalizeSpec(openapi3);
+        if (config.logo) {
+            spec.info.logo = await resolveAssetUrl(config.logo);
+        }
+        if (config.favicon) {
+            spec.info.favicon = config.favicon;
+        }
+        specsBySlug.set(tabConfig.slug, spec);
+    }
+    // Primary spec for SpecContext on markdown pages
+    const primarySpec = specsBySlug.values().next().value
+        ?? createMinimalSpec(config);
+    // Process all tabs, building pages and navigation
+    for (const tabConfig of tabs) {
+        if (tabConfig.spec) {
+            const spec = specsBySlug.get(tabConfig.slug);
+            const tab = buildNavFromSpec(spec, tabConfig.slug);
+            tab.label = tabConfig.label;
+            siteTabs.push(tab);
+            sitePages.push({
+                outputPath: `${tabConfig.slug}/index.html`,
+                currentPage: { kind: "spec", spec },
+                spec,
+                tabSlug: tabConfig.slug,
+                pageSlug: "introduction",
+            });
+        }
+        else if (tabConfig.groups) {
+            const pagesByPath = new Map();
+            for (const group of tabConfig.groups) {
+                for (const pagePath of group.pages) {
+                    const fullPath = resolve(configDir, pagePath);
+                    const slug = slugFromPath(pagePath);
+                    const page = await loadMarkdownPage(fullPath, slug);
+                    pagesByPath.set(pagePath, page);
+                    sitePages.push({
+                        outputPath: `${tabConfig.slug}/${slug}.html`,
+                        currentPage: { kind: "markdown", markdown: page },
+                        spec: primarySpec,
+                        tabSlug: tabConfig.slug,
+                        pageSlug: slug,
+                    });
+                }
+            }
+            const tab = buildNavFromPages(tabConfig, pagesByPath);
+            siteTabs.push(tab);
+        }
+    }
+    // Build navigation
+    const navigation = buildSiteNavigation(siteTabs);
+    // Build search index
+    const markdownPagesByTab = new Map();
+    for (const tabConfig of tabs) {
+        if (tabConfig.groups) {
+            const tabPages = sitePages
+                .filter((p) => p.tabSlug === tabConfig.slug && p.currentPage.kind === "markdown")
+                .map((p) => p.currentPage.markdown);
+            markdownPagesByTab.set(tabConfig.slug, tabPages);
+        }
+    }
+    const searchIndex = buildSearchIndex(specsBySlug, markdownPagesByTab, navigation);
+    // Render all pages
+    if (!options.skipWrite) {
+        await buildSiteHtml(sitePages, navigation, outputDir, {
+            themeOverrides: config.theme,
+            searchIndex,
+            embeddable: options.embeddable,
+        });
+    }
+    return { outputDir, pageCount: sitePages.length, _specs: specsBySlug };
+}
+/**
+ * Create a minimal NormalizedSpec for markdown-only sites.
+ */
+function createMinimalSpec(config) {
+    return {
+        info: {
+            title: "",
+            version: "",
+            description: "",
+            logo: config.logo,
+            favicon: config.favicon,
+        },
+        servers: [],
+        tags: [],
+        operations: [],
+        schemas: {},
+        securitySchemes: {},
+        webhooks: [],
+    };
+}
+const MIME_TYPES = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".webp": "image/webp",
+    ".ico": "image/x-icon",
+};
+async function resolveAssetUrl(pathOrUrl) {
+    if (pathOrUrl.startsWith("http://") || pathOrUrl.startsWith("https://") || pathOrUrl.startsWith("data:")) {
+        return pathOrUrl;
+    }
+    const abs = resolve(pathOrUrl);
+    const ext = extname(abs).toLowerCase();
+    const mime = MIME_TYPES[ext] ?? "application/octet-stream";
+    const data = await readFile(abs);
+    return `data:${mime};base64,${data.toString("base64")}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/renderer/context.d.ts

@@ -0,0 +1,46 @@
+import type { NormalizedSpec } from "../core/types.js";
+import type { SiteNavigation } from "../core/navigation.js";
+import type { MarkdownPage } from "../core/markdown-loader.js";
+/**
+ * Options that control rendering behavior.
+ */
+export interface RenderOptions {
+    /** Whether to generate embeddable output (no html/body wrapper) */
+    embeddable: boolean;
+    /** Whether to inline all assets into a single file */
+    singleFile: boolean;
+    /** Base URL for assets (CSS, JS) */
+    assetBase: string;
+}
+/**
+ * Full context available to all components during rendering.
+ */
+export interface RenderContext {
+    spec: NormalizedSpec;
+    options: RenderOptions;
+}
+/**
+ * What the current page is rendering.
+ */
+export interface CurrentPage {
+    kind: "spec" | "markdown";
+    spec?: NormalizedSpec;
+    markdown?: MarkdownPage;
+}
+/**
+ * Preact context for passing spec data to deeply nested components.
+ */
+export declare const SpecContext: import("preact").Context<NormalizedSpec>;
+/**
+ * Preact context for render options.
+ */
+export declare const OptionsContext: import("preact").Context<RenderOptions>;
+/**
+ * Preact context for site-wide navigation.
+ */
+export declare const NavigationContext: import("preact").Context<SiteNavigation>;
+/**
+ * Preact context for the current page being rendered.
+ */
+export declare const PageContext: import("preact").Context<CurrentPage>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +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;AAE/D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,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,yCAIzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,0CAA+C,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,WAAW,uCAA4C,CAAC"}

package/dist/renderer/context.js

@@ -0,0 +1,22 @@
+import { createContext } from "preact";
+/**
+ * Preact context for passing spec data to deeply nested components.
+ */
+export const SpecContext = createContext(null);
+/**
+ * Preact context for render options.
+ */
+export const OptionsContext = createContext({
+    embeddable: false,
+    singleFile: false,
+    assetBase: "",
+});
+/**
+ * Preact context for site-wide navigation.
+ */
+export const NavigationContext = createContext(null);
+/**
+ * Preact context for the current page being rendered.
+ */
+export const PageContext = createContext(null);
+//# sourceMappingURL=context.js.map

package/dist/renderer/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/renderer/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAkCvC;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAiB,IAAa,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAgB;IACzD,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,EAAE;CACd,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAiB,IAAa,CAAC,CAAC;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAc,IAAa,CAAC,CAAC"}

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

@@ -0,0 +1,37 @@
+import type { NormalizedSpec } from "../core/types.js";
+import type { RenderOptions, CurrentPage } from "./context.js";
+import type { SiteNavigation } from "../core/navigation.js";
+export interface HtmlBuildOptions extends Partial<RenderOptions> {
+    /** CSS custom property overrides, e.g. { "--color-accent": "#e11d48" } */
+    themeOverrides?: Record<string, string>;
+}
+export interface BuildOutput {
+    /** Path to the generated index.html */
+    htmlPath: string;
+    /** Output directory */
+    outputDir: string;
+}
+/**
+ * A single page to be rendered in a site.
+ */
+export interface SitePage {
+    /** Output path relative to site root, e.g. "guides/quickstart.html" */
+    outputPath: string;
+    /** What this page renders */
+    currentPage: CurrentPage;
+    /** The spec to provide via SpecContext (can be a stub for markdown-only pages) */
+    spec: NormalizedSpec;
+    /** Which tab this page belongs to */
+    tabSlug: string;
+    /** This page's unique slug for active-state matching */
+    pageSlug: string;
+}
+/**
+ * Build a documentation site.
+ * Renders each page as a standalone HTML file with shared navigation,
+ * plus shared CSS, JS, and search index.
+ */
+export declare function buildSite(pages: SitePage[], navigation: SiteNavigation, outputDir: string, options?: HtmlBuildOptions & {
+    searchIndex?: string;
+}): Promise<BuildOutput>;
+//# sourceMappingURL=html-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"html-builder.d.ts","sourceRoot":"","sources":["../../src/renderer/html-builder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,MAAM,WAAW,gBAAiB,SAAQ,OAAO,CAAC,aAAa,CAAC;IAC9D,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,kFAAkF;IAClF,IAAI,EAAE,cAAc,CAAC;IACrB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,gBAAgB,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAAC,WAAW,CAAC,CAyCtB"}