xhs-md-renderer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xxih
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# xhs-md-renderer
+
+Render Markdown into Xiaohongshu-friendly image pages from the command line.
+
+## Install
+
+```bash
+npm install -g xhs-md-renderer
+```
+
+Or run it on demand:
+
+```bash
+npx xhs-md-renderer --input ./note.md --output ./.xhs-output
+```
+
+## Usage
+
+```bash
+xhs-md-renderer --input ./note.md --output ./.xhs-output
+```
+
+Common options:
+
+- `--renderer auto|node|browser`
+- `--title "My Note"`
+- `--theme paper`
+- `--font-family "PingFang SC, sans-serif"`
+- `--font-size 16`
+- `--config-dir ./.xhs-md-renderer`
+
+## Config Directory
+
+The CLI looks for a project config directory named `.xhs-md-renderer` in this order:
+
+1. `--config-dir <path>`
+2. Search upward from the input Markdown file directory
+3. Built-in defaults
+
+Supported files inside the config directory:
+
+- `render.json`
+- `avatar.png|jpg|jpeg|webp|gif`
+
+## Notes
+
+- The Node renderer works best when the machine has usable CJK fonts installed.
+- The browser renderer needs a local Chromium-based browser.
+- Every export writes `manifest.json`, `pages.json`, and `layout-report.json`.

package/bin/xhs-md-render.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import "../dist/index.js";

package/dist/browser-renderer.d.ts

@@ -0,0 +1,8 @@
+import type { ExportBundle, RenderConfigOverrides } from "./vendor/core/index.js";
+export declare function writeBrowserExportBundle(input: {
+    markdown: string;
+    title?: string;
+    outputDir: string;
+    renderConfig?: RenderConfigOverrides;
+    markdownFilePath?: string;
+}): Promise<ExportBundle>;

package/dist/browser-renderer.js

