\n \n \n \n);\n\n// --- Pages ------------------------------------------------------------\n\nconst indexMd = `---\ntitle: Home\n---\n# Welcome to My Site\n\nThis is a static site generated from **markdown** using \\`vt-ssg\\`.\n\nEach page is a markdown string with YAML frontmatter, rendered through a\nshared Hono JSX layout, and written as a static HTML file into this val.\n`;\n\nconst aboutMd = `---\ntitle: About\n---\n# About\n\nThis site demonstrates the **markdown-first** pattern of \\`vt-ssg\\`:\n\n1. Define your pages as markdown strings (or read them from files/blobs)\n2. Pass them to \\`renderToFiles()\\` with a shared layout\n3. The output HTML files are written into the val via the API\n4. Serve them with \\`staticHTTPServer()\\`\n`;\n\nconst blogPostMd = `---\ntitle: Hello World\ndate: 2026-04-04\nauthor: nbbaier\n---\n# Hello World\n\nThis is the first blog post. It supports all the usual markdown features:\n\n## Code blocks\n\n\\`\\`\\`ts\nconst greeting = \"Hello from vt-ssg!\";\nconsole.log(greeting);\n\\`\\`\\`\n\n## Lists\n\n- Markdown parsing via **marked**\n- Frontmatter via **gray-matter**\n- Layouts via **Hono JSX**\n- File writing via **Val Town API**\n\n## Emphasis\n\nThis is *italic*, this is **bold**, and this is \\`inline code\\`.\n`;\n\n// --- Build ------------------------------------------------------------\n\nconsole.log(\"Building site...\");\n\nconst results = await renderToFiles({\n pages: [\n { path: \"index.html\", markdown: indexMd },\n { path: \"about.html\", markdown: aboutMd },\n { path: \"blog/hello-world.html\", markdown: blogPostMd },\n ],\n layout: SiteLayout,\n dir: \"static\",\n fs: { callerUrl: import.meta.url },\n});\n\nfor (const r of results) {\n console.log(\n ` ${r.success ? \"✅\" : \"❌\"} ${r.path}${r.error ? ` — ${r.error}` : \"\"}`,\n );\n}\n\nconsole.log(\"Done!\");",[],[166,196],[166],{"_108":204,"_99":205,"_167":206,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":207,"_104":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":208,"_103":242},"4d447876-2fd0-11f1-85ac-42dde27851f2","output","019d5661-5329-75fe-9f7e-3ce8ccc2ad1a",["D",1775270712111],[209,218,226,234],{"_108":210,"_99":211,"_167":212,"_169":206,"_170":150,"_171":189,"_173":174,"_110":213,"_104":33,"_176":214,"_178":215,"_179":22,"_180":-5,"_181":216,"_103":217},"4d445f26-2fd0-11f1-85ac-42dde27851f2","html1.html","019d5661-5329-75fe-9f7e-2c34a80d2206",["D",1775270712111],"file","\n\n \n \n \n My First Post\n \n \n

Hello World

This is bold and this is italic.

Item 1
Item 2

\n \n",[],[205,211],{"_108":219,"_99":220,"_167":221,"_169":206,"_170":150,"_171":189,"_173":174,"_110":222,"_104":33,"_176":214,"_178":223,"_179":22,"_180":-5,"_181":224,"_103":225},"4d446bec-2fd0-11f1-85ac-42dde27851f2","html2.html","019d5661-5329-75fe-9f7e-327d7e79f5b8",["D",1775270712111],"\n\n Custom Layout Test | My Blog\n \n

Custom Layout Test

Sat Apr 04 2026 00:00:00 GMT+0000\n (Coordinated Universal Time)

Some content here.

\n \n \n",[],[205,220],{"_108":227,"_99":228,"_167":229,"_169":206,"_170":150,"_171":189,"_173":174,"_110":230,"_104":33,"_176":214,"_178":231,"_179":22,"_180":-5,"_181":232,"_103":233},"4d447088-2fd0-11f1-85ac-42dde27851f2","html3.html","019d5661-5329-75fe-9f7e-35ab6dc1afef",["D",1775270712111],"\n\n \n \n \n \n \n \n

No Frontmatter

Just plain markdown.

\n \n",[],[205,228],{"_108":235,"_99":236,"_167":237,"_169":206,"_170":150,"_171":189,"_173":174,"_110":238,"_104":33,"_176":214,"_178":239,"_179":22,"_180":-5,"_181":240,"_103":241},"4d447588-2fd0-11f1-85ac-42dde27851f2","html4.html","019d5661-5329-75fe-9f7e-3ae4529f02ff",["D",1775270712111],"\n\n \n \n \n Props Test\n \n \n

Content.

