npm - @jasonshimmy/vite-plugin-cer-app - Versions diffs - 0.1.0 → 0.1.2 - Mend

@jasonshimmy/vite-plugin-cer-app 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (172) hide show

package/CHANGELOG.md +8 -0
package/IMPLEMENTATION_PLAN.md +1 -1
package/README.md +7 -7
package/VITE_PLUGIN_FRAMEWORK_PLAN.md +12 -12
package/commits.txt +1 -3
package/dist/cli/commands/generate.d.ts.map +1 -1
package/dist/cli/commands/generate.js +2 -0
package/dist/cli/commands/generate.js.map +1 -1
package/dist/cli/commands/preview.d.ts.map +1 -1
package/dist/cli/commands/preview.js +21 -2
package/dist/cli/commands/preview.js.map +1 -1
package/dist/cli/create/index.js +2 -2
package/dist/cli/create/index.js.map +1 -1
package/dist/cli/index.js +1 -1
package/dist/cli/index.js.map +1 -1
package/dist/plugin/build-ssg.d.ts.map +1 -1
package/dist/plugin/build-ssg.js +10 -21
package/dist/plugin/build-ssg.js.map +1 -1
package/dist/plugin/build-ssr.d.ts.map +1 -1
package/dist/plugin/build-ssr.js +151 -28
package/dist/plugin/build-ssr.js.map +1 -1
package/dist/plugin/dts-generator.js +4 -4
package/dist/plugin/dts-generator.js.map +1 -1
package/dist/plugin/index.js +2 -2
package/dist/plugin/index.js.map +1 -1
package/dist/plugin/transforms/auto-import.js +3 -3
package/dist/plugin/transforms/auto-import.js.map +1 -1
package/dist/plugin/virtual/components.js +3 -3
package/dist/plugin/virtual/components.js.map +1 -1
package/dist/plugin/virtual/composables.js +3 -3
package/dist/plugin/virtual/composables.js.map +1 -1
package/dist/plugin/virtual/error.js +2 -2
package/dist/plugin/virtual/error.js.map +1 -1
package/dist/plugin/virtual/layouts.js +3 -3
package/dist/plugin/virtual/layouts.js.map +1 -1
package/dist/plugin/virtual/loading.js +2 -2
package/dist/plugin/virtual/loading.js.map +1 -1
package/dist/plugin/virtual/middleware.js +3 -3
package/dist/plugin/virtual/middleware.js.map +1 -1
package/dist/plugin/virtual/plugins.js +3 -3
package/dist/plugin/virtual/plugins.js.map +1 -1
package/dist/plugin/virtual/routes.d.ts.map +1 -1
package/dist/plugin/virtual/routes.js +14 -4
package/dist/plugin/virtual/routes.js.map +1 -1
package/dist/plugin/virtual/server-api.js +3 -3
package/dist/plugin/virtual/server-api.js.map +1 -1
package/dist/plugin/virtual/server-middleware.js +3 -3
package/dist/plugin/virtual/server-middleware.js.map +1 -1
package/dist/runtime/app-template.d.ts +1 -1
package/dist/runtime/app-template.d.ts.map +1 -1
package/dist/runtime/app-template.js +6 -0
package/dist/runtime/app-template.js.map +1 -1
package/dist/runtime/composables/use-page-data.d.ts +15 -6
package/dist/runtime/composables/use-page-data.d.ts.map +1 -1
package/dist/runtime/composables/use-page-data.js +30 -9
package/dist/runtime/composables/use-page-data.js.map +1 -1
package/dist/runtime/entry-server-template.d.ts +1 -1
package/dist/runtime/entry-server-template.d.ts.map +1 -1
package/dist/runtime/entry-server-template.js +138 -17
package/dist/runtime/entry-server-template.js.map +1 -1
package/docs/cli.md +2 -2
package/docs/configuration.md +4 -4
package/docs/data-loading.md +8 -7
package/docs/getting-started.md +5 -5
package/docs/head-management.md +3 -3
package/docs/middleware.md +2 -2
package/docs/plugins.md +1 -1
package/docs/rendering-modes.md +1 -1
package/docs/routing.md +1 -1
package/docs/server-api.md +10 -1
package/docs/testing.md +4 -4
package/package.json +1 -1
package/src/__tests__/index.test.ts +21 -0
package/src/__tests__/plugin/build-ssg.test.ts +265 -0
package/src/__tests__/plugin/build-ssr.test.ts +180 -0
package/src/__tests__/plugin/cer-app-plugin.test.ts +409 -0
package/src/__tests__/plugin/dts-generator.test.ts +246 -0
package/src/__tests__/plugin/resolve-config.test.ts +158 -0
package/src/__tests__/plugin/transforms/auto-import.test.ts +1 -1
package/src/__tests__/plugin/virtual/components.test.ts +1 -1
package/src/__tests__/plugin/virtual/composables.test.ts +1 -1
package/src/__tests__/plugin/virtual/error.test.ts +71 -0
package/src/__tests__/plugin/virtual/layouts.test.ts +1 -1
package/src/__tests__/plugin/virtual/loading.test.ts +72 -0
package/src/__tests__/plugin/virtual/middleware.test.ts +1 -1
package/src/__tests__/plugin/virtual/plugins.test.ts +1 -1
package/src/__tests__/plugin/virtual/routes.test.ts +1 -1
package/src/__tests__/plugin/virtual/server-api.test.ts +1 -1
package/src/__tests__/plugin/virtual/server-middleware.test.ts +102 -0
package/src/__tests__/runtime/use-page-data.test.ts +81 -5
package/src/__tests__/types/config.test.ts +23 -0
package/src/cli/commands/generate.ts +2 -0
package/src/cli/commands/preview.ts +21 -2
package/src/cli/create/index.ts +2 -2
package/src/cli/create/templates/spa/cer.config.ts.tpl +1 -1
package/src/cli/create/templates/spa/package.json.tpl +1 -1
package/src/cli/create/templates/ssg/cer.config.ts.tpl +1 -1
package/src/cli/create/templates/ssg/package.json.tpl +1 -1
package/src/cli/create/templates/ssr/cer.config.ts.tpl +1 -1
package/src/cli/create/templates/ssr/package.json.tpl +1 -1
package/src/cli/index.ts +1 -1
package/src/plugin/build-ssg.ts +9 -22
package/src/plugin/build-ssr.ts +150 -28
package/src/plugin/dts-generator.ts +4 -4
package/src/plugin/index.ts +2 -2
package/src/plugin/transforms/auto-import.ts +3 -3
package/src/plugin/virtual/components.ts +3 -3
package/src/plugin/virtual/composables.ts +3 -3
package/src/plugin/virtual/error.ts +2 -2
package/src/plugin/virtual/layouts.ts +3 -3
package/src/plugin/virtual/loading.ts +2 -2
package/src/plugin/virtual/middleware.ts +3 -3
package/src/plugin/virtual/plugins.ts +3 -3
package/src/plugin/virtual/routes.ts +15 -4
package/src/plugin/virtual/server-api.ts +3 -3
package/src/plugin/virtual/server-middleware.ts +3 -3
package/src/runtime/app-template.ts +6 -0
package/src/runtime/composables/use-page-data.ts +31 -9
package/src/runtime/entry-server-template.ts +138 -17
package/tsconfig.build.json +1 -1
package/dist/__tests__/plugin/path-utils.test.d.ts +0 -2
package/dist/__tests__/plugin/path-utils.test.d.ts.map +0 -1
package/dist/__tests__/plugin/path-utils.test.js +0 -305
package/dist/__tests__/plugin/path-utils.test.js.map +0 -1
package/dist/__tests__/plugin/scanner.test.d.ts +0 -2
package/dist/__tests__/plugin/scanner.test.d.ts.map +0 -1
package/dist/__tests__/plugin/scanner.test.js +0 -143
package/dist/__tests__/plugin/scanner.test.js.map +0 -1
package/dist/__tests__/plugin/transforms/auto-import.test.d.ts +0 -2
package/dist/__tests__/plugin/transforms/auto-import.test.d.ts.map +0 -1
package/dist/__tests__/plugin/transforms/auto-import.test.js +0 -151
package/dist/__tests__/plugin/transforms/auto-import.test.js.map +0 -1
package/dist/__tests__/plugin/transforms/head-inject.test.d.ts +0 -2
package/dist/__tests__/plugin/transforms/head-inject.test.d.ts.map +0 -1
package/dist/__tests__/plugin/transforms/head-inject.test.js +0 -151
package/dist/__tests__/plugin/transforms/head-inject.test.js.map +0 -1
package/dist/__tests__/plugin/virtual/components.test.d.ts +0 -2
package/dist/__tests__/plugin/virtual/components.test.d.ts.map +0 -1
package/dist/__tests__/plugin/virtual/components.test.js +0 -47
package/dist/__tests__/plugin/virtual/components.test.js.map +0 -1
package/dist/__tests__/plugin/virtual/composables.test.d.ts +0 -2
package/dist/__tests__/plugin/virtual/composables.test.d.ts.map +0 -1
package/dist/__tests__/plugin/virtual/composables.test.js +0 -48
package/dist/__tests__/plugin/virtual/composables.test.js.map +0 -1
package/dist/__tests__/plugin/virtual/layouts.test.d.ts +0 -2
package/dist/__tests__/plugin/virtual/layouts.test.d.ts.map +0 -1
package/dist/__tests__/plugin/virtual/layouts.test.js +0 -59
package/dist/__tests__/plugin/virtual/layouts.test.js.map +0 -1
package/dist/__tests__/plugin/virtual/middleware.test.d.ts +0 -2
package/dist/__tests__/plugin/virtual/middleware.test.d.ts.map +0 -1
package/dist/__tests__/plugin/virtual/middleware.test.js +0 -58
package/dist/__tests__/plugin/virtual/middleware.test.js.map +0 -1
package/dist/__tests__/plugin/virtual/plugins.test.d.ts +0 -2
package/dist/__tests__/plugin/virtual/plugins.test.d.ts.map +0 -1
package/dist/__tests__/plugin/virtual/plugins.test.js +0 -73
package/dist/__tests__/plugin/virtual/plugins.test.js.map +0 -1
package/dist/__tests__/plugin/virtual/routes.test.d.ts +0 -2
package/dist/__tests__/plugin/virtual/routes.test.d.ts.map +0 -1
package/dist/__tests__/plugin/virtual/routes.test.js +0 -167
package/dist/__tests__/plugin/virtual/routes.test.js.map +0 -1
package/dist/__tests__/plugin/virtual/server-api.test.d.ts +0 -2
package/dist/__tests__/plugin/virtual/server-api.test.d.ts.map +0 -1
package/dist/__tests__/plugin/virtual/server-api.test.js +0 -72
package/dist/__tests__/plugin/virtual/server-api.test.js.map +0 -1
package/dist/__tests__/runtime/use-head.test.d.ts +0 -2
package/dist/__tests__/runtime/use-head.test.d.ts.map +0 -1
package/dist/__tests__/runtime/use-head.test.js +0 -202
package/dist/__tests__/runtime/use-head.test.js.map +0 -1
package/dist/__tests__/runtime/use-page-data.test.d.ts +0 -2
package/dist/__tests__/runtime/use-page-data.test.d.ts.map +0 -1
package/dist/__tests__/runtime/use-page-data.test.js +0 -41
package/dist/__tests__/runtime/use-page-data.test.js.map +0 -1

