@rudderjs/vite 0.0.5 → 0.0.7

package/README.md

@@ -1,6 +1,6 @@
 # @rudderjs/vite
 
-Vite plugin for RudderJS. Registers Vike (SSR), sets the `@/` path alias, externalizes server-only packages from the client bundle, and wires up WebSocket upgrade handling for `@rudderjs/broadcast` and `@rudderjs/live`.
+Vite plugin for RudderJS. Registers Vike (SSR), sets the `@/` path alias, externalizes server-only packages from the client bundle, and wires up WebSocket upgrade handling for `@rudderjs/broadcast` and `@rudderjs/sync`.
 
 ```bash
 pnpm add @rudderjs/vite
@@ -25,23 +25,34 @@ export default defineConfig({
 That's it. `rudderjs()` handles:
 
 - **Vike registration** — auto-detects and registers `vike/plugin` for SSR + file-based routing
-- **Path alias** — `@/` resolves to `src/` in the project root
+- **View scanner** — scans `app/Views/**` and generates virtual Vike pages under `pages/__view/` for `@rudderjs/view`
+- **HMR route reload** — watches `routes/`, `bootstrap/`, and `app/` so edits there invalidate the SSR module graph without restarting the dev server
+- **Path alias** — `@/` and `App/` resolve to the app directory
 - **SSR externals** — server-only packages (database drivers, Redis, queue adapters) are externalized from the client bundle
 - **SSR no-externals** — `@rudderjs/server-hono` is forced non-external so Vite processes virtual module imports
-- **WebSocket upgrade** — intercepts `http.createServer` to attach the `__rudderjs_ws_upgrade__` handler for `@rudderjs/broadcast` and `@rudderjs/live`
+- **WebSocket upgrade** — intercepts `http.createServer` to attach the `__rudderjs_ws_upgrade__` handler for `@rudderjs/broadcast` and `@rudderjs/sync`
+- **`x-real-ip` injection** — dev-only, populates the header from the Node socket so `req.ip` works through Vike's universal middleware
 - **Sourcemap warnings** — suppresses noisy "missing source files" warnings for `@rudderjs/*` packages
 - **Build externals** — server-only packages are excluded from production builds
 
 ## What it produces
 
-Three Vite plugins:
+Five Vite plugins:
 
 | Plugin | Purpose |
 |--------|---------|
-| `rudderjs:ws` | WebSocket upgrade handler via `configureServer` |
 | `rudderjs:config` | SSR externals, path alias, warning suppression |
+| `rudderjs:ws` | WebSocket upgrade handler via `configureServer` |
+| `rudderjs:ip` | Dev-only `x-real-ip` injection from Node socket |
+| `rudderjs:routes` | HMR watcher for `routes/` + `bootstrap/` + `app/`; invalidates SSR modules + clears `__rudderjs_instance__` and `__rudderjs_app__` globals so the next request re-bootstraps cleanly |
+| `rudderjs:views` | View scanner — generates virtual Vike pages from `app/Views/**` |
 | *(vike plugins)* | SSR rendering, file-based routing (auto-registered) |
 
+### HMR notes
+
+- `rudderjs:routes` never calls `server.restart()` — doing so closes Vite's module runner and breaks in-flight SSR requests. Module invalidation + globalThis cleanup is enough to force a full re-bootstrap on the next request.
+- Changes under `app/` require the full cleanup (not just invalidation) because models, controllers, and resources are captured in provider closures during boot.
+
 ## SSR Externals
 
 These packages are externalized from the SSR bundle (Node.js-only, not browser-compatible):

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AA+ClC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAqI5C;AAED,eAAe,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAqDlC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA8M5C;AAED,eAAe,QAAQ,CAAA"}

package/dist/index.js

@@ -1,7 +1,13 @@
 import path from 'node:path';
 import { createRequire } from 'node:module';
+import { viewsScannerPlugin } from './views-scanner.js';
 // ─── SSR / build externals ─────────────────────────────────
 const SSR_EXTERNALS = [
+    // @rudderjs/view — linked package, Vite's SSR module runner can't resolve
+    // it via its internal fetchModule path in non-workspace consumers (fresh
+    // scaffolded app + pnpm link). Loading it through Node's native ESM
+    // (which handles the symlink correctly) sidesteps the issue.
+    '@rudderjs/view',
     // CLI-only — uses node:process stdin/readline
     '@clack/core',
     '@clack/prompts',
@@ -62,6 +68,11 @@ export function rudderjs() {
     // Build plugins asynchronously — we need a dynamic import to guarantee we
     // load vike from the *app root* (not packages/vite/node_modules).
     const promise = (async () => {
+        // Construct the views scanner BEFORE loading Vike's plugin — the scanner's
+        // factory eagerly writes generated stubs to `pages/__view/`, and Vike scans
+        // the pages directory during its own plugin instantiation. If we load Vike
+        // first, the stubs don't exist yet and Vike will 404 on /__view/* routes.
+        const viewsScanner = viewsScannerPlugin();
         let vikePlugins = [];
         try {
             const vikePath = _require.resolve('vike/plugin');
@@ -73,11 +84,28 @@ export function rudderjs() {
         }
         return [
             ...vikePlugins,
+            viewsScanner,
+            {
+                // Inject x-real-ip header from the Node socket so downstream Hono
+                // middleware can read the client IP. Vike's universal-middleware
+                // converts the Express request to a Web Request which loses socket info.
+                name: 'rudderjs:ip',
+                configureServer(server) {
+                    server.middlewares.use((req, _res, next) => {
+                        if (!req.headers['x-real-ip'] && !req.headers['x-forwarded-for']) {
+                            const ip = req.socket?.remoteAddress;
+                            if (ip)
+                                req.headers['x-real-ip'] = ip;
+                        }
+                        next();
+                    });
+                },
+            },
             {
                 name: 'rudderjs:ws',
                 configureServer(server) {
                     // Attach the WebSocket upgrade handler to Vite's own HTTP server.
-                    // @rudderjs/broadcast and @rudderjs/live register their handlers on
+                    // @rudderjs/broadcast and @rudderjs/sync register their handlers on
                     // globalThis['__rudderjs_ws_upgrade__'] during provider boot. We listen
                     // for 'upgrade' events and forward them to that handler.
                     //
@@ -127,6 +155,43 @@ export function rudderjs() {
                     });
                 },
             },
+            {
+                name: 'rudderjs:routes',
+                configureServer(server) {
+                    // Watch route, bootstrap, and app files for SSR changes. These files
+                    // are dynamically imported during bootstrap or within route handlers
+                    // so Vite doesn't track them in its SSR module graph — changes go
+                    // unnoticed without an explicit watcher.
+                    const cwd = process.cwd();
+                    const watchDirs = [
+                        path.resolve(cwd, 'routes'),
+                        path.resolve(cwd, 'bootstrap'),
+                        path.resolve(cwd, 'app'),
+                    ];
+                    for (const dir of watchDirs)
+                        server.watcher.add(dir);
+                    server.watcher.on('change', (file) => {
+                        if (!watchDirs.some(d => file.startsWith(d)))
+                            return;
+                        // Clear the two top-level singletons so a new RudderJS + Application
+                        // pair is created when the module re-executes. App files (models,
+                        // resources, controllers) are captured in closures during bootstrap
+                        // so they also need a full re-bootstrap to pick up changes.
+                        const g = globalThis;
+                        delete g['__rudderjs_instance__'];
+                        delete g['__rudderjs_app__'];
+                        // Invalidate all SSR modules so Vike re-executes bootstrap/app.ts
+                        // (and transitively all app code) on the next request. This is
+                        // lighter than server.restart() and avoids closing the module runner
+                        // while requests may still be in flight.
+                        server.environments.ssr.moduleGraph.invalidateAll();
+                        // Tell the browser to do a full page reload so it picks up the
+                        // changes via a fresh SSR request.
+                        server.hot.send({ type: 'full-reload' });
+                        console.log(`[RudderJS] change detected — reloading (${path.relative(cwd, file)}`);
+                    });
+                },
+            },
             {
                 name: 'rudderjs:config',
                 configResolved(config) {
@@ -153,6 +218,18 @@ export function rudderjs() {
                                 { find: /^App\//, replacement: path.resolve(process.cwd(), 'app') + '/' },
                             ],
                         },
+                        // `@rudderjs/view` is imported from routes/web.ts during SSR. Vite's
+                        // first-run dep pre-bundler can't resolve it when the package is
+                        // linked via pnpm overrides in a non-workspace project (e.g. a
+                        // fresh scaffolded app pointing at a local rudderjs checkout) —
+                        // the second `vike dev` invocation succeeds because Vite's cache
+                        // is warm, but the first cold boot fails with a cryptic
+                        // "Cannot find module '@rudderjs/view'" error. Excluding it from
+                        // dep optimization lets Vite resolve it via normal Node ESM and
+                        // skips the flaky scan.
+                        optimizeDeps: {
+                            exclude: ['@rudderjs/view'],
+                        },
                         ssr: {
                             external: SSR_EXTERNALS,
                             noExternal: SSR_NO_EXTERNALS,

package/dist/index.js.map

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

package/dist/views-scanner.d.ts

@@ -0,0 +1,25 @@
+/**
+ * app/Views scanner — generates virtual Vike pages for files in `app/Views/**`.
+ *
+ * For a React project `app/Views/Dashboard.tsx` we emit:
+ *
+ *   pages/__view/dashboard/+Page.tsx     → re-exports user's view + reads viewProps from pageContext
+ *   pages/__view/dashboard/+route.ts     → pins the route to /dashboard
+ *   pages/__view/dashboard/+data.ts      → no-op; forces Vike client router to fetch pageContext
+ *
+ * The generated `pages/__view/` directory is gitignored. The plugin watches
+ * `app/Views/**` and regenerates on add/remove/rename.
+ *
+ * Framework selection is automatic — the scanner resolves `vike-react`,
+ * `vike-vue`, or `vike-solid` from the project's package.json at plugin
+ * construction time. If none are installed, the scanner falls back to
+ * **vanilla mode** (the "Blade equivalent"): `.ts`/`.js` views that export a
+ * function returning an HTML string, no client hydration.
+ */
+import type { Plugin } from 'vite';
+/**
+ * Vite plugin that scans `app/Views/**` and emits virtual Vike pages
+ * under `pages/__view/`. Watches the source directory in dev mode.
+ */
+export declare function viewsScannerPlugin(): Plugin;
+//# sourceMappingURL=views-scanner.d.ts.map