\n \n",[],[205,236],[205],{"_108":244,"_99":245,"_167":246,"_169":-5,"_170":150,"_171":247,"_173":174,"_110":248,"_104":189,"_176":214,"_178":249,"_179":22,"_180":-5,"_181":250,"_103":251},"d65ca43e-2fd1-11f1-986e-42dde27851f2","README.md","019d5661-5329-75fe-9f7e-43cd2f001479",7,["D",1775271371610],"# vt-ssg\n\nA lightweight static site generator for Val Town. Takes a markdown string and a JSX layout template, returns an HTML string. Includes a Hono-compatible `FileSystemModule` for writing output files directly into a val via the API.\n\n**Stack:** [marked](https://marked.js.org/) · [gray-matter](https://github.com/jonschlinkert/gray-matter) · [Hono JSX](https://hono.dev/docs/guides/jsx)\n\n## Quick Start\n\n```tsx\n/** @jsxImportSource npm:hono@4/jsx */\nimport { render } from \"https://esm.town/v/nbbaier/vt-ssg/main.tsx\";\n\nconst html = await render({\n markdown: `---\ntitle: Hello World\ndate: 2026-04-04\n---\n# Hello\n\nSome **markdown** content.`,\n});\n\n// html is a complete HTML string with \n```\n\n## Custom Layout\n\nPass a Hono JSX component as the `layout` option. It receives `title`, `content` (rendered HTML), and the full `frontmatter` object as props.\n\n```tsx\n/** @jsxImportSource npm:hono@4/jsx */\nimport { render } from \"https://esm.town/v/nbbaier/vt-ssg/main.tsx\";\nimport type { LayoutComponent } from \"https://esm.town/v/nbbaier/vt-ssg/types.ts\";\n\nconst BlogLayout: LayoutComponent = ({ title, content, frontmatter }) => (\n \n \n {title} | My Blog\n \n \n \n

{title}

\n {String(frontmatter.date)}\n