package/docs/data-loading.md CHANGED Viewed

@@ -8,7 +8,7 @@ Each page can export a `loader` function that runs on the server before the page
 ```ts
 // app/pages/blog/[slug].ts
-import type { PageLoader } from 'vite-plugin-cer-app/types'
+import type { PageLoader } from '@jasonshimmy/vite-plugin-cer-app/types'
 component('page-blog-slug', () => {
   const props = useProps({ slug: '', title: '', body: '' })
@@ -54,20 +54,21 @@ interface PageLoaderContext<P extends Record<string, string>> {
 1. A request arrives for `/blog/hello-world`
 2. The router matches `app/pages/blog/[slug].ts`
 3. The server calls `loader({ params: { slug: 'hello-world' }, query, req })`
-4. The returned data is serialized as `window.__CER_DATA__` in a `<script>` tag in the HTML:
+4. The returned data is serialized as `window.__CER_DATA__` in a `<script>` tag in the HTML `<head>`:
    ```html
    <script>window.__CER_DATA__ = {"title":"Hello World","body":"..."}</script>
    ```
-5. `renderToString` or `renderToStream` renders `<page-blog-slug>` with the data as props
-6. The full HTML is sent to the browser
+5. The server renders `<page-blog-slug>` directly into the layout using Declarative Shadow DOM
+6. The full HTML (pre-rendered content + client scripts) is sent to the browser
 ---
 ## Client hydration flow
-1. Browser receives the full HTML (no layout flash because of Declarative Shadow DOM)
-2. The runtime reads `window.__CER_DATA__` and passes the values as component props
-3. Components attach event listeners to the pre-rendered DOM — no re-fetch required
+1. Browser receives the full HTML — content is immediately visible via Declarative Shadow DOM before any JS runs
+2. Client JS boots; `usePageData()` reads `window.__CER_DATA__` and returns the hydrated values
+3. The value is cleared after the first read so subsequent client-side navigations trigger a fresh fetch
+4. Components that received SSR data skip their `useOnConnected` fetch — no duplicate request
 ---

package/docs/getting-started.md CHANGED Viewed

@@ -49,7 +49,7 @@ npx create-cer-app my-app --mode ssr
 ### 1. Install
 ```sh
