feat(nitro): add runtime app and render exports

shoma-mano · shoma-mano · commit 997d621fc9b2 · 2026-01-20T10:41:39.000+09:00
- Implemented `app.ts` to export `useNitroApp`.
- Implemented `render.ts` to export `defineRenderHandler`.

feat(nitro): add runtime types exports

- Created `index.ts` to export types: `NitroApp`, `RenderResponse`, and `RenderHandler`.

feat(nuxt): add core exports and page scanning functionality

- Implemented `index.ts` to export `loadNuxt` and `buildDir`.
- Added `scan.ts` to scan pages and generate routes code.

feat(vite): add virtual plugin for Vite

- Implemented `virtual.ts` to create a Vite plugin for handling virtual file system.
diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
@@ -2,6 +2,7 @@ import { defineConfig } from 'vitepress'
 
 // https://vitepress.dev/reference/site-config
 export default defineConfig({
+  base: '/chibinuxt/',
   title: 'chibinuxt',
   description: 'Build Your Own Nuxt - A Retro Adventure',
   srcDir: 'src',
diff --git a/impls/7-pages/packages/nuxt/src/app/plugins/router.ts b/impls/7-pages/packages/nuxt/src/app/plugins/router.ts
@@ -3,7 +3,7 @@ import {
   createMemoryHistory,
   createWebHistory,
 } from 'vue-router'
-
+// @ts-expect-error virtual module
 import routes from '#routes'
 
 export const createRouter = () => {
diff --git a/impls/9-nitro-rolldown/packages/nitro/src/runtime/app.ts b/impls/9-nitro-rolldown/packages/nitro/src/runtime/app.ts
@@ -0,0 +1 @@
+export { useNitroApp } from './internal/app'
diff --git a/impls/9-nitro-rolldown/packages/nitro/src/runtime/render.ts b/impls/9-nitro-rolldown/packages/nitro/src/runtime/render.ts
@@ -0,0 +1 @@
+export { defineRenderHandler } from './internal/render'
diff --git a/impls/9-nitro-rolldown/packages/nitro/src/types/runtime/index.ts b/impls/9-nitro-rolldown/packages/nitro/src/types/runtime/index.ts
@@ -0,0 +1 @@
+export type { NitroApp, RenderResponse, RenderHandler } from './nitro'
diff --git a/impls/9-nitro-rolldown/packages/nuxt/build.config.ts b/impls/9-nitro-rolldown/packages/nuxt/build.config.ts
@@ -4,22 +4,15 @@ export default defineBuildConfig({
   declaration: true,
   entries: [
     // Core
-    { input: 'src/index.mts' },
+    { input: 'src/index.ts' },
     // App
     { input: 'src/app/', outDir: 'dist/app/', ext: 'js' },
-    // Runtime dirs
-    ...['core', 'pages'].map(
-      name =>
-        ({
-          input: `src/${name}/runtime/`,
-          outDir: `dist/${name}/runtime`,
-          format: 'esm',
-          ext: 'js',
-        }) as BuildEntry,
-    ),
+    // Runtime
+    { input: 'src/core/runtime/', outDir: 'dist/core/runtime', format: 'esm', ext: 'js' },
+    // Bin
     { input: 'src/bin.ts' },
   ],
   alias: {
-    ['nuxt']: 'nuxt', // this is necessary for resolveAlias not to change id (https://github.com/unjs/unbuild/blob/997497b356b2ebe19112d2f6436a349a74885d68/src/builders/rollup/config.ts#L65)
+    ['nuxt']: 'nuxt',
   },
 })
diff --git a/impls/9-nitro-rolldown/packages/nuxt/src/app/entry.client.ts b/impls/9-nitro-rolldown/packages/nuxt/src/app/entry.client.ts
@@ -1,6 +1,7 @@
 import { createSSRApp } from 'vue'
-import App from '../../../../playground/App.vue'
 import { createRouter } from './plugins/router'
+// @ts-expect-error virtual module
+import App from '#app'
 
 const initApp = async () => {
   const router = createRouter()
diff --git a/impls/9-nitro-rolldown/packages/nuxt/src/app/entry.server.ts b/impls/9-nitro-rolldown/packages/nuxt/src/app/entry.server.ts
@@ -1,6 +1,7 @@
 import { createSSRApp } from 'vue'
-import App from '../../../../playground/App.vue'
 import { createRouter } from './plugins/router'
+// @ts-expect-error virtual module
+import App from '#app'
 
 export default async (ctx: { url: string }) => {
   const app = createSSRApp(App)
diff --git a/impls/9-nitro-rolldown/packages/nuxt/src/app/plugins/router.ts b/impls/9-nitro-rolldown/packages/nuxt/src/app/plugins/router.ts
@@ -1,23 +1,12 @@
 import {
-  type RouteRecordRaw,
   createRouter as _createRouter,
   createMemoryHistory,
   createWebHistory,
 } from 'vue-router'
-import Hello from '../../../../../playground/pages/hello.vue'
-import World from '../../../../../playground/pages/world.vue'
+// @ts-expect-error virtual module
+import routes from '#routes'
 
 export const createRouter = () => {
-  const routes = [
-    {
-      path: '/hello',
-      component: Hello,
-    },
-    {
-      path: '/world',
-      component: World,
-    },
-  ] satisfies RouteRecordRaw[]
   const history = import.meta.server
     ? createMemoryHistory()
     : createWebHistory()
diff --git a/impls/9-nitro-rolldown/packages/nuxt/src/bin.ts b/impls/9-nitro-rolldown/packages/nuxt/src/bin.ts
@@ -1,8 +1,7 @@
-#!/usr/bin/env node
-import { loadNuxt } from './index.mjs'
+#!/usr/bin/env bun
+import { loadNuxt } from './core/nuxt'
 
 const main = async () => {
-  process.env.DIST_DIR = import.meta.dirname
   const nuxt = await loadNuxt()
   nuxt.server.listen()
 }
diff --git a/impls/9-nitro-rolldown/packages/nuxt/src/core/nitro.ts b/impls/9-nitro-rolldown/packages/nuxt/src/core/nitro.ts
diff --git a/impls/9-nitro-rolldown/packages/nuxt/src/core/nuxt.ts b/impls/9-nitro-rolldown/packages/nuxt/src/core/nuxt.ts
@@ -1,42 +1,38 @@
-import { join } from 'node:path'
-import { build } from 'nitro'
+import { dirname, join, resolve } from 'node:path'
+import { build, createDevServer, createNitro } from 'nitro'
 import { bundle } from '@nuxt/vite-builder'
-import { distDir } from '../dir'
-import { initNitro } from './nitro'
+import { scanPages, generateRoutesCode } from '../pages/scan'
 
-type NuxtOptions = {
-  appDir?: string
+// Get the dist directory (handles chunks subdirectory from unbuild)
+let distDir = import.meta.dirname
+if (distDir.match(/(chunks|shared)$/)) {
+  distDir = dirname(distDir)
 }
 
-export type Nuxt = {
-  server?: any
-  options?: NuxtOptions
-  ready?: () => Promise<void>
-}
-
-const loadNuxtConfig = (): NuxtOptions => {
-  // implement later
-  return {}
-}
+export const buildDir = resolve(process.cwd(), '.nuxt')
+export const loadNuxt = async () => {
+  const appComponent = resolve(process.cwd(), 'App.vue')
+  const pagesDir = resolve(process.cwd(), 'pages')
 
-const createNuxt = (options: NuxtOptions): Nuxt => {
-  const nuxt: Nuxt = {
-    options,
-  }
-  return nuxt
-}
+  // Scan pages and generate routes code
+  const pages = await scanPages(pagesDir)
+  const routesCode = generateRoutesCode(pages)
 
-export const loadNuxt = async () => {
-  const options = loadNuxtConfig()
-  const appDir = join(distDir, 'app')
-  options.appDir = appDir
-  const nuxt = createNuxt(options)
-  const nitro = await initNitro(nuxt)
   await bundle({
-    appDistDir: appDir,
     clientEntry: join(distDir, 'app/entry.client.js'),
     serverEntry: join(distDir, 'app/entry.server.js'),
+    buildDir,
+    appComponent,
+    routesCode,
+  })
+
+  const nitro = await createNitro({
+    renderer: join(distDir, 'core/runtime/nitro/renderer.js'),
   })
+
+  // Build nitro server with rolldown
   await build(nitro)
-  return nuxt
+
+  const server = createDevServer(nitro)
+  return { server }
 }
diff --git a/impls/9-nitro-rolldown/packages/nuxt/src/core/runtime/nitro/renderer.ts b/impls/9-nitro-rolldown/packages/nuxt/src/core/runtime/nitro/renderer.ts
@@ -1,27 +1,32 @@
-import { join } from 'node:path'
+import { join, resolve } from 'node:path'
 import { readFileSync } from 'node:fs'
+import type { H3Event } from 'h3'
 import { defineRenderHandler } from 'nitro/runtime'
 import { createRenderer } from 'vue-bundle-renderer/runtime'
 import { renderToString } from 'vue/server-renderer'
 
-const distDir = process.env.DIST_DIR!
+const buildDir = resolve(process.cwd(), '.nuxt')
+
 let renderer: ReturnType<typeof createRenderer>
 const getRenderer = async () => {
   if (renderer) return renderer
-  const createApp = await import(join(distDir, 'app', '_entry.server.js')).then(
-    m => m.default,
-  )
+  const createApp = await import(
+    join(buildDir, 'entry.server.js')
+  ).then(m => m.default)
   renderer = createRenderer(createApp, {
     renderToString,
     manifest: {},
   })
   return renderer
 }
 
-export default defineRenderHandler(async event => {
+export default defineRenderHandler(async (event: H3Event) => {
   const { req, res } = event.node
   if (req.url === '/entry.client.js') {
-    const code = readFileSync(join(distDir, 'app', '_entry.client.js'), 'utf-8')
+    const code = readFileSync(
+      join(buildDir, 'entry.client.js'),
+      'utf-8',
+    )
     res.setHeader('Content-Type', 'application/javascript')
     res.end(code)
     return { statusCode: 200, statusMessage: 'OK', headers: {} }
diff --git a/impls/9-nitro-rolldown/packages/nuxt/src/dir.ts b/impls/9-nitro-rolldown/packages/nuxt/src/dir.ts
diff --git a/impls/9-nitro-rolldown/packages/nuxt/src/index.mts b/impls/9-nitro-rolldown/packages/nuxt/src/index.mts
diff --git a/impls/9-nitro-rolldown/packages/nuxt/src/index.ts b/impls/9-nitro-rolldown/packages/nuxt/src/index.ts
@@ -0,0 +1 @@
+export { loadNuxt, buildDir } from './core/nuxt'
diff --git a/impls/9-nitro-rolldown/packages/nuxt/src/pages/scan.ts b/impls/9-nitro-rolldown/packages/nuxt/src/pages/scan.ts
@@ -0,0 +1,43 @@
+import { readdir } from 'node:fs/promises'
+import { join, parse } from 'node:path'
+
+export interface NuxtPage {
+  name: string
+  path: string
+  file: string
+}
+
+export async function scanPages(pagesDir: string): Promise<NuxtPage[]> {
+  const files = await readdir(pagesDir)
+  const pages: NuxtPage[] = []
+
+  for (const file of files) {
+    const { name, ext } = parse(file)
+    if (ext !== '.vue') continue
+
+    const routePath = name === 'index' ? '/' : `/${name}`
+    pages.push({
+      name,
+      path: routePath,
+      file: join(pagesDir, file),
+    })
+  }
+
+  return pages
+}
+
+export function generateRoutesCode(pages: NuxtPage[]): string {
+  const imports = pages
+    .map((page, i) => `import Page${i} from '${page.file}'`)
+    .join('\n')
+
+  const routes = pages
+    .map((page, i) => `  { name: '${page.name}', path: '${page.path}', component: Page${i} }`)
+    .join(',\n')
+
+  return `${imports}
+
+export default [
+${routes}
+]`
+}
diff --git a/impls/9-nitro-rolldown/packages/vite/src/build.ts b/impls/9-nitro-rolldown/packages/vite/src/build.ts
@@ -1,27 +1,36 @@
 import { build as _build, mergeConfig, type InlineConfig } from 'vite'
 import vue from '@vitejs/plugin-vue'
+import { virtual } from './plugins/virtual'
 
 export interface BuildOptions {
-  appDistDir: string
+  buildDir: string
   clientEntry: string
   serverEntry: string
+  appComponent: string
+  routesCode: string
 }
 
 export const bundle = async (options: BuildOptions) => {
-  const { appDistDir, clientEntry, serverEntry } = options
+  const { buildDir, clientEntry, serverEntry, appComponent, routesCode } = options
+
+  // Virtual file system for #app and #routes modules
+  const vfs: Record<string, string> = {
+    '#app': `export { default } from '${appComponent}'`,
+    '#routes': routesCode,
+  }
 
   const defaultConfig = {
-    plugins: [vue()],
+    plugins: [vue(), virtual(vfs)],
     build: {
+      outDir: buildDir,
+      emptyOutDir: false,
       rollupOptions: {
         output: {
           format: 'esm',
-          dir: appDistDir,
         },
         preserveEntrySignatures: 'exports-only',
         treeshake: false,
       },
-      emptyOutDir: false,
     },
     define: {
       __VUE_PROD_HYDRATION_MISMATCH_DETAILS__: 'true',
@@ -33,7 +42,7 @@ export const bundle = async (options: BuildOptions) => {
       rollupOptions: {
         input: clientEntry,
         output: {
-          entryFileNames: '_entry.client.js',
+          entryFileNames: 'entry.client.js',
         },
       },
     },
@@ -49,7 +58,7 @@ export const bundle = async (options: BuildOptions) => {
       rollupOptions: {
         input: serverEntry,
         output: {
-          entryFileNames: '_entry.server.js',
+          entryFileNames: 'entry.server.js',
         },
       },
       ssr: true,
@@ -59,6 +68,4 @@ export const bundle = async (options: BuildOptions) => {
     },
   } satisfies InlineConfig)
   await _build(serverConfig)
-
-  console.log('Build completed successfully!')
 }
diff --git a/impls/9-nitro-rolldown/packages/vite/src/plugins/virtual.ts b/impls/9-nitro-rolldown/packages/vite/src/plugins/virtual.ts
@@ -0,0 +1,29 @@
+import type { Plugin } from 'vite'
+
+const PREFIX = 'virtual:nuxt:'
+
+export function virtual(vfs: Record<string, string>): Plugin {
+  return {
+    name: 'virtual',
+
+    resolveId(id) {
+      if (id in vfs) {
+        return PREFIX + id
+      }
+      return null
+    },
+
+    load(id) {
+      if (!id.startsWith(PREFIX)) {
+        return null
+      }
+      const idNoPrefix = id.slice(PREFIX.length)
+      if (idNoPrefix in vfs) {
+        return {
+          code: vfs[idNoPrefix],
+          map: null,
+        }
+      }
+    },
+  }
+}
diff --git a/impls/9-nitro-rolldown/playground/.nitro/dev/index.js b/impls/9-nitro-rolldown/playground/.nitro/dev/index.js
diff --git a/impls/9-nitro-rolldown/pnpm-lock.yaml b/impls/9-nitro-rolldown/pnpm-lock.yaml

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+export { useNitroApp } from './internal/app'`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+export { defineRenderHandler } from './internal/render'`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+export type { NitroApp, RenderResponse, RenderHandler } from './nitro'`