\n \n \n \n);\n\nconst html = await render({\n markdown: source,\n layout: BlogLayout,\n layoutProps: { theme: \"dark\" },\n});\n```\n\n## Batch Render + Write Files\n\nUse `renderToFiles` to render multiple pages and write them as static HTML files into a val via the API. Requires a `VT_WRITE_TOKEN` env var with write permissions.\n\n```tsx\n/** @jsxImportSource npm:hono@4/jsx */\nimport { renderToFiles } from \"https://esm.town/v/nbbaier/vt-ssg/main.tsx\";\n\nconst results = await renderToFiles({\n pages: [\n { path: \"index.html\", markdown: indexMd },\n { path: \"about.html\", markdown: aboutMd, layout: BlogLayout },\n { path: \"blog/post-1.html\", markdown: post1Md },\n ],\n layout: DefaultBlogLayout, // shared layout (pages can override)\n dir: \"static\", // output directory (default: \"static\")\n fs: { callerUrl: import.meta.url },\n});\n\n// results: [{ path: \"static/index.html\", success: true }, ...]\n```\n\n## Drop-in with Hono's `toSSG`\n\nThe `createValTownFS` function returns a Hono-compatible `FileSystemModule`, so you can use it directly with [Hono's SSG helper](https://hono.dev/docs/helpers/ssg):\n\n```ts\nimport { Hono } from \"npm:hono@4\";\nimport { toSSG } from \"npm:hono@4/ssg\";\nimport { createValTownFS } from \"https://esm.town/v/nbbaier/vt-ssg/fs.ts\";\n\nconst app = new Hono();\napp.get(\"/\", (c) => c.html(\"

Home

\"));\napp.get(\"/about\", (c) => c.html(\"

About

\"));\n\nconst fs = createValTownFS({ callerUrl: import.meta.url });\nconst result = await toSSG(app, fs, { dir: \"./static\" });\n// Writes static/index.html and static/about.html into the val\n```\n\n## API Reference\n\n### `render(options: RenderOptions): Promise`\n\n| Option | Type | Required | Description |\n|---|---|---|---|\n| `markdown` | `string` | ✅ | Raw markdown string, optionally with YAML frontmatter |\n| `layout` | `LayoutComponent` | ❌ | Hono JSX component. Defaults to a minimal HTML shell. |\n| `layoutProps` | `Record` | ❌ | Extra props merged into the layout props |\n| `markedOptions` | `MarkedOptions` | ❌ | Options passed to [marked](https://marked.js.org/). GFM enabled by default. |\n\n### `renderToFiles(options: RenderToFilesOptions): Promise`\n\n| Option | Type | Required | Description |\n|---|---|---|---|\n| `pages` | `PageInput[]` | ✅ | Array of pages to render (each has `path`, `markdown`, optional `layout`/`layoutProps`) |\n| `fs` | `ValTownFSOptions` | ✅ | FS config: `{ callerUrl: import.meta.url }` (or `valId`/`token`) |\n| `layout` | `LayoutComponent` | ❌ | Shared layout for all pages (individual pages can override) |\n| `layoutProps` | `Record` | ❌ | Shared extra layout props |\n| `markedOptions` | `MarkedOptions` | ❌ | Options passed to marked |\n| `dir` | `string` | ❌ | Output directory prefix. Defaults to `\"static\"`. |\n\n### `createValTownFS(options: ValTownFSOptions): FileSystemModule`\n\n| Option | Type | Required | Description |\n|---|---|---|---|\n| `callerUrl` | `string` | ✅ | Pass `import.meta.url` to target the calling val |\n| `valId` | `string` | ❌ | Target val ID. Takes precedence over `callerUrl`. |\n| `token` | `string` | ❌ | API token. Defaults to `VT_WRITE_TOKEN` env var. |\n\n### `LayoutProps`\n\n| Prop | Type | Description |\n|---|---|---|\n| `title` | `string` | Extracted from `frontmatter.title`, or `\"\"` |\n| `content` | `string` | Rendered HTML from the markdown body |\n| `frontmatter` | `Record` | Full parsed frontmatter object |\n| `...layoutProps` | `unknown` | Any extra props from `layoutProps` |\n\n## Architecture\n\n```mermaid\nflowchart LR\n A[\"Markdown string\"] --> B[\"frontmatter.ts\\ngray-matter\"]\n B --> C[\"YAML data\"]\n B --> D[\"Markdown body\"]\n D --> E[\"markdown.ts\\nmarked\"]\n E --> F[\"HTML string\"]\n C --> G[\"main.tsx\\nrender()\"]\n F --> G\n H[\"Layout JSX\"] --> G\n I[\"layoutProps\"] --> G\n G --> J[\"Full HTML page\"]\n J --> K[\"fs.ts\\nValTownFS\"]\n K --> L[\"Val Town API\\nwriteFile\"]\n L --> M[\"Static files\\nin val\"]\n```\n\n## File Structure\n\n```\nmain.tsx — Public API: render() + renderToFiles()\ntypes.ts — TypeScript type definitions\nfs.ts — Hono-compatible FileSystemModule for Val Town\nfrontmatter.ts — gray-matter wrapper\nmarkdown.ts — marked wrapper\ndefaults.tsx — Default HTML layout component\ntest.tsx — Test script\nserve.tsx — Static file server (for serving generated output)\n```\n",[],[245],{"_108":253,"_99":254,"_167":255,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":256,"_104":33,"_176":190,"_178":257,"_179":22,"_180":-5,"_181":258,"_103":259},"4d448fbe-2fd0-11f1-85ac-42dde27851f2","defaults.tsx","019d5661-5329-75fe-9f7e-462e9ec015d8",["D",1775270712111],"/** @jsxImportSource npm:hono@4/jsx */\nimport type { LayoutProps } from \"./types.ts\";\n\n/**\n * Default HTML layout component.\n * Renders a minimal but complete HTML document shell.\n */\nexport function DefaultLayout({ title, content }: LayoutProps) {\n return (\n \n \n \n \n {title}\n \n \n

\n \n \n );\n}\n",[],[254],{"_108":261,"_99":262,"_167":263,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":264,"_104":33,"_176":190,"_178":265,"_179":22,"_180":-5,"_181":266,"_103":267},"4d449a7c-2fd0-11f1-85ac-42dde27851f2","frontmatter.ts","019d5661-5329-75fe-9f7e-4a5ab068244c",["D",1775270712111],"import matter from \"npm:gray-matter\";\nimport type { Frontmatter } from \"./types.ts\";\n\nexport type FrontmatterResult = {\n /** Parsed YAML frontmatter as a plain object */\n data: Frontmatter;\n /** Markdown body with frontmatter stripped */\n content: string;\n};\n\n/**\n * Parse YAML frontmatter from a raw markdown string.\n *\n * @example\n * ```ts\n * const { data, content } = parseFrontmatter(`---\n * title: Hello\n * ---\n * # Hello World`);\n * // data = { title: \"Hello\" }\n * // content = \"# Hello World\"\n * ```\n */\nexport function parseFrontmatter(raw: string): FrontmatterResult {\n const { data, content } = matter(raw);\n return { data, content };\n}\n",[],[262],{"_108":269,"_99":270,"_167":271,"_169":-5,"_170":150,"_171":272,"_173":174,"_110":273,"_104":33,"_176":190,"_178":274,"_179":22,"_180":-5,"_181":275,"_103":276},"95040a0e-2fd1-11f1-a511-42dde27851f2","fs.ts","95040ae0-2fd1-11f1-a511-42dde27851f2",2,["D",1775271261985],"import { writeFile } from \"https://esm.town/v/nbbaier/writeFile/index.ts\";\nimport type { FileSystemModule } from \"npm:hono@4/ssg\";\n\nexport type ValTownFSOptions = {\n /** The calling val's URL. Pass `import.meta.url` to target the calling val. */\n callerUrl: string;\n /** Optional val ID. Takes precedence over callerUrl if provided. */\n valId?: string;\n /** Optional API token. Defaults to VT_WRITE_TOKEN env var. */\n token?: string;\n};\n\n/**\n * Create a Hono-compatible FileSystemModule that writes files into a\n * Val Town val via the API.\n *\n * `mkdir` is a no-op — Val Town creates intermediate directories\n * automatically when files are created at nested paths.\n *\n * @example Drop-in with Hono's toSSG\n * ```ts\n * import { toSSG } from \"npm:hono@4/ssg\";\n * import { createValTownFS } from \"https://esm.town/v/nbbaier/vt-ssg/fs.ts\";\n *\n * const fs = createValTownFS({ callerUrl: import.meta.url });\n * await toSSG(app, fs, { dir: \"./static\" });\n * ```\n *\n * @example Standalone usage\n * ```ts\n * const fs = createValTownFS({ callerUrl: import.meta.url });\n * await fs.writeFile(\"static/index.html\", \"

Hello

\");\n * ```\n */\nexport function createValTownFS(options: ValTownFSOptions): FileSystemModule {\n const { callerUrl, valId, token } = options;\n\n return {\n async writeFile(path: string, data: string | Uint8Array): Promise {\n // Normalize path — strip leading ./ if present\n const normalizedPath = path.replace(/^\\.\\//, \"\");\n\n const content = typeof data === \"string\"\n ? data\n : new TextDecoder().decode(data);\n\n const result = await writeFile({\n path: normalizedPath,\n content,\n type: \"file\",\n callerUrl,\n ...(valId ? { valId } : {}),\n ...(token ? { token } : {}),\n });\n\n if (!result.success) {\n throw new Error(\n `Failed to write ${normalizedPath}: ${(result as { error: string }).error}`,\n );\n }\n },\n\n async mkdir(\n _path: string,\n _options: { recursive: boolean },\n ): Promise {\n // No-op: Val Town creates directories automatically\n return;\n },\n };\n}\n",[],[270],{"_108":278,"_99":279,"_167":280,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":281,"_104":33,"_176":214,"_178":282,"_179":22,"_180":-5,"_181":283,"_103":284},"4d449fb8-2fd0-11f1-85ac-42dde27851f2","index.html","019d5661-5329-75fe-9f7e-4c3d1078e39d",["D",1775270712111],"\n\n \n Hi there!\n \n \n \n\n \n \n\n \n \n\n \n \n \n \n

Hi there!

\n\n

\n I'm your cool new webpage. Made with Val Town!\n

\n \n",[],[279],{"_108":286,"_99":287,"_167":288,"_169":-5,"_170":150,"_171":289,"_173":22,"_110":290,"_104":189,"_176":190,"_178":291,"_179":22,"_180":-5,"_181":292,"_103":293},"a6c352b8-2fd1-11f1-ac61-42dde27851f2","main.tsx","019d5661-5329-75fe-9f7e-518c218dbec5",5,["D",1775271291760],"/** @jsxImportSource npm:hono@4/jsx */\nimport { parseFrontmatter } from \"./frontmatter.ts\";\nimport { parseMarkdown } from \"./markdown.ts\";\nimport { DefaultLayout } from \"./defaults.tsx\";\nimport { createValTownFS } from \"./fs.ts\";\nimport type {\n RenderOptions,\n RenderToFilesOptions,\n LayoutProps,\n PageResult,\n} from \"./types.ts\";\n\n// Re-export types and fs for consumer convenience\nexport type {\n RenderOptions,\n RenderToFilesOptions,\n LayoutProps,\n LayoutComponent,\n Frontmatter,\n PageInput,\n PageResult,\n} from \"./types.ts\";\nexport { createValTownFS } from \"./fs.ts\";\nexport type { ValTownFSOptions } from \"./fs.ts\";\n\n/**\n * Render a markdown string with an optional JSX layout into a full HTML string.\n *\n * @example\n * ```tsx\n * import { render } from \"https://esm.town/v/nbbaier/vt-ssg/main.tsx\";\n *\n * const html = await render({\n * markdown: `---\n * title: Hello\n * ---\n * # Hello World`,\n * });\n * ```\n *\n * @example With a custom layout\n * ```tsx\n * const html = await render({\n * markdown: source,\n * layout: MyLayout,\n * layoutProps: { nav: [\"Home\", \"About\"] },\n * });\n * ```\n */\nexport async function render(options: RenderOptions): Promise {\n const { markdown, layout, layoutProps = {}, markedOptions } = options;\n\n // 1. Parse frontmatter\n const { data: frontmatter, content: markdownBody } = parseFrontmatter(markdown);\n\n // 2. Convert markdown body to HTML\n const content = await parseMarkdown(markdownBody, markedOptions);\n\n // 3. Build layout props\n const title = typeof frontmatter.title === \"string\" ? frontmatter.title : \"\";\n const props: LayoutProps = {\n title,\n content,\n frontmatter,\n ...layoutProps,\n };\n\n // 4. Render JSX layout to string\n const Layout = layout ?? DefaultLayout;\n const element = ;\n const html = element.toString();\n\n // 5. Prepend doctype if the layout renders an root\n if (html.trimStart().startsWith(\"\\n${html}`;\n }\n\n return html;\n}\n\n/**\n * Render multiple markdown pages and write them as static HTML files\n * into a Val Town val via the API.\n *\n * @example\n * ```tsx\n * import { renderToFiles } from \"https://esm.town/v/nbbaier/vt-ssg/main.tsx\";\n *\n * const results = await renderToFiles({\n * pages: [\n * { path: \"index.html\", markdown: indexMd },\n * { path: \"about.html\", markdown: aboutMd, layout: BlogLayout },\n * ],\n * fs: { callerUrl: import.meta.url },\n * });\n * ```\n *\n * @example With Hono's toSSG (drop-in FileSystemModule)\n * ```ts\n * import { toSSG } from \"npm:hono@4/ssg\";\n * import { createValTownFS } from \"https://esm.town/v/nbbaier/vt-ssg/fs.ts\";\n *\n * const fs = createValTownFS({ callerUrl: import.meta.url });\n * await toSSG(app, fs, { dir: \"./static\" });\n * ```\n */\nexport async function renderToFiles(\n options: RenderToFilesOptions,\n): Promise {\n const {\n pages,\n layout: sharedLayout,\n layoutProps: sharedLayoutProps = {},\n markedOptions,\n dir = \"static\",\n fs: fsOptions,\n } = options;\n\n const fs = createValTownFS(fsOptions);\n const results: PageResult[] = [];\n\n for (const page of pages) {\n const outputPath = `${dir}/${page.path}`.replace(/\\/+/g, \"/\");\n\n try {\n // Render markdown to HTML\n const html = await render({\n markdown: page.markdown,\n layout: page.layout ?? sharedLayout,\n layoutProps: { ...sharedLayoutProps, ...page.layoutProps },\n markedOptions,\n });\n\n // Write to val via API\n await fs.writeFile(outputPath, html);\n\n results.push({ path: outputPath, success: true });\n } catch (err) {\n results.push({\n path: outputPath,\n success: false,\n error: err instanceof Error ? err.message : String(err),\n });\n }\n }\n\n return results;\n}\n",[],[287],{"_108":295,"_99":296,"_167":297,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":298,"_104":33,"_176":190,"_178":299,"_179":22,"_180":-5,"_181":300,"_103":301},"4d44af1c-2fd0-11f1-85ac-42dde27851f2","markdown.ts","019d5661-5329-75fe-9f7e-57093a147996",["D",1775270712111],"import { marked, type MarkedOptions } from \"npm:marked\";\n\n/** Default marked options — GFM enabled */\nconst defaults: MarkedOptions = {\n gfm: true,\n};\n\n/**\n * Parse a markdown string into an HTML string using `marked`.\n *\n * @param md - Markdown source (frontmatter should already be stripped)\n * @param options - Optional marked configuration. Merged with defaults (GFM on).\n * @returns Rendered HTML string\n */\nexport async function parseMarkdown(\n md: string,\n options?: MarkedOptions,\n): Promise {\n const merged = { ...defaults, ...options };\n const html = await marked(md, merged);\n return html;\n}\n",[],[296],{"_108":303,"_99":304,"_167":305,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":306,"_104":33,"_176":307,"_178":308,"_179":22,"_180":-5,"_181":309,"_103":310},"4d44b5e8-2fd0-11f1-85ac-42dde27851f2","serve.tsx","019d5661-5329-75fe-9f7e-5d62cadb44c4",["D",1775270712111],"http","import { staticHTTPServer } from \"https://esm.town/v/std/utils/index.ts\";\nexport default staticHTTPServer();",[],[304],{"_108":312,"_99":313,"_167":314,"_169":-5,"_170":150,"_171":315,"_173":174,"_110":316,"_104":189,"_176":190,"_178":317,"_179":22,"_180":-5,"_181":318,"_103":319},"af8b3a0a-2fd1-11f1-986e-42dde27851f2","test.tsx","019d5661-5329-75fe-9f7e-630093902ffe",6,["D",1775271306225],"/** @jsxImportSource npm:hono@4/jsx */\nimport { render, renderToFiles } from \"./main.tsx\";\nimport type { LayoutProps, LayoutComponent } from \"./types.ts\";\n\n// ============================================================\n// Test 1: render() with default layout\n// ============================================================\nconst html1 = await render({\n markdown: `---\ntitle: My First Post\ndate: 2026-04-04\n---\n# Hello World\n\nThis is **bold** and this is _italic_.\n\n- Item 1\n- Item 2\n`,\n});\n\nconsole.log(\"=== Test 1: Default layout ===\");\nconsole.log(html1.slice(0, 200) + \"...\");\nconsole.log(\"✅ Starts with DOCTYPE:\", html1.startsWith(\"\"));\nconsole.log(\"✅ Has title:\", html1.includes(\"My First Post\"));\nconsole.log();\n\n// ============================================================\n// Test 2: render() with custom layout\n// ============================================================\nconst CustomLayout: LayoutComponent = ({ title, content, frontmatter }) => (\n \n \n {title} | My Blog\n \n \n

\n \n

{title}

\n \n \n \n);\n\nconst html2 = await render({\n markdown: `---\ntitle: Custom Layout Test\n---\nSome **content** here.`,\n layout: CustomLayout,\n});\n\nconsole.log(\"=== Test 2: Custom layout ===\");\nconsole.log(\"✅ Has custom title:\", html2.includes(\"Custom Layout Test | My Blog\"));\nconsole.log(\"✅ Has footer:\", html2.includes(\"Built with vt-ssg\"));\nconsole.log();\n\n// ============================================================\n// Test 3: render() with no frontmatter\n// ============================================================\nconst html3 = await render({\n markdown: `# No Frontmatter\\n\\nJust plain markdown.`,\n});\n\nconsole.log(\"=== Test 3: No frontmatter ===\");\nconsole.log(\"✅ Empty title:\", html3.includes(\"\"));\nconsole.log(\"✅ Has content:\", html3.includes(\"

No Frontmatter

\"));\nconsole.log();\n\n// ============================================================\n// Test 4: renderToFiles() — batch render + write\n// ============================================================\nconsole.log(\"=== Test 4: renderToFiles ===\");\n\nconst results = await renderToFiles({\n pages: [\n {\n path: \"index.html\",\n markdown: `---\ntitle: Home\n---\n# Welcome\n\nThis is the **home page**.`,\n },\n {\n path: \"about.html\",\n markdown: `---\ntitle: About\n---\n# About Us\n\nWe build cool things.`,\n layout: CustomLayout,\n },\n ],\n dir: \"static\",\n fs: { callerUrl: import.meta.url },\n});\n\nfor (const r of results) {\n console.log(` ${r.success ? \"✅\" : \"❌\"} ${r.path}${r.error ? ` — ${r.error}` : \"\"}`);\n}\nconsole.log();\n\nconsole.log(\"All tests complete!\");\n",[],[313],{"_108":321,"_99":322,"_167":323,"_169":-5,"_170":150,"_171":324,"_173":174,"_110":325,"_104":189,"_176":190,"_178":326,"_179":22,"_180":-5,"_181":327,"_103":328},"9db8cb94-2fd1-11f1-8d79-42dde27851f2","types.ts","019d5661-5329-75fe-9f7e-6533c504c7b5",4,["D",1775271276562],"import type { FC } from \"npm:hono@4/jsx\";\nimport type { MarkedOptions } from \"npm:marked\";\nimport type { ValTownFSOptions } from \"./fs.ts\";\n\n/** Frontmatter data extracted from markdown YAML front matter */\nexport type Frontmatter = Record;\n\n/** Props passed to layout components */\nexport type LayoutProps = {\n /** Page title — extracted from frontmatter.title, or \"\" if not set */\n title: string;\n /** Rendered HTML string from the markdown body */\n content: string;\n /** Full parsed frontmatter object */\n frontmatter: F;\n /** Any extra props passed via layoutProps */\n [key: string]: unknown;\n};\n\n/** A Hono JSX functional component that accepts LayoutProps */\nexport type LayoutComponent = FC;\n\n/** Options for the render() function */\nexport type RenderOptions = {\n /** Raw markdown string (optionally with YAML frontmatter) */\n markdown: string;\n /** JSX layout component. If omitted, a default HTML shell is used. */\n layout?: LayoutComponent;\n /** Extra props merged into the layout props */\n layoutProps?: Record;\n /** Options passed to the marked parser. GFM is enabled by default. */\n markedOptions?: MarkedOptions;\n};\n\n/** A single page to render and write to a file */\nexport type PageInput = {\n /** Output file path relative to the output dir (e.g. \"index.html\", \"about.html\", \"blog/post-1.html\") */\n path: string;\n /** Raw markdown string (optionally with YAML frontmatter) */\n markdown: string;\n /** JSX layout component for this page. Falls back to the shared layout, then the default. */\n layout?: LayoutComponent;\n /** Extra props merged into the layout props for this page */\n layoutProps?: Record;\n};\n\n/** Result for a single page in renderToFiles */\nexport type PageResult = {\n path: string;\n success: boolean;\n error?: string;\n};\n\n/** Options for the renderToFiles() batch function */\nexport type RenderToFilesOptions = {\n /** Array of pages to render */\n pages: PageInput[];\n /** Shared layout for all pages. Individual pages can override. */\n layout?: LayoutComponent;\n /** Shared extra layout props. Individual page props are merged on top. */\n layoutProps?: Record;\n /** Options passed to the marked parser. GFM is enabled by default. */\n markedOptions?: MarkedOptions;\n /** Output directory prefix. Defaults to \"static\". */\n dir?: string;\n /** Val Town FS options for writing files */\n fs: ValTownFSOptions;\n};",[],[322],"files",[164,183,194,203,209,218,226,234,243,252,260,268,277,285,294,302,311,320],"counts",{"_333":33,"_334":272,"_335":33,"_336":337,"_340":341},"pulls","branches","forks","envVars",{"_338":189,"_339":33},"count","emptyCount","connections",{"_338":33,"_342":33},"unfilledCount","contents",[345,348,351,354,357,360,363,366,369,372,375,378],{"_108":165,"_99":166,"_167":168,"_169":-5,"_170":150,"_171":172,"_173":174,"_110":346,"_104":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_103":347},["D",1775271510288],[166],{"_108":204,"_99":205,"_167":206,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":349,"_104":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_103":350},["D",1775270712111],[205],{"_108":244,"_99":245,"_167":246,"_169":-5,"_170":150,"_171":247,"_173":174,"_110":352,"_104":189,"_176":214,"_178":249,"_179":22,"_180":-5,"_103":353},["D",1775271371610],[245],{"_108":253,"_99":254,"_167":255,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":355,"_104":33,"_176":190,"_178":257,"_179":22,"_180":-5,"_103":356},["D",1775270712111],[254],{"_108":261,"_99":262,"_167":263,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":358,"_104":33,"_176":190,"_178":265,"_179":22,"_180":-5,"_103":359},["D",1775270712111],[262],{"_108":269,"_99":270,"_167":271,"_169":-5,"_170":150,"_171":272,"_173":174,"_110":361,"_104":33,"_176":190,"_178":274,"_179":22,"_180":-5,"_103":362},["D",1775271261985],[270],{"_108":278,"_99":279,"_167":280,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":364,"_104":33,"_176":214,"_178":282,"_179":22,"_180":-5,"_103":365},["D",1775270712111],[279],{"_108":286,"_99":287,"_167":288,"_169":-5,"_170":150,"_171":289,"_173":22,"_110":367,"_104":189,"_176":190,"_178":291,"_179":22,"_180":-5,"_103":368},["D",1775271291760],[287],{"_108":295,"_99":296,"_167":297,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":370,"_104":33,"_176":190,"_178":299,"_179":22,"_180":-5,"_103":371},["D",1775270712111],[296],{"_108":303,"_99":304,"_167":305,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":373,"_104":33,"_176":307,"_178":308,"_179":22,"_180":-5,"_103":374},["D",1775270712111],[304],{"_108":312,"_99":313,"_167":314,"_169":-5,"_170":150,"_171":315,"_173":174,"_110":376,"_104":189,"_176":190,"_178":317,"_179":22,"_180":-5,"_103":377},["D",1775271306225],[313],{"_108":321,"_99":322,"_167":323,"_169":-5,"_170":150,"_171":324,"_173":174,"_110":379,"_104":189,"_176":190,"_178":326,"_179":22,"_180":-5,"_103":380},["D",1775271276562],[322],"upstreamProject","upstreamBranch",{"_108":153,"_110":384,"_385":386,"_99":45,"_151":109,"_104":387,"_152":-5,"_154":-5,"_388":389,"_112":-5,"_161":22,"_114":115,"_160":98,"_16":125,"_159":100},["D",1775264637874],"updatedAt",["D",1775277981462],369,"lockfileKey","1775277676300-esm.town_v_nbbaier_vt-ssg@354-main","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.branch.$branch.version.$version.code.$",{"_97":98,"_99":100,"_101":102,"_104":105,"_103":76,"_106":396,"_162":401,"_329":474,"_214":-7,"_343":475,"_512":513,"_516":-5,"_517":33,"_518":519,"_520":521,"_336":-5},{"_108":109,"_99":100,"_110":397,"_112":-5,"_113":22,"_114":115,"_116":117,"_118":-5,"_14":119,"_120":-5,"_121":22,"_122":-5,"_123":-5,"_124":33,"_16":125,"_126":-5,"_127":-5,"_128":-5,"_129":-5,"_130":131,"_132":131,"_133":134,"_135":134,"_136":134,"_137":131,"_138":131,"_23":398,"_142":399,"_147":400,"_161":22},["D",1775264637868],{"_97":98,"_140":141},{"_97":98,"_144":141,"_14":119,"_145":146},{"_104":149,"_99":102,"_108":150,"_151":109,"_152":153,"_154":155,"_156":115,"_157":109,"_158":125,"_159":100,"_160":98},[402,414,434,438,442,446,450,454,458,462,466,470],{"_108":165,"_99":166,"_167":168,"_169":-5,"_170":150,"_171":172,"_173":174,"_110":403,"_104":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":404,"_103":413},["D",1775271510288],[405,409],{"_108":184,"_99":185,"_167":186,"_169":168,"_170":150,"_171":187,"_173":174,"_110":406,"_104":189,"_176":190,"_178":191,"_179":22,"_180":-5,"_181":407,"_103":408},["D",1775271548302],[],[166,185],{"_108":195,"_99":196,"_167":197,"_169":168,"_170":150,"_171":105,"_173":174,"_110":410,"_104":189,"_176":190,"_178":199,"_179":22,"_180":-5,"_181":411,"_103":412},["D",1775271603477],[],[166,196],[166],{"_108":204,"_99":205,"_167":206,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":415,"_104":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_181":416,"_103":433},["D",1775270712111],[417,421,425,429],{"_108":210,"_99":211,"_167":212,"_169":206,"_170":150,"_171":189,"_173":174,"_110":418,"_104":33,"_176":214,"_178":215,"_179":22,"_180":-5,"_181":419,"_103":420},["D",1775270712111],[],[205,211],{"_108":219,"_99":220,"_167":221,"_169":206,"_170":150,"_171":189,"_173":174,"_110":422,"_104":33,"_176":214,"_178":223,"_179":22,"_180":-5,"_181":423,"_103":424},["D",1775270712111],[],[205,220],{"_108":227,"_99":228,"_167":229,"_169":206,"_170":150,"_171":189,"_173":174,"_110":426,"_104":33,"_176":214,"_178":231,"_179":22,"_180":-5,"_181":427,"_103":428},["D",1775270712111],[],[205,228],{"_108":235,"_99":236,"_167":237,"_169":206,"_170":150,"_171":189,"_173":174,"_110":430,"_104":33,"_176":214,"_178":239,"_179":22,"_180":-5,"_181":431,"_103":432},["D",1775270712111],[],[205,236],[205],{"_108":244,"_99":245,"_167":246,"_169":-5,"_170":150,"_171":247,"_173":174,"_110":435,"_104":189,"_176":214,"_178":249,"_179":22,"_180":-5,"_181":436,"_103":437},["D",1775271371610],[],[245],{"_108":253,"_99":254,"_167":255,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":439,"_104":33,"_176":190,"_178":257,"_179":22,"_180":-5,"_181":440,"_103":441},["D",1775270712111],[],[254],{"_108":261,"_99":262,"_167":263,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":443,"_104":33,"_176":190,"_178":265,"_179":22,"_180":-5,"_181":444,"_103":445},["D",1775270712111],[],[262],{"_108":269,"_99":270,"_167":271,"_169":-5,"_170":150,"_171":272,"_173":174,"_110":447,"_104":33,"_176":190,"_178":274,"_179":22,"_180":-5,"_181":448,"_103":449},["D",1775271261985],[],[270],{"_108":278,"_99":279,"_167":280,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":451,"_104":33,"_176":214,"_178":282,"_179":22,"_180":-5,"_181":452,"_103":453},["D",1775270712111],[],[279],{"_108":286,"_99":287,"_167":288,"_169":-5,"_170":150,"_171":289,"_173":22,"_110":455,"_104":189,"_176":190,"_178":291,"_179":22,"_180":-5,"_181":456,"_103":457},["D",1775271291760],[],[287],{"_108":295,"_99":296,"_167":297,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":459,"_104":33,"_176":190,"_178":299,"_179":22,"_180":-5,"_181":460,"_103":461},["D",1775270712111],[],[296],{"_108":303,"_99":304,"_167":305,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":463,"_104":33,"_176":307,"_178":308,"_179":22,"_180":-5,"_181":464,"_103":465},["D",1775270712111],[],[304],{"_108":312,"_99":313,"_167":314,"_169":-5,"_170":150,"_171":315,"_173":174,"_110":467,"_104":189,"_176":190,"_178":317,"_179":22,"_180":-5,"_181":468,"_103":469},["D",1775271306225],[],[313],{"_108":321,"_99":322,"_167":323,"_169":-5,"_170":150,"_171":324,"_173":174,"_110":471,"_104":189,"_176":190,"_178":326,"_179":22,"_180":-5,"_181":472,"_103":473},["D",1775271276562],[],[322],[402,405,409,414,417,421,425,429,434,438,442,446,450,454,458,462,466,470],[476,479,482,485,488,491,494,497,500,503,506,509],{"_108":165,"_99":166,"_167":168,"_169":-5,"_170":150,"_171":172,"_173":174,"_110":477,"_104":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_103":478},["D",1775271510288],[166],{"_108":204,"_99":205,"_167":206,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":480,"_104":33,"_176":177,"_178":-5,"_179":22,"_180":-5,"_103":481},["D",1775270712111],[205],{"_108":244,"_99":245,"_167":246,"_169":-5,"_170":150,"_171":247,"_173":174,"_110":483,"_104":189,"_176":214,"_178":249,"_179":22,"_180":-5,"_103":484},["D",1775271371610],[245],{"_108":253,"_99":254,"_167":255,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":486,"_104":33,"_176":190,"_178":257,"_179":22,"_180":-5,"_103":487},["D",1775270712111],[254],{"_108":261,"_99":262,"_167":263,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":489,"_104":33,"_176":190,"_178":265,"_179":22,"_180":-5,"_103":490},["D",1775270712111],[262],{"_108":269,"_99":270,"_167":271,"_169":-5,"_170":150,"_171":272,"_173":174,"_110":492,"_104":33,"_176":190,"_178":274,"_179":22,"_180":-5,"_103":493},["D",1775271261985],[270],{"_108":278,"_99":279,"_167":280,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":495,"_104":33,"_176":214,"_178":282,"_179":22,"_180":-5,"_103":496},["D",1775270712111],[279],{"_108":286,"_99":287,"_167":288,"_169":-5,"_170":150,"_171":289,"_173":22,"_110":498,"_104":189,"_176":190,"_178":291,"_179":22,"_180":-5,"_103":499},["D",1775271291760],[287],{"_108":295,"_99":296,"_167":297,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":501,"_104":33,"_176":190,"_178":299,"_179":22,"_180":-5,"_103":502},["D",1775270712111],[296],{"_108":303,"_99":304,"_167":305,"_169":-5,"_170":150,"_171":189,"_173":174,"_110":504,"_104":33,"_176":307,"_178":308,"_179":22,"_180":-5,"_103":505},["D",1775270712111],[304],{"_108":312,"_99":313,"_167":314,"_169":-5,"_170":150,"_171":315,"_173":174,"_110":507,"_104":189,"_176":190,"_178":317,"_179":22,"_180":-5,"_103":508},["D",1775271306225],[313],{"_108":321,"_99":322,"_167":323,"_169":-5,"_170":150,"_171":324,"_173":174,"_110":510,"_104":189,"_176":190,"_178":326,"_179":22,"_180":-5,"_103":511},["D",1775271276562],[322],"upstream",{"_108":153,"_110":514,"_385":515,"_99":45,"_151":109,"_104":387,"_152":-5,"_154":-5,"_388":389,"_112":-5,"_161":22,"_114":115,"_160":98,"_16":125,"_159":100},["D",1775264637874],["D",1775277981462],"pull","ahead","behind",255,"templates",[],"actionData","errors"]

Welcome

About

Contact

Hello World

Custom Layout Test

No Frontmatter

{title}

Home

About

Hello

Hi there!

{title}

No Frontmatter