@@ -0,0 +1,156 @@
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { createServer } from "node:http";
+import { extname, join, normalize, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { chromium } from "playwright-core";
+import { prepareExportDocument } from "./vendor/core/node.js";
+const WEB_DIST_CANDIDATES = [
+    fileURLToPath(new URL("../web-dist", import.meta.url)),
+    fileURLToPath(new URL("../../../apps/web/dist", import.meta.url))
+];
+const DEFAULT_BROWSER_PATHS = [
+    process.env.XHS_MD_BROWSER_EXECUTABLE_PATH,
+    process.env.CHROME_PATH,
+    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+    "/Applications/Chromium.app/Contents/MacOS/Chromium",
+    "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+    "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
+    "/usr/bin/google-chrome",
+    "/usr/bin/google-chrome-stable",
+    "/usr/bin/chromium-browser",
+    "/usr/bin/chromium"
+];
+const MIME_TYPES = {
+    ".css": "text/css; charset=utf-8",
+    ".html": "text/html; charset=utf-8",
+    ".ico": "image/x-icon",
+    ".js": "text/javascript; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".png": "image/png",
+    ".svg": "image/svg+xml; charset=utf-8"
+};
+async function isFile(targetPath) {
+    try {
+        return (await stat(targetPath)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function resolveBrowserExecutablePath() {
+    for (const browserPath of DEFAULT_BROWSER_PATHS) {
+        if (!browserPath) {
+            continue;
+        }
+        if (await isFile(browserPath)) {
+            return browserPath;
+        }
+    }
+    throw new Error("No supported local Chromium browser found. Set XHS_MD_BROWSER_EXECUTABLE_PATH or install Chrome, Chromium, Edge, or Brave.");
+}
+async function ensureWebDistDir() {
+    for (const rootDir of WEB_DIST_CANDIDATES) {
+        const distIndexPath = join(rootDir, "index.html");
+        if (await isFile(distIndexPath)) {
+            return rootDir;
+        }
+    }
+    throw new Error(`Web dist not found. Expected one of: ${WEB_DIST_CANDIDATES.join(", ")}. Run npm run build first.`);
+}
+async function startStaticServer(rootDir) {
+    const server = createServer(async (request, response) => {
+        const requestUrl = new URL(request.url ?? "/", "http://127.0.0.1");
+        const pathname = requestUrl.pathname === "/" ? "/index.html" : requestUrl.pathname;
+        const candidatePath = normalize(join(rootDir, pathname));
+        const safePath = candidatePath.startsWith(rootDir) ? candidatePath : join(rootDir, "index.html");
+        const filePath = (await isFile(safePath)) ? safePath : join(rootDir, "index.html");
+        try {
+            const fileBuffer = await readFile(filePath);
+            response.writeHead(200, {
+                "Content-Type": MIME_TYPES[extname(filePath)] ?? "application/octet-stream",
+                "Cache-Control": "no-store"
+            });
+            response.end(fileBuffer);
+        }
+        catch {
+            response.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
+            response.end("Not found");
+        }
+    });
+    await new Promise((resolvePromise, rejectPromise) => {
+        server.once("error", rejectPromise);
+        server.listen(0, "127.0.0.1", () => resolvePromise());
+    });
+    const address = server.address();
+    if (!address || typeof address === "string") {
+        throw new Error("Unable to resolve local preview server address.");
+    }
+    return {
+        origin: `http://127.0.0.1:${address.port}`,
+        close: async () => {
+            await new Promise((resolvePromise, rejectPromise) => {
+                server.close((error) => (error ? rejectPromise(error) : resolvePromise()));
+            });
+        }
+    };
+}
+export async function writeBrowserExportBundle(input) {
+    const rootDir = await ensureWebDistDir();
+    const prepared = await prepareExportDocument(input);
+    const outputDir = resolve(input.outputDir);
+    const pagesDir = join(outputDir, "pages");
+    const browserExecutablePath = await resolveBrowserExecutablePath();
+    const server = await startStaticServer(rootDir);
+    let browser;
+    try {
+        browser = await chromium.launch({
+            executablePath: browserExecutablePath,
+            headless: true
+        });
+        const page = await browser.newPage({
+            viewport: {
+                width: Math.min(prepared.config.width, 1600),
+                height: Math.min(prepared.config.height, 1200)
+            },
+            deviceScaleFactor: 1
+        });
+        await page.addInitScript((payload) => {
+            window.__XHS_RENDER_PAYLOAD__ =
+                payload;
+        }, prepared);
+        await page.goto(`${server.origin}/?mode=render`, {
+            waitUntil: "networkidle"
+        });
+        await page.waitForFunction(() => window.__XHS_RENDER_STATUS__?.ready === true);
+        await mkdir(pagesDir, { recursive: true });
+        await writeFile(join(outputDir, "manifest.json"), JSON.stringify(prepared.manifest, null, 2), "utf8");
+        await writeFile(join(outputDir, "layout-report.json"), JSON.stringify(prepared.layoutReport, null, 2), "utf8");
+        await writeFile(join(outputDir, "pages.json"), JSON.stringify(prepared.pages, null, 2), "utf8");
+        const bundlePages = [];
+        for (const manifestPage of prepared.manifest.pages) {
+            const locator = page.locator(`[data-export-page="${manifestPage.id}"]`);
+            const png = await locator.screenshot({
+                type: "png"
+            });
+            const outputFilePath = join(pagesDir, manifestPage.fileName);
+            await writeFile(outputFilePath, png);
+            bundlePages.push({
+                model: prepared.pages[manifestPage.index],
+                fileName: manifestPage.fileName,
+                png
+            });
+        }
+        return {
+            manifest: prepared.manifest,
+            layoutReport: prepared.layoutReport,
+            pages: bundlePages
+        };
+    }
+    finally {
+        if (browser) {
+            await browser.close();
+        }
+        await server.close();
+    }
+}
+//# sourceMappingURL=browser-renderer.js.map

package/dist/browser-renderer.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,418 @@
+#!/usr/bin/env node
+import { readFile, stat } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { writeExportBundle } from "./vendor/core/node.js";
+import { writeBrowserExportBundle } from "./browser-renderer.js";
+const DEFAULT_CONFIG_DIR_NAME = ".xhs-md-renderer";
+const DEFAULT_CONFIG_FILE_NAME = "render.json";
+const DEFAULT_AVATAR_FILE_NAMES = [
+    "avatar.png",
+    "avatar.jpg",
+    "avatar.jpeg",
+    "avatar.webp",
+    "avatar.gif"
+];
+function printHelp() {
+    console.log(`
+xhs-md-render
+
+Usage:
+  xhs-md-render --input <file.md> --output <dir> [--config-dir ./.xhs-md-renderer]
+    [--renderer auto|node|browser]
+    [--title "My Note"] [--theme default]
+    [--font-family "..."] [--font-size 16]
+    [--name "小明"] [--handle "@xiaoming"]
+    [--date "2026/03/16"] [--hide-date]
+    [--footer-left "左侧文案"] [--footer-right "右侧文案"] [--hide-footer]
+    [--avatar ./avatar.png]
+    [--body-bottom-padding 180] [--warning-threshold 180]
+
+Default config discovery:
+  1. If --config-dir is provided, read that directory.
+  2. Otherwise search upward from the input Markdown directory for .xhs-md-renderer/.
+  3. If found, read .xhs-md-renderer/render.json and optional avatar.* files.
+`.trim());
+}
+function parseNumericFlag(raw, flagName) {
+    if (raw === undefined) {
+        return undefined;
+    }
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`${flagName} must be a number.`);
+    }
+    return parsed;
+}
+function parseCliOptions(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            input: { type: "string", short: "i" },
+            output: { type: "string", short: "o" },
+            renderer: { type: "string" },
+            title: { type: "string", short: "t" },
+            theme: { type: "string" },
+            "font-family": { type: "string" },
+            "font-size": { type: "string" },
+            name: { type: "string" },
+            handle: { type: "string" },
+            date: { type: "string" },
+            "hide-date": { type: "boolean" },
+            "hide-footer": { type: "boolean" },
+            "footer-left": { type: "string" },
+            "footer-right": { type: "string" },
+            "config-dir": { type: "string" },
+            avatar: { type: "string" },
+            "body-bottom-padding": { type: "string" },
+            "warning-threshold": { type: "string" },
+            help: { type: "boolean", short: "h" }
+        },
+        allowPositionals: false
+    });
+    if (values.help) {
+        printHelp();
+        process.exit(0);
+    }
+    if (!values.input || !values.output) {
+        printHelp();
+        throw new Error("Both --input and --output are required.");
+    }
+    const options = {
+        input: values.input,
+        output: values.output
+    };
+    if (values.renderer !== undefined) {
+        if (values.renderer !== "auto" && values.renderer !== "browser" && values.renderer !== "node") {
+            throw new Error("--renderer must be one of: auto, browser, node.");
+        }
+        options.renderer = values.renderer;
+    }
+    if (values.title !== undefined) {
+        options.title = values.title;
+    }
+    if (values.theme !== undefined) {
+        options.themeId = values.theme;
+    }
+    if (values["font-family"] !== undefined) {
+        options.fontFamily = values["font-family"];
+    }
+    const fontSize = parseNumericFlag(values["font-size"], "--font-size");
+    const bodyBottomPadding = parseNumericFlag(values["body-bottom-padding"], "--body-bottom-padding");
+    const warningThreshold = parseNumericFlag(values["warning-threshold"], "--warning-threshold");
+    if (fontSize !== undefined) {
+        options.fontSize = fontSize;
+    }
+    if (bodyBottomPadding !== undefined) {
+        options.bodyBottomPadding = bodyBottomPadding;
+    }
+    if (warningThreshold !== undefined) {
+        options.warningThreshold = warningThreshold;
+    }
+    if (values.name !== undefined) {
+        options.name = values.name;
+    }
+    if (values.handle !== undefined) {
+        options.handle = values.handle;
+    }
+    if (values.date !== undefined) {
+        options.dateText = values.date;
+        options.showDate = true;
+    }
+    if (values["hide-date"]) {
+        options.showDate = false;
+    }
+    if (values["footer-left"] !== undefined) {
+        options.footerLeft = values["footer-left"];
+    }
+    if (values["footer-right"] !== undefined) {
+        options.footerRight = values["footer-right"];
+    }
+    if (values["hide-footer"]) {
+        options.showFooter = false;
+    }
+    if (values["config-dir"] !== undefined) {
+        options.configDir = values["config-dir"];
+    }
+    if (values.avatar !== undefined) {
+        options.avatarPath = values.avatar;
+    }
+    return options;
+}
+async function isDirectory(targetPath) {
+    try {
+        return (await stat(targetPath)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function isFile(targetPath) {
+    try {
+        return (await stat(targetPath)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function discoverConfigDir(inputPath, explicitConfigDir) {
+    if (explicitConfigDir) {
+        const resolvedConfigDir = resolve(explicitConfigDir);
+        if (!(await isDirectory(resolvedConfigDir))) {
+            throw new Error(`Config directory not found: ${resolvedConfigDir}`);
+        }
+        return resolvedConfigDir;
+    }
+    let currentDir = dirname(inputPath);
+    while (true) {
+        const candidate = join(currentDir, DEFAULT_CONFIG_DIR_NAME);
+        if (await isDirectory(candidate)) {
+            return candidate;
+        }
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir) {
+            return undefined;
+        }
+        currentDir = parentDir;
+    }
+}
+async function readConfigFile(configDir) {
+    if (!configDir) {
+        return { config: {} };
+    }
+    const configFilePath = join(configDir, DEFAULT_CONFIG_FILE_NAME);
+    if (!(await isFile(configFilePath))) {
+        return {
+            configFilePath,
+            config: {}
+        };
+    }
+    const raw = await readFile(configFilePath, "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`Invalid config file: ${configFilePath}`);
+    }
+    return {
+        configFilePath,
+        config: parsed
+    };
+}
+function mergeRenderConfigOverrides(base = {}, override = {}) {
+    const mergedProfile = {
+        ...(base.profile ?? {}),
+        ...(override.profile ?? {})
+    };
+    const mergedLayout = {
+        ...(base.layout ?? {}),
+        ...(override.layout ?? {})
+    };
+    return {
+        ...base,
+        ...override,
+        ...(Object.keys(mergedProfile).length === 0 ? {} : { profile: mergedProfile }),
+        ...(Object.keys(mergedLayout).length === 0 ? {} : { layout: mergedLayout })
+    };
+}
+function buildCliRenderConfig(options) {
+    const profile = {
+        ...(options.name === undefined ? {} : { name: options.name }),
+        ...(options.handle === undefined ? {} : { handle: options.handle }),
+        ...(options.showDate === undefined ? {} : { showDate: options.showDate }),
+        ...(options.dateText === undefined ? {} : { dateText: options.dateText }),
+        ...(options.showFooter === undefined ? {} : { showFooter: options.showFooter }),
+        ...(options.footerLeft === undefined ? {} : { footerLeft: options.footerLeft }),
+        ...(options.footerRight === undefined ? {} : { footerRight: options.footerRight })
+    };
+    const layout = {
+        ...(options.bodyBottomPadding === undefined
+            ? {}
+            : { bodyBottomPadding: options.bodyBottomPadding }),
+        ...(options.warningThreshold === undefined
+            ? {}
+            : { warningThreshold: options.warningThreshold })
+    };
+    return {
+        ...(options.themeId === undefined ? {} : { themeId: options.themeId }),
+        ...(options.fontFamily === undefined ? {} : { fontFamily: options.fontFamily }),
+        ...(options.fontSize === undefined ? {} : { fontSize: options.fontSize }),
+        ...(Object.keys(profile).length === 0 ? {} : { profile }),
+        ...(Object.keys(layout).length === 0 ? {} : { layout })
+    };
+}
+function toMimeType(filePath) {
+    const lowerPath = filePath.toLowerCase();
+    if (lowerPath.endsWith(".png")) {
+        return "image/png";
+    }
+    if (lowerPath.endsWith(".jpg") || lowerPath.endsWith(".jpeg")) {
+        return "image/jpeg";
+    }
+    if (lowerPath.endsWith(".webp")) {
+        return "image/webp";
+    }
+    if (lowerPath.endsWith(".gif")) {
+        return "image/gif";
+    }
+    throw new Error(`Unsupported avatar file type: ${filePath}`);
+}
+async function readAvatarAsDataUrl(filePath) {
+    const avatarBuffer = await readFile(filePath);
+    return `data:${toMimeType(filePath)};base64,${avatarBuffer.toString("base64")}`;
+}
+async function detectDefaultAvatarPath(configDir) {
+    for (const fileName of DEFAULT_AVATAR_FILE_NAMES) {
+        const candidate = join(configDir, fileName);
+        if (await isFile(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+async function resolveAvatarOverride(input) {
+    if (input.cliAvatarPath) {
+        const resolvedAvatarPath = resolve(input.cliAvatarPath);
+        if (!(await isFile(resolvedAvatarPath))) {
+            throw new Error(`Avatar file not found: ${resolvedAvatarPath}`);
+        }
+        return {
+            avatarSrc: await readAvatarAsDataUrl(resolvedAvatarPath),
+            avatarSourcePath: resolvedAvatarPath
+        };
+    }
+    if (!input.configDir) {
+        return {};
+    }
+    if (input.fileProfile?.avatarPath) {
+        const resolvedAvatarPath = resolve(input.configDir, input.fileProfile.avatarPath);
+        if (!(await isFile(resolvedAvatarPath))) {
+            throw new Error(`Avatar file not found: ${resolvedAvatarPath}`);
+        }
+        return {
+            avatarSrc: await readAvatarAsDataUrl(resolvedAvatarPath),
+            avatarSourcePath: resolvedAvatarPath
+        };
+    }
+    const defaultAvatarPath = await detectDefaultAvatarPath(input.configDir);
+    if (!defaultAvatarPath) {
+        return {};
+    }
+    return {
+        avatarSrc: await readAvatarAsDataUrl(defaultAvatarPath),
+        avatarSourcePath: defaultAvatarPath
+    };
+}
+function stripProfileFileOnlyFields(profile) {
+    if (!profile) {
+        return undefined;
+    }
+    const { avatarPath: _avatarPath, ...profileConfig } = profile;
+    return profileConfig;
+}
+function printLayoutSummary(layoutReport) {
+    console.log("Layout feedback:");
+    for (const page of layoutReport.pages) {
+        if (page.status === "overflow") {
+            console.log(`  - Page ${page.pageNumber} [overflow] exceeded safe area by ${page.overflowAmount}px. ${page.recommendation}`);
+            continue;
+        }
+        if (page.status === "warning") {
+            console.log(`  - Page ${page.pageNumber} [warning] remaining bottom space ${page.remainingBottomSpace}px, below warning threshold ${page.warningThreshold}px. ${page.recommendation}`);
+            continue;
+        }
+        console.log(`  - Page ${page.pageNumber} [ok] remaining bottom space ${page.remainingBottomSpace}px.`);
+    }
+}
+function shouldFallbackToBrowser(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    return error.message.includes("Unsupported OpenType signature ttcf");
+}
+async function main() {
+    const options = parseCliOptions(process.argv.slice(2));
+    const inputPath = resolve(options.input);
+    const outputPath = resolve(options.output);
+    const markdown = await readFile(inputPath, "utf8");
+    const configDir = await discoverConfigDir(inputPath, options.configDir);
+    const { configFilePath, config } = await readConfigFile(configDir);
+    const strippedProfile = stripProfileFileOnlyFields(config.renderConfig?.profile);
+    const fileRenderConfig = {
+        ...(config.renderConfig ?? {}),
+        ...(strippedProfile === undefined ? {} : { profile: strippedProfile })
+    };
+    const avatarResolveInput = {};
+    if (options.avatarPath !== undefined) {
+        avatarResolveInput.cliAvatarPath = options.avatarPath;
+    }
+    if (configDir !== undefined) {
+        avatarResolveInput.configDir = configDir;
+    }
+    if (config.renderConfig?.profile !== undefined) {
+        avatarResolveInput.fileProfile = config.renderConfig.profile;
+    }
+    const avatarOverride = await resolveAvatarOverride(avatarResolveInput);
+    const mergedRenderConfig = mergeRenderConfigOverrides(fileRenderConfig, buildCliRenderConfig(options));
+    if (avatarOverride.avatarSrc) {
+        mergedRenderConfig.profile = {
+            ...(mergedRenderConfig.profile ?? {}),
+            avatarSrc: avatarOverride.avatarSrc
+        };
+    }
+    const exportInput = {
+        markdown,
+        markdownFilePath: inputPath,
+        outputDir: outputPath,
+        renderConfig: mergedRenderConfig
+    };
+    const resolvedTitle = options.title ?? config.title;
+    if (resolvedTitle !== undefined) {
+        exportInput.title = resolvedTitle;
+    }
+    let bundle;
+    let rendererUsed;
+    if (options.renderer === "browser") {
+        bundle = await writeBrowserExportBundle(exportInput);
+        rendererUsed = "browser";
+    }
+    else if (options.renderer === "node") {
+        bundle = await writeExportBundle(exportInput);
+        rendererUsed = "node";
+    }
+    else {
+        try {
+            bundle = await writeExportBundle(exportInput);
+            rendererUsed = "node";
+        }
+        catch (error) {
+            if (!shouldFallbackToBrowser(error)) {
+                throw error;
+            }
+            console.warn("Node renderer does not support the requested TTC font. Falling back to browser renderer.");
+            bundle = await writeBrowserExportBundle(exportInput);
+            rendererUsed = "browser";
+        }
+    }
+    if (configDir) {
+        console.log(`Config directory: ${configDir}`);
+    }
+    else {
+        console.log(`Config directory: not found (searched upward from ${dirname(inputPath)} for ${DEFAULT_CONFIG_DIR_NAME})`);
+    }
+    if (configFilePath && (await isFile(configFilePath))) {
+        console.log(`Config file: ${configFilePath}`);
+    }
+    if (avatarOverride.avatarSourcePath) {
+        console.log(`Avatar source: ${avatarOverride.avatarSourcePath}`);
+    }
+    console.log(`Renderer: ${rendererUsed}`);
+    printLayoutSummary(bundle.layoutReport);
+    console.log(`Rendered ${bundle.pages.length} pages.`);
+    console.log(`Output: ${outputPath}`);
+    console.log(`Layout report: ${join(outputPath, "layout-report.json")}`);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(message);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map