-npm install -D vite-plugin-cer-app
+npm install -D @jasonshimmy/vite-plugin-cer-app
 npm install @jasonshimmy/custom-elements-runtime
 ```
@@ -58,7 +58,7 @@ npm install @jasonshimmy/custom-elements-runtime
 ```ts
 // vite.config.ts
 import { defineConfig } from 'vite'
-import { cerApp } from 'vite-plugin-cer-app'
+import { cerApp } from '@jasonshimmy/vite-plugin-cer-app'
 export default defineConfig({
   plugins: [cerApp()],
@@ -69,7 +69,7 @@ Or use a separate `cer.config.ts` (picked up automatically by the CLI, and passe
 ```ts
 // cer.config.ts
-import { defineConfig } from 'vite-plugin-cer-app'
+import { defineConfig } from '@jasonshimmy/vite-plugin-cer-app'
 export default defineConfig({
   mode: 'spa',
@@ -79,7 +79,7 @@ export default defineConfig({
 ```ts
 // vite.config.ts (when using cer.config.ts)
 import { defineConfig } from 'vite'
-import { cerApp } from 'vite-plugin-cer-app'
+import { cerApp } from '@jasonshimmy/vite-plugin-cer-app'
 import cerConfig from './cer.config.ts'
 export default defineConfig({
@@ -127,7 +127,7 @@ component('layout-default', () => {
     <title>My App</title>
   </head>
   <body>
-    <router-view></router-view>
+    <cer-layout-view></cer-layout-view>
     <script type="module" src="/app/app.ts"></script>
   </body>
 </html>

package/docs/head-management.md CHANGED Viewed

@@ -10,7 +10,7 @@ The `useHead()` composable manages `<title>`, `<meta>`, `<link>`, `<script>`, an
 ## Import
 ```ts
-import { useHead } from 'vite-plugin-cer-app/composables'
+import { useHead } from '@jasonshimmy/vite-plugin-cer-app/composables'
 ```
 ---
@@ -175,10 +175,10 @@ Style tags are not deduplicated.
 During SSR rendering, `useHead()` calls are collected via a request-scoped array. After rendering is complete, the collected tags are serialized and injected before `</head>` in the HTML shell.
-You can use the underlying primitives directly from `vite-plugin-cer-app/composables` if you need manual control:
+You can use the underlying primitives directly from `@jasonshimmy/vite-plugin-cer-app/composables` if you need manual control:
 ```ts
-import { beginHeadCollection, endHeadCollection, serializeHeadTags } from 'vite-plugin-cer-app/composables'
+import { beginHeadCollection, endHeadCollection, serializeHeadTags } from '@jasonshimmy/vite-plugin-cer-app/composables'
 // Before rendering:
 beginHeadCollection()

package/docs/middleware.md CHANGED Viewed

@@ -15,7 +15,7 @@ Create a file in `app/middleware/`. It runs before every route navigation:
 ```ts
 // app/middleware/auth.ts
-import type { RouteMiddleware } from 'vite-plugin-cer-app/types'
+import type { RouteMiddleware } from '@jasonshimmy/vite-plugin-cer-app/types'
 const auth: RouteMiddleware = async (to, from, next) => {
   const session = await getSession()
@@ -89,7 +89,7 @@ Server middleware runs on the HTTP level — before API routes and before SSR re
 ```ts
 // server/middleware/cors.ts
-import type { ServerMiddleware } from 'vite-plugin-cer-app/types'
+import type { ServerMiddleware } from '@jasonshimmy/vite-plugin-cer-app/types'
 const cors: ServerMiddleware = (req, res, next) => {
   res.setHeader('Access-Control-Allow-Origin', '*')

package/docs/plugins.md CHANGED Viewed

@@ -8,7 +8,7 @@ Plugins are loaded once before the app renders. They receive an `app` context wi
 ```ts
 // app/plugins/01.store.ts
-import type { AppPlugin } from 'vite-plugin-cer-app/types'
+import type { AppPlugin } from '@jasonshimmy/vite-plugin-cer-app/types'
 import { createStore } from '@jasonshimmy/custom-elements-runtime/store'
 export default {

package/docs/rendering-modes.md CHANGED Viewed

@@ -22,7 +22,7 @@ The simplest mode. Vite builds a standard client-only bundle. No server required
 ### How it works
-- `index.html` is the entry point with `<router-view>` as the root element
+- `index.html` is the entry point with `<cer-layout-view>` as the app mount element
 - All routing is client-side; the server returns the same `index.html` for every URL
 - `virtual:cer-routes` injects all routes into the client-side router

package/docs/routing.md CHANGED Viewed

@@ -94,7 +94,7 @@ Export a `meta` object from any page file to customize behavior:
 ```ts
 // app/pages/blog/[slug].ts
-import type { PageMeta } from 'vite-plugin-cer-app/types'
+import type { PageMeta } from '@jasonshimmy/vite-plugin-cer-app/types'
 component('page-blog-slug', () => { /* ... */ })

package/docs/server-api.md CHANGED Viewed

@@ -10,7 +10,7 @@ Export one function per HTTP method. Method names must be uppercase:
 ```ts
 // server/api/users/index.ts  →  GET /api/users, POST /api/users
-import type { ApiHandler } from 'vite-plugin-cer-app/types'
+import type { ApiHandler } from '@jasonshimmy/vite-plugin-cer-app/types'
 export const GET: ApiHandler = async (req, res) => {
   const users = await db.user.findAll()
@@ -160,6 +160,15 @@ export default async function handler(req, res) {
 | **SPA production** | Not included — deploy API routes separately or use a proxy |
 | **SSG production** | Optionally called at build time for data; otherwise deployed separately |
+### SPA mode — by design
+In SPA mode (`mode: 'spa'`) the build output is a pure client bundle with no server component. API routes defined in `server/api/` are **only active during development** (Vite dev server middleware). At runtime the SPA has no server to serve them from.
+Options for SPA + API:
+- **Separate API server** — deploy a Node.js/Express server alongside the SPA that mounts the same `server/api/` handlers.
+- **Reverse proxy** — proxy `/api/*` requests from your CDN or web server to a backend service.
+- **Switch to SSR mode** — `mode: 'ssr'` gives you a full Node.js server that serves both the SSR pages and the API routes from a single process.
 ---
 ## Virtual module

package/docs/testing.md CHANGED Viewed

@@ -9,7 +9,7 @@ This guide walks through how to manually test every major feature of the framewo
 Build the plugin first:
 ```sh
-cd /path/to/vite-plugin-cer-app
+cd /path/to/@jasonshimmy/vite-plugin-cer-app
 npm install
 npm run build
 ```
@@ -31,7 +31,7 @@ node dist/cli/create/index.js my-ssg  --mode ssg
 In each directory, install dependencies and link the plugin:
 ```sh
-cd my-spa && npm install && npm link /path/to/vite-plugin-cer-app
+cd my-spa && npm install && npm link /path/to/@jasonshimmy/vite-plugin-cer-app
 ```
 ### Start the dev server
@@ -325,7 +325,7 @@ EOF
 ```ts
 // app/pages/about.ts
-import { useHead } from 'vite-plugin-cer-app/composables'
+import { useHead } from '@jasonshimmy/vite-plugin-cer-app/composables'
 component('page-about', () => {
   useHead({
@@ -431,7 +431,7 @@ cat dist/items/1/index.html  # should contain "Item 1"
 The framework ships with 211 unit and integration tests:
 ```sh
-cd /path/to/vite-plugin-cer-app
+cd /path/to/@jasonshimmy/vite-plugin-cer-app
 npm test
 ```

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@jasonshimmy/vite-plugin-cer-app",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Nuxt-style meta-framework for @jasonshimmy/custom-elements-runtime",
   "type": "module",
   "keywords": [

package/src/__tests__/index.test.ts ADDED Viewed

@@ -0,0 +1,21 @@
+import { describe, it, expect } from 'vitest'
+// Import from the main package entry to trigger coverage of src/index.ts
+// re-exports. These are all re-exports of other modules so we just verify
+// the named exports resolve without errors.
+import { defineConfig, cerApp } from '../index.js'
+describe('package main entry', () => {
+  it('exports defineConfig', () => {
+    expect(typeof defineConfig).toBe('function')
+  })
+  it('defineConfig is a pass-through', () => {
+    const cfg = { mode: 'spa' as const }
+    expect(defineConfig(cfg)).toBe(cfg)
+  })
+  it('exports cerApp', () => {
+    expect(typeof cerApp).toBe('function')
+  })
+})

package/src/__tests__/plugin/build-ssg.test.ts ADDED Viewed

@@ -0,0 +1,265 @@
+import { vi, describe, it, expect, beforeEach } from 'vitest'
+vi.mock('node:fs', () => ({ existsSync: vi.fn().mockReturnValue(false) }))
+vi.mock('node:fs/promises', () => ({
+  writeFile: vi.fn().mockResolvedValue(undefined),
+  mkdir: vi.fn().mockResolvedValue(undefined),
+}))
+vi.mock('fast-glob', () => ({ default: vi.fn().mockResolvedValue([]) }))
+vi.mock('vite', () => ({
+  build: vi.fn().mockResolvedValue(undefined),
+  createServer: vi.fn(),
+}))
+vi.mock('../../plugin/build-ssr.js', () => ({ buildSSR: vi.fn().mockResolvedValue(undefined) }))
+vi.mock('../../plugin/path-utils.js', () => ({ buildRouteEntry: vi.fn() }))
+import { existsSync } from 'node:fs'
+import { writeFile, mkdir } from 'node:fs/promises'
+import fg from 'fast-glob'
+import { createServer } from 'vite'
+import { buildSSR } from '../../plugin/build-ssr.js'
+import { buildRouteEntry } from '../../plugin/path-utils.js'
+import { buildSSG } from '../../plugin/build-ssg.js'
+import type { ResolvedCerConfig } from '../../plugin/dev-server.js'
+function makeConfig(overrides: Partial<ResolvedCerConfig> = {}): ResolvedCerConfig {
+  return {
+    root: '/project',
+    srcDir: '/project/app',
+    pagesDir: '/project/app/pages',
+    mode: 'ssg',
+    ssr: { dsd: true },
+    ssg: { concurrency: 4 },
+    ...overrides,
+  } as unknown as ResolvedCerConfig
+}
+beforeEach(() => {
+  vi.mocked(buildSSR).mockClear()
+  vi.mocked(writeFile).mockClear()
+  vi.mocked(mkdir).mockClear()
+  vi.mocked(fg).mockClear()
+  vi.mocked(existsSync).mockReturnValue(false)
+  vi.mocked(fg).mockResolvedValue([])
+  vi.mocked(buildRouteEntry).mockReset()
+})
+describe('buildSSG — buildSSR delegation', () => {
+  it('calls buildSSR as step 1', async () => {
+    await buildSSG(makeConfig())
+    expect(buildSSR).toHaveBeenCalledTimes(1)
+  })
+  it('passes the config to buildSSR', async () => {
+    const config = makeConfig()
+    await buildSSG(config)
+    expect(vi.mocked(buildSSR).mock.calls[0][0]).toBe(config)
+  })
+})
+describe('buildSSG — ssg-manifest.json', () => {
+  it('writes ssg-manifest.json to the dist directory', async () => {
+    await buildSSG(makeConfig())
+    const manifestCall = vi.mocked(writeFile).mock.calls.find(([path]) =>
+      String(path).includes('ssg-manifest.json'),
+    )
+    expect(manifestCall).toBeDefined()
+    expect(String(manifestCall![0])).toContain('/project/dist/ssg-manifest.json')
+  })
+  it('manifest JSON contains generatedAt field', async () => {
+    await buildSSG(makeConfig())
+    const manifestCall = vi.mocked(writeFile).mock.calls.find(([p]) =>
+      String(p).includes('ssg-manifest.json'),
+    )
+    const manifest = JSON.parse(String(manifestCall![1]))
+    expect(manifest).toHaveProperty('generatedAt')
+    expect(typeof manifest.generatedAt).toBe('string')
+  })
+  it('manifest JSON contains paths array', async () => {
+    await buildSSG(makeConfig())
+    const manifestCall = vi.mocked(writeFile).mock.calls.find(([p]) =>
+      String(p).includes('ssg-manifest.json'),
+    )
+    const manifest = JSON.parse(String(manifestCall![1]))
+    expect(manifest).toHaveProperty('paths')
+    expect(Array.isArray(manifest.paths)).toBe(true)
+  })
+  it('manifest JSON contains errors array', async () => {
+    await buildSSG(makeConfig())
+    const manifestCall = vi.mocked(writeFile).mock.calls.find(([p]) =>
+      String(p).includes('ssg-manifest.json'),
+    )
+    const manifest = JSON.parse(String(manifestCall![1]))
+    expect(manifest).toHaveProperty('errors')
+    expect(Array.isArray(manifest.errors)).toBe(true)
+  })
+  it('records render errors in manifest (missing server bundle)', async () => {
+    const config = makeConfig({ ssg: { routes: ['/about'], concurrency: 1 } } as Partial<ResolvedCerConfig>)
+    await buildSSG(config)
+    const manifestCall = vi.mocked(writeFile).mock.calls.find(([p]) =>
+      String(p).includes('ssg-manifest.json'),
+    )
+    const manifest = JSON.parse(String(manifestCall![1]))
+    // paths + errors together must cover every route we attempted to render
+    expect(manifest.paths.length + manifest.errors.length).toBe(1)
+  })
+  it('error entries have path and error fields', async () => {
+    const config = makeConfig({ ssg: { routes: ['/fail'], concurrency: 1 } } as Partial<ResolvedCerConfig>)
+    await buildSSG(config)
+    const manifestCall = vi.mocked(writeFile).mock.calls.find(([p]) =>
+      String(p).includes('ssg-manifest.json'),
+    )
+    const manifest = JSON.parse(String(manifestCall![1]))
+    if (manifest.errors.length > 0) {
+      expect(manifest.errors[0]).toHaveProperty('path')
+      expect(manifest.errors[0]).toHaveProperty('error')
+    }
+  })
+})
+describe('buildSSG — path collection', () => {
+  it('uses ssg.routes when explicitly provided (skips auto-discovery)', async () => {
+    const config = makeConfig({
+      ssg: { routes: ['/a', '/b'], concurrency: 1 },
+    } as Partial<ResolvedCerConfig>)
+    await buildSSG(config)
+    // fast-glob should NOT have been called — routes are explicit
+    expect(fg).not.toHaveBeenCalled()
+  })
+  it('calls fg when pagesDir exists and no explicit routes', async () => {
+    vi.mocked(existsSync).mockReturnValue(true)
+    await buildSSG(makeConfig())
+    expect(fg).toHaveBeenCalledTimes(1)
+  })
+  it('skips Vite dev server when all discovered pages are static', async () => {
+    vi.mocked(existsSync).mockReturnValue(true)
+    vi.mocked(fg).mockResolvedValue([
+      '/project/app/pages/index.ts',
+      '/project/app/pages/about.ts',
+    ])
+    vi.mocked(buildRouteEntry)
+      .mockReturnValueOnce({ routePath: '/', isDynamic: false, isCatchAll: false } as ReturnType<typeof buildRouteEntry>)
+      .mockReturnValueOnce({ routePath: '/about', isDynamic: false, isCatchAll: false } as ReturnType<typeof buildRouteEntry>)
+    await buildSSG(makeConfig())
+    expect(createServer).not.toHaveBeenCalled()
+  })
+  it('spawns Vite dev server for dynamic pages', async () => {
+    vi.mocked(existsSync).mockReturnValue(true)
+    vi.mocked(fg).mockResolvedValue(['/project/app/pages/[slug].ts'])
+    vi.mocked(buildRouteEntry).mockReturnValueOnce({
+      routePath: '/:slug',
+      isDynamic: true,
+      isCatchAll: false,
+    } as ReturnType<typeof buildRouteEntry>)
+    const closeFn = vi.fn().mockResolvedValue(undefined)
+    vi.mocked(createServer).mockResolvedValue({
+      ssrLoadModule: vi.fn().mockResolvedValue({}),
+      close: closeFn,
+    } as unknown as Awaited<ReturnType<typeof createServer>>)
+    await buildSSG(makeConfig())
+    expect(createServer).toHaveBeenCalledTimes(1)
+    expect(closeFn).toHaveBeenCalledTimes(1)
+  })
+  it('closes Vite dev server even when ssrLoadModule throws', async () => {
+    vi.mocked(existsSync).mockReturnValue(true)
+    vi.mocked(fg).mockResolvedValue(['/project/app/pages/[slug].ts'])
+    vi.mocked(buildRouteEntry).mockReturnValueOnce({
+      routePath: '/:slug',
+      isDynamic: true,
+      isCatchAll: false,
+    } as ReturnType<typeof buildRouteEntry>)
+    const closeFn = vi.fn().mockResolvedValue(undefined)
+    vi.mocked(createServer).mockResolvedValue({
+      ssrLoadModule: vi.fn().mockRejectedValue(new Error('load failed')),
+      close: closeFn,
+    } as unknown as Awaited<ReturnType<typeof createServer>>)
+    await buildSSG(makeConfig())
+    expect(closeFn).toHaveBeenCalledTimes(1)
+  })
+  it('expands dynamic ssg.paths into concrete URL paths', async () => {
+    vi.mocked(existsSync).mockReturnValue(true)
+    vi.mocked(fg).mockResolvedValue(['/project/app/pages/[id].ts'])
+    vi.mocked(buildRouteEntry).mockReturnValueOnce({
+      routePath: '/:id',
+      isDynamic: true,
+      isCatchAll: false,
+    } as ReturnType<typeof buildRouteEntry>)
+    const ssgPathsFn = vi.fn().mockResolvedValue([
+      { params: { id: '1' } },
+      { params: { id: '2' } },
+    ])
+    const closeFn = vi.fn().mockResolvedValue(undefined)
+    vi.mocked(createServer).mockResolvedValue({
+      ssrLoadModule: vi.fn().mockResolvedValue({ meta: { ssg: { paths: ssgPathsFn } } }),
+      close: closeFn,
+    } as unknown as Awaited<ReturnType<typeof createServer>>)
+    const config = makeConfig({ ssg: { concurrency: 1 } } as Partial<ResolvedCerConfig>)
+    await buildSSG(config)
+    // The manifest should attempt to render '/', '/1', '/2' (3 paths total)
+    const manifestCall = vi.mocked(writeFile).mock.calls.find(([p]) =>
+      String(p).includes('ssg-manifest.json'),
+    )
+    const manifest = JSON.parse(String(manifestCall![1]))
+    expect(manifest.paths.length + manifest.errors.length).toBe(3)
+  })
+  it('skips catch-all pages when auto-discovering paths', async () => {
+    vi.mocked(existsSync).mockReturnValue(true)
+    vi.mocked(fg).mockResolvedValue(['/project/app/pages/[...all].ts'])
+    vi.mocked(buildRouteEntry).mockReturnValueOnce({
+      routePath: '/:all*',
+      isDynamic: true,
+      isCatchAll: true,
+    } as ReturnType<typeof buildRouteEntry>)
+    await buildSSG(makeConfig())
+    // Only '/' (always added) should be attempted
+    const manifestCall = vi.mocked(writeFile).mock.calls.find(([p]) =>
+      String(p).includes('ssg-manifest.json'),
+    )
+    const manifest = JSON.parse(String(manifestCall![1]))
+    expect(manifest.paths.length + manifest.errors.length).toBe(1)
+  })
+  it('deduplicates collected paths', async () => {
+    vi.mocked(existsSync).mockReturnValue(true)
+    vi.mocked(fg).mockResolvedValue([
+      '/project/app/pages/index.ts',
+      '/project/app/pages/home.ts',
+    ])
+    // Both resolve to '/' — should deduplicate to a single path
+    vi.mocked(buildRouteEntry)
+      .mockReturnValueOnce({ routePath: '/', isDynamic: false, isCatchAll: false } as ReturnType<typeof buildRouteEntry>)
+      .mockReturnValueOnce({ routePath: '/', isDynamic: false, isCatchAll: false } as ReturnType<typeof buildRouteEntry>)
+    await buildSSG(makeConfig({ ssg: { concurrency: 1 } } as Partial<ResolvedCerConfig>))
+    const manifestCall = vi.mocked(writeFile).mock.calls.find(([p]) =>
+      String(p).includes('ssg-manifest.json'),
+    )
+    const manifest = JSON.parse(String(manifestCall![1]))
+    expect(manifest.paths.length + manifest.errors.length).toBe(1)
+  })
+})