package/dist/views-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views-scanner.d.ts","sourceRoot":"","sources":["../src/views-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AA2UlC;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAgD3C"}

package/dist/views-scanner.js

@@ -0,0 +1,355 @@
+/**
+ * app/Views scanner — generates virtual Vike pages for files in `app/Views/**`.
+ *
+ * For a React project `app/Views/Dashboard.tsx` we emit:
+ *
+ *   pages/__view/dashboard/+Page.tsx     → re-exports user's view + reads viewProps from pageContext
+ *   pages/__view/dashboard/+route.ts     → pins the route to /dashboard
+ *   pages/__view/dashboard/+data.ts      → no-op; forces Vike client router to fetch pageContext
+ *
+ * The generated `pages/__view/` directory is gitignored. The plugin watches
+ * `app/Views/**` and regenerates on add/remove/rename.
+ *
+ * Framework selection is automatic — the scanner resolves `vike-react`,
+ * `vike-vue`, or `vike-solid` from the project's package.json at plugin
+ * construction time. If none are installed, the scanner falls back to
+ * **vanilla mode** (the "Blade equivalent"): `.ts`/`.js` views that export a
+ * function returning an HTML string, no client hydration.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+// ─── Framework detection ───────────────────────────────────
+/**
+ * Resolve which UI framework the project uses by probing `vike-*` packages
+ * in the app-root's node_modules. Runs once at plugin construction.
+ *
+ * Uses a direct fs check rather than `require.resolve` to avoid Node's
+ * module resolution cache (which can return stale hits in tests and when
+ * dependencies are swapped without a process restart).
+ */
+function detectFramework(cwd) {
+    const nodeModules = path.join(cwd, 'node_modules');
+    const installed = [];
+    for (const [pkg, fw] of [
+        ['vike-react', 'react'],
+        ['vike-vue', 'vue'],
+        ['vike-solid', 'solid'],
+    ]) {
+        if (fs.existsSync(path.join(nodeModules, pkg, 'package.json'))) {
+            installed.push(fw);
+        }
+    }
+    if (installed.length > 1) {
+        throw new Error(`[rudderjs:views-scanner] Multiple Vike renderers found (${installed.join(', ')}). ` +
+            `Install only one of vike-react, vike-vue, vike-solid.`);
+    }
+    return installed[0] ?? 'vanilla';
+}
+// ─── Extensions per framework ──────────────────────────────
+const EXTENSIONS_BY_FRAMEWORK = {
+    react: ['.tsx', '.jsx'],
+    vue: ['.vue'],
+    solid: ['.tsx', '.jsx'],
+    vanilla: ['.ts', '.js'],
+};
+// ─── Id / path helpers ─────────────────────────────────────
+function stripExt(file) {
+    return file.replace(/\.(tsx|jsx|vue|ts|js)$/i, '');
+}
+/** Convert `Dashboard.tsx` → `dashboard`, `Users/Show.tsx` → `users.show` */
+function fileToId(relPath) {
+    return stripExt(relPath)
+        .split(path.sep)
+        .map(seg => seg.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase())
+        .join('.');
+}
+function walk(dir, extensions, base = dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    const out = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...walk(full, extensions, base));
+        }
+        else if (extensions.some(e => entry.name.toLowerCase().endsWith(e))) {
+            out.push(path.relative(base, full));
+        }
+    }
+    return out;
+}
+/**
+ * Scan the view source for an optional `export const route = '...'` or
+ * `export const route = "..."` declaration and return its value. Matches
+ * TypeScript, JavaScript, and the <script setup> block inside a .vue file.
+ *
+ * Regex-based on purpose — parsing TS ASTs here would be overkill and
+ * introduce a dep. The pattern is strict enough that false positives require
+ * deliberate obfuscation.
+ */
+const ROUTE_EXPORT_RE = /(?:^|[\s;])export\s+const\s+route\s*(?::\s*string)?\s*=\s*['"`]([^'"`]+)['"`]/m;
+function readRouteOverride(absPath) {
+    try {
+        const source = fs.readFileSync(absPath, 'utf8');
+        const m = source.match(ROUTE_EXPORT_RE);
+        return m ? m[1] ?? null : null;
+    }
+    catch {
+        return null;
+    }
+}
+function discover(viewsRoot, pagesRoot, framework) {
+    const exts = EXTENSIONS_BY_FRAMEWORK[framework];
+    return walk(viewsRoot, exts).map(rel => {
+        const id = fileToId(rel);
+        const absPath = path.join(viewsRoot, rel);
+        // Use the App/ alias (already configured in @rudderjs/vite) so the
+        // generated import is portable across machines.
+        const importPath = `App/Views/${rel.replace(/\\/g, '/')}`;
+        const outDir = path.join(pagesRoot, '__view', ...id.split('.'));
+        const url = readRouteOverride(absPath) ?? '/' + id.replace(/\./g, '/');
+        return { id, absPath, importPath, outDir, url };
+    });
+}
+// ─── Stub generators ───────────────────────────────────────
+function reactStub(view) {
+    return {
+        filename: '+Page.tsx',
+        contents: `// AUTO-GENERATED by @rudderjs/vite — do not edit.
+// Source: ${view.importPath}
+import ViewComponent from '${view.importPath}'
+import { usePageContext } from 'vike-react/usePageContext'
+
+// Cast to a permissive component type — controller-supplied props are validated
+// at the call site (view('id', props)), not in this generated stub.
+const View = ViewComponent as unknown as (props: Record<string, unknown>) => JSX.Element
+
+export default function Page() {
+  const ctx = usePageContext() as unknown as { viewProps?: Record<string, unknown> }
+  const props = ctx.viewProps ?? {}
+  return <View {...props} />
+}
+`,
+    };
+}
+function solidStub(view) {
+    return {
+        filename: '+Page.tsx',
+        contents: `// AUTO-GENERATED by @rudderjs/vite — do not edit.
+// Source: ${view.importPath}
+import ViewComponent from '${view.importPath}'
+import { usePageContext } from 'vike-solid/usePageContext'
+
+const View = ViewComponent as unknown as (props: Record<string, unknown>) => JSX.Element
+
+export default function Page() {
+  const ctx = usePageContext() as unknown as { viewProps?: Record<string, unknown> }
+  return <View {...(ctx.viewProps ?? {})} />
+}
+`,
+    };
+}
+function vueStub(view) {
+    return {
+        filename: '+Page.vue',
+        contents: `<!-- AUTO-GENERATED by @rudderjs/vite — do not edit. -->
+<!-- Source: ${view.importPath} -->
+<script setup lang="ts">
+import ViewComponent from '${view.importPath}'
+import { usePageContext } from 'vike-vue/usePageContext'
+
+const pageContext = usePageContext()
+const viewProps = (pageContext as { viewProps?: Record<string, unknown> }).viewProps ?? {}
+</script>
+<template>
+  <ViewComponent v-bind="viewProps" />
+</template>
+`,
+    };
+}
+function vanillaStub(view) {
+    return {
+        filename: '+Page.ts',
+        contents: `// AUTO-GENERATED by @rudderjs/vite — do not edit.
+// Source: ${view.importPath}
+import renderView from '${view.importPath}'
+import type { PageContext } from 'vike/types'
+
+export function Page(pageContext: PageContext): string {
+  const viewProps = (pageContext as { viewProps?: Record<string, unknown> }).viewProps ?? {}
+  // View functions may return a plain string or a SafeString from @rudderjs/view's
+  // html\`\` tag. String(...) coerces both uniformly (SafeString.toString() returns
+  // its already-safe value).
+  const result = (renderView as (props: Record<string, unknown>) => unknown)(viewProps)
+  return typeof result === 'string' ? result : String(result)
+}
+`,
+    };
+}
+const STUB_GENERATORS = {
+    react: reactStub,
+    vue: vueStub,
+    solid: solidStub,
+    vanilla: vanillaStub,
+};
+// ─── Shared framework-agnostic files ───────────────────────
+/**
+ * No-op +data hook. Its presence forces Vike's client router to recognize
+ * this page as having a server-side hook (`hasServerOnlyHook: true`), which
+ * makes it fetch `pageContext.json` on every SPA navigation. Without this,
+ * navigating from a regular Vike page into a controller view skips the fetch
+ * entirely and renders the view with `viewProps = {}` — crashing the page.
+ * The actual viewProps are injected via `pageContextInit` from the controller's
+ * `renderPage()` call, not via this hook.
+ */
+const DATA_FILE_SOURCE = `// AUTO-GENERATED by @rudderjs/vite — do not edit.
+import type { PageContextServer } from 'vike/types'
+export const data = (_pageContext: PageContextServer): null => null
+`;
+function routeFileSource(view) {
+    // CRITICAL: the route URL must match the controller route the user registers
+    // (e.g. `Route.get('/home', () => view('home'))`). Vike's client router does
+    // its own route table lookup before fetching pageContext.json — if `/home`
+    // is not in the table, it falls back to a full page reload.
+    //
+    // By default, the view id maps 1:1 to the URL path ('home' → /home). A view
+    // file can override this by exporting a `route` constant at the top-level —
+    // useful when the controller's URL differs from the natural id path
+    // (e.g. `app/Views/Welcome.tsx` served at `/` instead of `/welcome`).
+    return `// AUTO-GENERATED by @rudderjs/vite — do not edit.
+export default '${view.url}'
+`;
+}
+/**
+ * Single shared config at the views root that tells Vike to serialize
+ * `viewProps` from server pageContext to the client. Without this, the
+ * server SSR works but hydration crashes because the client component
+ * receives `props = {}` (viewProps is undefined client-side).
+ */
+const VIEW_ROOT_CONFIG = `// AUTO-GENERATED by @rudderjs/vite — do not edit.
+// Forwards controller-supplied viewProps from server SSR to client hydration.
+import type { Config } from 'vike/types'
+
+export default {
+  passToClient: ['viewProps'],
+} satisfies Config
+`;
+// ─── File IO ───────────────────────────────────────────────
+const ALL_PAGE_FILENAMES = ['+Page.tsx', '+Page.jsx', '+Page.vue', '+Page.ts', '+Page.js'];
+function writeIfChanged(file, contents) {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    if (fs.existsSync(file)) {
+        const existing = fs.readFileSync(file, 'utf8');
+        if (existing === contents)
+            return false;
+    }
+    fs.writeFileSync(file, contents);
+    return true;
+}
+/** Remove any `+Page.*` file in this view's dir that isn't the current target. */
+function purgeStalePageFiles(outDir, keep) {
+    if (!fs.existsSync(outDir))
+        return;
+    for (const name of ALL_PAGE_FILENAMES) {
+        if (name === keep)
+            continue;
+        const p = path.join(outDir, name);
+        if (fs.existsSync(p))
+            fs.rmSync(p);
+    }
+}
+function generate(generatedRoot, views, framework) {
+    if (views.length === 0)
+        return;
+    writeIfChanged(path.join(generatedRoot, '+config.ts'), VIEW_ROOT_CONFIG);
+    const generator = STUB_GENERATORS[framework];
+    for (const v of views) {
+        const stub = generator(v);
+        purgeStalePageFiles(v.outDir, stub.filename);
+        writeIfChanged(path.join(v.outDir, stub.filename), stub.contents);
+        writeIfChanged(path.join(v.outDir, '+route.ts'), routeFileSource(v));
+        writeIfChanged(path.join(v.outDir, '+data.ts'), DATA_FILE_SOURCE);
+    }
+}
+function cleanStale(generatedRoot, current) {
+    if (!fs.existsSync(generatedRoot))
+        return;
+    const expected = new Set(current.map(v => v.outDir));
+    const walkDirs = (dir) => {
+        const out = [];
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const full = path.join(dir, entry.name);
+            // Leaf dirs are identified by a generated +route.ts (framework-agnostic).
+            if (fs.existsSync(path.join(full, '+route.ts'))) {
+                out.push(full);
+            }
+            else {
+                out.push(...walkDirs(full));
+            }
+        }
+        return out;
+    };
+    for (const dir of walkDirs(generatedRoot)) {
+        if (!expected.has(dir)) {
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+    }
+}
+// ─── Plugin ────────────────────────────────────────────────
+/**
+ * Vite plugin that scans `app/Views/**` and emits virtual Vike pages
+ * under `pages/__view/`. Watches the source directory in dev mode.
+ */
+export function viewsScannerPlugin() {
+    const cwd = process.cwd();
+    const viewsRoot = path.join(cwd, 'app', 'Views');
+    const pagesRoot = path.join(cwd, 'pages');
+    const generatedRoot = path.join(pagesRoot, '__view');
+    // Detect the framework lazily — only when we actually need to scan views.
+    // This keeps the plugin silent on projects that don't use app/Views/ at
+    // all (e.g. multi-framework scaffolder setups that install vike-react AND
+    // vike-vue for demo pages but never call view()). If detection is done
+    // eagerly, those projects crash at plugin construction with a "multiple
+    // renderers" error even though they don't touch @rudderjs/view.
+    let framework = null;
+    const getFramework = () => framework ??= detectFramework(cwd);
+    const sync = () => {
+        const fw = getFramework();
+        const views = discover(viewsRoot, pagesRoot, fw);
+        cleanStale(generatedRoot, views);
+        generate(generatedRoot, views, fw);
+    };
+    // Eager sync at plugin construction time — Vike scans `pages/` during its
+    // own plugin init, so the generated stubs MUST exist on disk before any
+    // Vite/Vike hook fires. configureServer/buildStart are too late.
+    if (fs.existsSync(viewsRoot))
+        sync();
+    return {
+        name: 'rudderjs:views-scanner',
+        enforce: 'pre',
+        buildStart() {
+            if (!fs.existsSync(viewsRoot))
+                return;
+            sync();
+        },
+        configureServer(server) {
+            if (!fs.existsSync(viewsRoot))
+                return;
+            server.watcher.add(viewsRoot);
+            const onChange = (file) => {
+                if (!file.startsWith(viewsRoot))
+                    return;
+                const exts = EXTENSIONS_BY_FRAMEWORK[getFramework()];
+                if (!exts.some(e => file.toLowerCase().endsWith(e)))
+                    return;
+                sync();
+            };
+            server.watcher.on('add', onChange);
+            server.watcher.on('unlink', onChange);
+            server.watcher.on('change', onChange);
+        },
+    };
+}
+//# sourceMappingURL=views-scanner.js.map

package/dist/views-scanner.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rudderjs/vite",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -52,7 +52,7 @@
     "dev": "tsc -p tsconfig.build.json --watch",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src",
-    "test": "tsc -p tsconfig.test.json && node --test dist-test/index.test.js; EXIT=$?; rm -rf dist-test; exit $EXIT",
+    "test": "tsc -p tsconfig.test.json && node --test dist-test/index.test.js dist-test/views-scanner.test.js; EXIT=$?; rm -rf dist-test; exit $EXIT",
     "clean": "rm -rf dist"
   }
 }