@octanejs/vite-plugin 0.1.5 → 0.1.9

package/CHANGELOG.md

@@ -1,254 +0,0 @@
-# @octanejs/vite-plugin
-
-## 0.1.5
-
-### Patch Changes
-
-- Updated dependencies [940ae5a]
-- Updated dependencies [6fceaf3]
-- Updated dependencies [62da8cc]
-- Updated dependencies [e737057]
-  - octane@0.1.5
-
-## 0.1.4
-
-### Patch Changes
-
-- 6d332ad: octane.config `adapter` is now the full deploy contract `{ name?, adapt?, serve?, runtime? }`: after the production server build, closeBundle runs `adapter.adapt({ root, outDir, clientDir, serverDir, log })` so an adapter package (e.g. `@octanejs/adapter-vercel`) can restructure the output for its platform (SvelteKit-style). All parts are optional and independent — `serve`/`runtime` keep their existing meanings. `@octanejs/adapter-vercel` is registered as a server-only package: client-side imports of it resolve to the browser stub (which now also covers the octane adapter surface, `vercel`/`adapt`) instead of dragging node builtins into the client graph.
-- 8fc8554: Production SSR builds — octane apps now deploy server-rendered instead of SPA-only:
-
-  - `vite build` produces BOTH bundles: hashed client assets in `{outDir}/client` (with the generated hydrate entry bundled into index.html via a static, Rollup-analyzable import map over the routes' entry/layout/preHydrate modules) and a self-contained SSR server at `{outDir}/server/entry.js` (app + octane bundled, only node builtins external; octane.config.ts is compiled in through a config-surface facade so neither the compiler nor vite ride along). The built index.html moves to `dist/server` — it is the SSR template, and leaving it in the static dir would shadow the handler at `/` on filesystem-first hosts.
-  - `createHandler` (`@octanejs/vite-plugin/production`) is implemented: it matches RenderRoutes/ServerRoutes, runs middleware chains, and streams via the same `renderToReadableStream` engine dev SSR uses — the rendered body region and the `#__octane_data` payload are byte-identical to dev, so `hydrateRoot()` adopts production responses unchanged (covered by an end-to-end fixture test). Per-route `<link rel="stylesheet">`/`modulepreload` tags come from the client manifest. `server.render: 'buffered'` in octane.config.ts switches to the await-everything `prerender` for hosts that break streamed responses.
-  - The server entry exports `handler` (Web fetch) and `nodeHandler` (Node `(req, res)`, for serverless wrappers such as a Vercel Node function), and auto-boots under `node dist/server/entry.js` — with the adapter's `serve()` when configured, else the new built-in Node server (`@octanejs/vite-plugin/node`) serving the client assets with immutable caching for `/assets/*`.
-  - `octane-preview` now runs that entry for real (pre-deploy verification) and accepts `--port`.
-
-- 3c56d95: Close the four metaframework gaps the octane website surfaced:
-
-  - `octane()` now accepts `exclude` and forwards it to the bundled compiler, so monorepo / aliased-to-source setups can skip the hook-slotting pass for hand-slot-forwarding binding sources (pnpm symlinks resolve `@octanejs/*` to `packages/*/src`, which the automatic node_modules skip can't see).
-  - The dev SSR middleware skips Vite-owned requests (`/@` namespaces, `/__` internals, node_modules, `?import`-style transform queries, and extension-bearing paths that name a real file under the Vite root/publicDir — dotted page URLs like `/docs/v2.0` still SSR) before route matching, so a catch-all `'/*splat'` RenderRoute can SSR a real not-found page without swallowing `/@vite/client` or `/src/*.ts`. `RenderRoute` also takes a `status` (e.g. 404 for the catch-all) applied to the rendered response.
-  - `appType: 'custom'` is now only a default: an explicit user `appType` wins, and `vite preview` is left on Vite's own SPA fallback so it can serve the client build (production SSR serving is still Phase 2).
-  - RenderRoute components (and layouts) receive the request `url` (pathname + search) alongside `params`, on the server and on the hydrating client, and the new `router.preHydrate` config names a module whose default export the client entry awaits before `hydrateRoot` — the hook an app-level client router uses to commit its match tree so hydration adopts the server DOM. The generated client entry also hides its dynamic imports from Vite's `?import` query injection so the page/hook share module singletons with statically-imported copies.
-
-  Dev SSR now streams: RenderRoutes render through `renderToReadableStream` (shell first, suspense boundaries flush out of order behind it) instead of the buffered `prerender`.
-
-- Updated dependencies [05fdef8]
-- Updated dependencies [e9ebfbf]
-- Updated dependencies [4ac4c98]
-- Updated dependencies [c2129eb]
-- Updated dependencies [4ac4c98]
-- Updated dependencies [8a44bb5]
-- Updated dependencies [6b0c244]
-- Updated dependencies [d3cf678]
-- Updated dependencies [05fdef8]
-- Updated dependencies [d19d4f3]
-- Updated dependencies [7e84258]
-- Updated dependencies [2f8c6ed]
-- Updated dependencies [8de4584]
-- Updated dependencies [9be6ba5]
-- Updated dependencies [db409de]
-- Updated dependencies [4f3c6c8]
-- Updated dependencies [62c3c4e]
-- Updated dependencies [3c56d95]
-- Updated dependencies [4c5b1d0]
-- Updated dependencies [b732399]
-- Updated dependencies [6d27cb0]
-- Updated dependencies [a3784b1]
-- Updated dependencies [fa77edf]
-- Updated dependencies [f5c9dba]
-- Updated dependencies [12d5410]
-- Updated dependencies [d71f1fc]
-- Updated dependencies [2f8c6ed]
-- Updated dependencies [63e51e8]
-- Updated dependencies [6d3b269]
-- Updated dependencies [b171c6d]
-- Updated dependencies [7f3d9c9]
-- Updated dependencies [820baaf]
-- Updated dependencies [c36cb32]
-- Updated dependencies [c33f409]
-- Updated dependencies [63e51e8]
-- Updated dependencies [8fc8554]
-- Updated dependencies [569daad]
-- Updated dependencies [6b7b727]
-- Updated dependencies [2ce7bc5]
-- Updated dependencies [c6a23f5]
-- Updated dependencies [c93aad5]
-- Updated dependencies [2942afb]
-- Updated dependencies [388b23c]
-- Updated dependencies [352cff1]
-- Updated dependencies [c7989eb]
-- Updated dependencies [dda2854]
-- Updated dependencies [dda2854]
-- Updated dependencies [3a9d855]
-- Updated dependencies [1f85217]
-  - octane@0.1.4
-
-## 0.1.3
-
-### Patch Changes
-
-- 3431ec3: SSR: the buffered renderers (`renderToString`/`renderToStaticMarkup` in
-  `octane/server`, `prerender` in `octane/static`) gain a `RenderOptions` argument:
-  `nonce` (CSP nonce stamped on the emitted inline `<style>` tags and the suspense seed
-  script — all renderers), plus `signal` (AbortSignal that rejects a suspended render
-  when the request dies) and `timeoutMs` (per-render override of the suspense settle
-  deadline) on the async `prerender`. `octane/server` now documents which exports are
-  the compiler's private ABI and exports the `executeServerFunction` RPC executor the
-  vite plugin's dev RPC handler loads via `ssrLoadModule('octane/server')` (previously a
-  missing export, so any `module server` call crashed). Wire format is devalue, matching
-  `@ripple-ts/adapter`'s client stub: devalue-encoded argument array in, devalue-encoded
-  `{ value }` envelope out. See the new `docs/ssr.md` for the full SSR guide and the
-  current gaps (streaming, selective hydration, production server build).
-- Updated dependencies [71b5167]
-- Updated dependencies [7b2acbd]
-- Updated dependencies [a000fa2]
-- Updated dependencies [71b5167]
-- Updated dependencies [735f5ca]
-- Updated dependencies [634c4b4]
-- Updated dependencies [1987d47]
-- Updated dependencies [fda2200]
-- Updated dependencies [71b5167]
-- Updated dependencies [fda2200]
-- Updated dependencies [3431ec3]
-- Updated dependencies [3afe217]
-- Updated dependencies [1a1f1db]
-- Updated dependencies [3431ec3]
-- Updated dependencies [5e3858f]
-- Updated dependencies [d2afbbb]
-- Updated dependencies [1987d47]
-- Updated dependencies [eb48930]
-- Updated dependencies [3431ec3]
-- Updated dependencies [87c5bc3]
-  - octane@0.1.3
-
-## 0.1.2
-
-### Patch Changes
-
-- b3a9191: Rename `hydrate` → `hydrateRoot` and adopt React 18's shape. The hydration entry is now `hydrateRoot(container, <App/>)` — container first — and returns a full `Root` (with `.render()` and `.unmount()`), symmetric with `createRoot`. Previously `hydrate(Component, container, props)` put the component first and returned only `{ unmount }`. After hydration the returned root's `.render()` performs a normal client update against the adopted DOM (no re-hydration). The vite-plugin's generated client entry now imports and calls `hydrateRoot`.
-- 43d940d: Exclude `@octanejs/tanstack-query` from esbuild pre-bundling (optimizeDeps.exclude + ssr.noExternal). It ships a `.tsrx` provider component, so — like `octane` itself — its source must flow through the octane `.tsrx` transform rather than being pre-bundled by esbuild.
-- cb9ad82: Rename the project from `vyre` to `octane`. The runtime now publishes as `octane` and the Vite metaframework plugin as `@octanejs/vite-plugin`. Identifiers inherited from the Ripple fork were also renamed to Octane (e.g. `setIsRippleActEnvironment` → `setIsOctaneActEnvironment`, the metaframework `ripple()` plugin → `octane()`, and the `ripple.config.ts` convention → `octane.config.ts`). References to the upstream Ripple framework and its `@ripple-ts`/`@tsrx` packages are unchanged.
-- fcac573: Unify the server-rendering ABI to props-first, matching the client. A component body is now invoked as `(props, scope, extra)` on the server (it used to be `(scope, props, extra)`). This makes a plain `function Foo(props)` used at a `<Foo/>` site work the same on the server as on the client — including components that return a non-JSX value (a primitive coerced to text, an early return, `null`). SSR markup is unchanged (only the invocation order flipped), so hydration is unaffected. The server layout/page wrappers in the vite-plugin were updated to match.
-- 634fd52: Align the SSR API with React and reshape the render result to `{ html, css }`.
-
-  The octane-invented `render(Component, props) → { head, body, css }` is replaced by
-  React-aligned entry points:
-
-  - `octane/server` (mirrors `react-dom/server`):
-    - `renderToString(element, props?, options?)` — a single synchronous pass; a Suspense
-      boundary that suspends renders its `@pending` fallback (no awaiting).
-    - `renderToStaticMarkup(element, props?, options?)` — clean, non-hydratable HTML (no block
-      or head-adoption markers, no suspense seed script).
-  - `octane/static` (NEW subpath, mirrors `react-dom/static`):
-    - `prerender(element, props?, options?)` — the await-everything behaviour of the old
-      `render()`: all Suspense data resolves and success arms render, returning complete HTML.
-
-  All three return `{ html, css }`. The separate `head` field is gone — hoisted `<title>`/
-  `<meta>`/`<link>` fold into `html` (spliced into `<head>` when the render produced a
-  document, else prepended), matching React 19's resource hoisting. `css` remains a distinct
-  field (octane has scoped CSS that React core does not). `render` is removed; the vite
-  plugin's dev SSR now uses `prerender`.
-
-- b3a9191: Fix the generated client hydration entry for routes with a layout. The layout's `children` ComponentBody was emitted with the old scope-first calling convention (`(s) => Component(s, { params })`), but octane's client runtime invokes a function child props-first as `({}, block, extra)` — so the page received the block as its props and rendered without its route data. The closure now calls `Component({ params }, scope, extra)`.
-- Updated dependencies [c19f1aa]
-- Updated dependencies [6983478]
-- Updated dependencies [6983478]
-- Updated dependencies [169c7c6]
-- Updated dependencies [86ae0c5]
-- Updated dependencies [357f841]
-- Updated dependencies [6675ac7]
-- Updated dependencies [f414710]
-- Updated dependencies [894d51c]
-- Updated dependencies [f44fb6b]
-- Updated dependencies [056c441]
-- Updated dependencies [aa9cc6e]
-- Updated dependencies [0f57f20]
-- Updated dependencies [f44fb6b]
-- Updated dependencies [067efa3]
-- Updated dependencies [f0c6c4d]
-- Updated dependencies [dd24fd5]
-- Updated dependencies [524939e]
-- Updated dependencies [e8ee0a8]
-- Updated dependencies [b680431]
-- Updated dependencies [524939e]
-- Updated dependencies [7f8dbc0]
-- Updated dependencies [a13acd1]
-- Updated dependencies [067efa3]
-- Updated dependencies [524939e]
-- Updated dependencies [894d51c]
-- Updated dependencies [894d51c]
-- Updated dependencies [1960647]
-- Updated dependencies [e8ee0a8]
-- Updated dependencies [93e2733]
-- Updated dependencies [149800c]
-- Updated dependencies [6983478]
-- Updated dependencies [6983478]
-- Updated dependencies [6983478]
-- Updated dependencies [169c7c6]
-- Updated dependencies [bbc3275]
-- Updated dependencies [ed6afad]
-- Updated dependencies [40bcb16]
-- Updated dependencies [c842fb7]
-- Updated dependencies [c62efa7]
-- Updated dependencies [524939e]
-- Updated dependencies [b3a9191]
-- Updated dependencies [ffe32c4]
-- Updated dependencies [e1f996b]
-- Updated dependencies [6983478]
-- Updated dependencies [fc36e15]
-- Updated dependencies [524939e]
-- Updated dependencies [405f06e]
-- Updated dependencies [f50c829]
-- Updated dependencies [b3a9191]
-- Updated dependencies [dd24fd5]
-- Updated dependencies [7042056]
-- Updated dependencies [6983478]
-- Updated dependencies [e031a7d]
-- Updated dependencies [86ae0c5]
-- Updated dependencies [a33cdd6]
-- Updated dependencies [067efa3]
-- Updated dependencies [fab1cb0]
-- Updated dependencies [6983478]
-- Updated dependencies [dd24fd5]
-- Updated dependencies [149800c]
-- Updated dependencies [6983478]
-- Updated dependencies [cb9ad82]
-- Updated dependencies [ea6352e]
-- Updated dependencies [1987bd7]
-- Updated dependencies [0c4d5a1]
-- Updated dependencies [dd24fd5]
-- Updated dependencies [fcac573]
-- Updated dependencies [41aa22a]
-- Updated dependencies [c842fb7]
-- Updated dependencies [6983478]
-- Updated dependencies [6983478]
-- Updated dependencies [634fd52]
-- Updated dependencies [149800c]
-- Updated dependencies [aafaaa9]
-- Updated dependencies [1987bd7]
-- Updated dependencies [74cbff9]
-- Updated dependencies [894d51c]
-- Updated dependencies [0040cad]
-- Updated dependencies [a3dce2f]
-- Updated dependencies [3656e32]
-- Updated dependencies [43d940d]
-- Updated dependencies [a032c5c]
-- Updated dependencies [7f8dbc0]
-- Updated dependencies [c71d4f3]
-- Updated dependencies [a3dce2f]
-- Updated dependencies [c2f3f69]
-- Updated dependencies [3656e32]
-- Updated dependencies [1987bd7]
-- Updated dependencies [f42e5b7]
-- Updated dependencies [cc2bca1]
-- Updated dependencies [6983478]
-- Updated dependencies [1987bd7]
-  - octane@0.1.2
-
-## 0.1.1
-
-### Patch Changes
-
-- [#1](https://github.com/octanejs/octane/pull/1) [`dcdf237`](https://github.com/octanejs/octane/commit/dcdf2375ce3a8a2e00b1e1de04f65c2529fd287e) Thanks [@trueadm](https://github.com/trueadm)! - Rename the project from `vyre` to `octane`. The runtime now publishes as `octane` and the Vite metaframework plugin as `@octanejs/vite-plugin`. Identifiers inherited from the Ripple fork were also renamed to Octane (e.g. `setIsRippleActEnvironment` → `setIsOctaneActEnvironment`, the metaframework `ripple()` plugin → `octane()`, and the `ripple.config.ts` convention → `octane.config.ts`). References to the upstream Ripple framework and its `@ripple-ts`/`@tsrx` packages are unchanged.
-
-- Updated dependencies [[`dcdf237`](https://github.com/octanejs/octane/commit/dcdf2375ce3a8a2e00b1e1de04f65c2529fd287e)]:
-  - octane@0.1.1

package/tests/_fixtures/app/index.html

@@ -1,11 +0,0 @@
-<!doctype html>
-<html lang="en">
-	<head>
-		<meta charset="utf-8" />
-		<title>Fixture</title>
-		<!--ssr-head-->
-	</head>
-	<body>
-		<div id="root"><!--ssr-body--></div>
-	</body>
-</html>

package/tests/_fixtures/app/octane.config.ts

@@ -1,14 +0,0 @@
-import { defineConfig, RenderRoute } from '@octanejs/vite-plugin';
-
-export default defineConfig({
-	router: {
-		routes: [
-			new RenderRoute({ path: '/', entry: ['Page', '/src/Page.tsrx'], layout: '/src/Layout.tsrx' }),
-			new RenderRoute({
-				path: '/pages/:slug',
-				entry: ['Page', '/src/Page.tsrx'],
-				layout: '/src/Layout.tsrx',
-			}),
-		],
-	},
-});

package/tests/_fixtures/app/package.json

@@ -1,7 +0,0 @@
-{
-  "name": "octane-vite-plugin-fixture-app",
-  "private": true,
-  "version": "0.0.0",
-  "type": "module",
-  "description": "Minimal app the production-build test builds end-to-end (node_modules is symlinked by the test setup)."
-}

package/tests/_fixtures/app/src/Layout.tsrx

@@ -1,6 +0,0 @@
-export default function Layout(props: { children: unknown }) @{
-	<div class="shell">
-		<nav>{'fixture-nav'}</nav>
-		{props.children}
-	</div>
-}

package/tests/_fixtures/app/src/Page.tsrx

@@ -1,17 +0,0 @@
-import { useState } from 'octane';
-
-// A page with a dynamic text hole, a param read, and an event handler — enough
-// to prove the server bundle renders hydratable markup (markers + scoped
-// state) identical to dev SSR.
-export function Page(props: { params: Record<string, string>; url: string }) @{
-	const [count] = useState(1);
-	<main>
-		<h1>
-			{'Fixture page ' + (props.params.slug ?? 'home')}
-		</h1>
-		<p class="url">{props.url}</p>
-		<p class="count">
-			{'Count: ' + count}
-		</p>
-	</main>
-}

package/tests/_fixtures/app/vite.config.ts

@@ -1,12 +0,0 @@
-import { defineConfig } from 'vite';
-import { octane } from '@octanejs/vite-plugin';
-
-// SSR module graphs (dev + server build) must see the server runtime for bare
-// 'octane' imports from non-compiled sources (none here, but keeps the fixture
-// shaped like a real app).
-export default defineConfig({
-	plugins: [octane()],
-	ssr: {
-		noExternal: [/^octane($|\/)/],
-	},
-});

package/tests/handler.test.ts

@@ -1,134 +0,0 @@
-// createHandler unit tests — the production handler's pure assembly decisions
-// (template splitting, hydration payload shape, status, preload tags, the
-// buffered fallback, server routes, 404) with stub renderers. The real-render
-// byte-compat path is covered end-to-end in production.test.ts.
-import { describe, it, expect } from 'vitest';
-import { createHandler } from '../src/server/production.js';
-import { RenderRoute, ServerRoute } from '../src/routes.js';
-
-const TEMPLATE = `<!doctype html>
-<html><head><!--ssr-head--></head><body><div id="root"><!--ssr-body--></div>
-<script type="module" src="/assets/hydrate-abc.js"></script></body></html>`;
-
-function Page() {
-	return '<main>page</main>';
-}
-
-function streamOf(text: string): ReadableStream<Uint8Array> {
-	return new ReadableStream({
-		start(controller) {
-			controller.enqueue(new TextEncoder().encode(text));
-			controller.close();
-		},
-	});
-}
-
-const baseDeps = {
-	renderToReadableStream: async () =>
-		streamOf('<style data-octane="x">.x{}</style><main>page</main>'),
-	prerender: async () => ({
-		html: '<main>page</main>',
-		css: '<style data-octane="x">.x{}</style>',
-	}),
-	htmlTemplate: TEMPLATE,
-	executeServerFunction: async () => '',
-};
-
-function makeManifest(overrides: Record<string, unknown> = {}) {
-	const routes = [
-		new RenderRoute({ path: '/', entry: ['Page', '/src/Page.tsrx'] }),
-		new RenderRoute({ path: '/*splat', entry: ['Page', '/src/Page.tsrx'], status: 404 }),
-		new ServerRoute({
-			path: '/api/ping',
-			handler: () => new Response('pong', { status: 200 }),
-		}),
-	];
-	return {
-		routes,
-		components: { '/src/Page.tsrx': { Page } },
-		layouts: {},
-		middlewares: [],
-		...overrides,
-	};
-}
-
-describe('createHandler', () => {
-	it('streams template prefix → render stream → suffix with the dev-shaped data script', async () => {
-		const handler = createHandler(makeManifest() as any, baseDeps as any);
-		const response = await handler(new Request('http://localhost/?q=1'));
-		expect(response.status).toBe(200);
-		const html = await response.text();
-
-		// Assembly: styles + markup inside #root, template suffix intact.
-		expect(html).toContain(
-			'<div id="root"><style data-octane="x">.x{}</style><main>page</main></div>',
-		);
-		expect(html).toContain('src="/assets/hydrate-abc.js"');
-
-		// The payload matches dev render-route.js: same keys, same order.
-		const payload = html.match(/__octane_data" type="application\/json">(.*?)<\/script>/s)![1];
-		expect(payload).toBe(
-			JSON.stringify({
-				entry: '/src/Page.tsrx',
-				exportName: 'Page',
-				layout: null,
-				routeIndex: 0,
-				params: {},
-				url: '/?q=1',
-				preHydrate: null,
-			}),
-		);
-	});
-
-	it('uses the RenderRoute status (catch-all 404) and route params', async () => {
-		const handler = createHandler(makeManifest() as any, baseDeps as any);
-		const response = await handler(new Request('http://localhost/not/a/page'));
-		expect(response.status).toBe(404);
-		const html = await response.text();
-		expect(html).toContain('"params":{"splat":"not/a/page"}');
-	});
-
-	it("render: 'buffered' awaits prerender and sends one document (css leads the body)", async () => {
-		let streamed = false;
-		const deps = {
-			...baseDeps,
-			renderToReadableStream: async () => {
-				streamed = true;
-				return streamOf('');
-			},
-		};
-		const handler = createHandler(makeManifest({ render: 'buffered' }) as any, deps as any);
-		const html = await (await handler(new Request('http://localhost/'))).text();
-		expect(streamed).toBe(false);
-		expect(html).toContain(
-			'<div id="root"><style data-octane="x">.x{}</style><main>page</main></div>',
-		);
-	});
-
-	it('emits stylesheet + modulepreload tags for the matched entry from clientAssets', async () => {
-		const handler = createHandler(
-			makeManifest({
-				clientAssets: {
-					'/src/Page.tsrx': { js: 'assets/Page-123.js', css: ['assets/Page-123.css'] },
-				},
-			}) as any,
-			baseDeps as any,
-		);
-		const html = await (await handler(new Request('http://localhost/'))).text();
-		expect(html).toContain('<link rel="stylesheet" href="/assets/Page-123.css">');
-		expect(html).toContain('<link rel="modulepreload" href="/assets/Page-123.js">');
-	});
-
-	it('serves ServerRoutes and 404s unmatched paths when no catch-all exists', async () => {
-		const manifest = makeManifest();
-		(manifest.routes as unknown[]).splice(1, 1); // drop the catch-all
-		const handler = createHandler(manifest as any, baseDeps as any);
-
-		const api = await handler(new Request('http://localhost/api/ping'));
-		expect(api.status).toBe(200);
-		expect(await api.text()).toBe('pong');
-
-		const missing = await handler(new Request('http://localhost/nope'));
-		expect(missing.status).toBe(404);
-	});
-});

package/tests/plugin.test.ts

@@ -1,155 +0,0 @@
-// @octanejs/vite-plugin unit tests — the pure decision logic the website
-// surfaced gaps in: the dev-middleware's Vite-owned URL filter, `octane()`
-// option forwarding to the bundled compiler, the appType default, and the
-// config resolution of `router.preHydrate` / RenderRoute `status`.
-import { fileURLToPath } from 'node:url';
-import { dirname } from 'node:path';
-import { describe, it, expect } from 'vitest';
-import { octane, isViteOwnedUrl, resolveOctaneConfig, RenderRoute } from '../src/index.js';
-import { RESOLVED_ADAPTER_BROWSER_STUB_ID } from '../src/project-codegen.js';
-
-function url(u: string): URL {
-	return new URL(u, 'http://localhost');
-}
-
-// Use this package as the fake Vite root: '/src/index.js' and '/types/index.d.ts'
-// are real files under it, '/docs/v2.0' etc. are not.
-const PKG_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
-
-describe('isViteOwnedUrl', () => {
-	it('skips Vite-internal namespaces and module/asset requests', () => {
-		expect(isViteOwnedUrl(url('/@vite/client'))).toBe(true);
-		expect(isViteOwnedUrl(url('/@id/virtual:octane-hydrate'))).toBe(true);
-		expect(isViteOwnedUrl(url('/@fs/Users/x/repo/src/main.ts'))).toBe(true);
-		expect(isViteOwnedUrl(url('/__open-in-editor?file=x'))).toBe(true);
-		expect(isViteOwnedUrl(url('/node_modules/.vite/deps/chunk.js'))).toBe(true);
-		expect(isViteOwnedUrl(url('/src/main.ts'))).toBe(true);
-		expect(isViteOwnedUrl(url('/src/app/App.tsrx?v=abc123'))).toBe(true);
-		expect(isViteOwnedUrl(url('/favicon.svg'))).toBe(true);
-		expect(isViteOwnedUrl(url('/src/worker?worker'))).toBe(true);
-		expect(isViteOwnedUrl(url('/src/logo?url'))).toBe(true);
-	});
-
-	it('keeps page navigations', () => {
-		expect(isViteOwnedUrl(url('/'))).toBe(false);
-		expect(isViteOwnedUrl(url('/docs'))).toBe(false);
-		expect(isViteOwnedUrl(url('/docs/quick-start'))).toBe(false);
-		expect(isViteOwnedUrl(url('/definitely/not/a/page'))).toBe(false);
-		expect(isViteOwnedUrl(url('/search?q=octane'))).toBe(false);
-		// A bare dotfile segment is not an extension.
-		expect(isViteOwnedUrl(url('/.well-known'))).toBe(false);
-		// VALUED params matching a marker name are app query strings — Vite's
-		// transform markers are always bare (`?url`, `?raw`, `&import`).
-		expect(isViteOwnedUrl(url('/docs?url=https://example.com'))).toBe(false);
-		expect(isViteOwnedUrl(url('/page?raw=1'))).toBe(false);
-		expect(isViteOwnedUrl(url('/jobs?worker=nurse'))).toBe(false);
-	});
-
-	it('with fileRoots, an extension only counts when a real file backs it', () => {
-		// Real files under the root → Vite's.
-		expect(isViteOwnedUrl(url('/src/index.js'), [PKG_ROOT])).toBe(true);
-		expect(isViteOwnedUrl(url('/types/index.d.ts?v=abc'), [PKG_ROOT])).toBe(true);
-		// Dotted PAGE urls → SSR them.
-		expect(isViteOwnedUrl(url('/docs/v2.0'), [PKG_ROOT])).toBe(false);
-		expect(isViteOwnedUrl(url('/users/jane.doe'), [PKG_ROOT])).toBe(false);
-		// A missing asset also SSRs (the app's 404 page beats a bare dev 404).
-		expect(isViteOwnedUrl(url('/missing.png'), [PKG_ROOT])).toBe(false);
-		// Multiple roots (root + publicDir).
-		expect(isViteOwnedUrl(url('/src/index.js'), ['/nowhere', PKG_ROOT])).toBe(true);
-		// Non-file checks are unaffected by fileRoots.
-		expect(isViteOwnedUrl(url('/@vite/client'), [PKG_ROOT])).toBe(true);
-		expect(isViteOwnedUrl(url('/src/worker?worker'), [PKG_ROOT])).toBe(true);
-	});
-});
-
-describe('octane() plugin factory', () => {
-	it('forwards `exclude` to the bundled compiler (hook-slotting skip)', () => {
-		const [compiler] = octane({ exclude: ['/packages/tanstack-router/src/'] });
-		const code =
-			"import { useState } from 'octane';\nexport function useThing() { return useState(0); }\n";
-		const transform = compiler.transform as (code: string, id: string) => unknown;
-
-		// A pnpm-symlinked binding source resolves to /packages/*/src — excluded,
-		// so the hand-slot-forwarding file passes through untouched.
-		expect(transform.call({}, code, '/repo/packages/tanstack-router/src/useRouter.ts')).toBeNull();
-		// App code is still slotted.
-		expect(transform.call({}, code, '/repo/src/useThing.ts')).not.toBeNull();
-	});
-
-	it("defaults appType to 'custom' for dev, but respects the user and `vite preview`", async () => {
-		const [, meta] = octane();
-		const config = meta.config as (
-			userConfig: object,
-			env: object,
-		) => Promise<{ appType?: string }>;
-
-		expect((await config({}, { command: 'serve', mode: 'development' })).appType).toBe('custom');
-		// An explicit user appType wins.
-		expect(
-			(await config({ appType: 'spa' }, { command: 'serve', mode: 'development' })).appType,
-		).toBe(undefined);
-		// `vite preview` serves static files with Vite's own fallback; the
-		// production SSR build is previewed with `octane-preview` instead.
-		expect(
-			(await config({}, { command: 'serve', mode: 'production', isPreview: true })).appType,
-		).toBe(undefined);
-	});
-});
-
-describe('resolveOctaneConfig', () => {
-	const entry = ['App', '/src/App.tsrx'] as const;
-
-	it('passes router.preHydrate through and validates its shape', () => {
-		const resolved = resolveOctaneConfig({
-			router: {
-				routes: [new RenderRoute({ path: '/', entry })],
-				preHydrate: '/src/pre-hydrate.ts',
-			},
-		});
-		expect(resolved.router.preHydrate).toBe('/src/pre-hydrate.ts');
-		// Absent stays absent.
-		expect(resolveOctaneConfig({}).router.preHydrate).toBe(undefined);
-		// Must be a Vite-root path the browser can dynamic-import.
-		expect(() =>
-			resolveOctaneConfig({ router: { routes: [], preHydrate: 'src/pre-hydrate.ts' } }),
-		).toThrow(/preHydrate/);
-	});
-
-	it('accepts an integer RenderRoute status and rejects anything else', () => {
-		const route = new RenderRoute({ path: '/*splat', entry, status: 404 });
-		expect(route.status).toBe(404);
-		expect(resolveOctaneConfig({ router: { routes: [route] } }).router.routes[0]).toBe(route);
-		expect(() =>
-			resolveOctaneConfig({
-				router: { routes: [new RenderRoute({ path: '/', entry, status: 4.04 })] },
-			}),
-		).toThrow(/status/);
-	});
-});
-
-describe('server-only adapter browser stub', () => {
-	const [, meta] = octane();
-	const resolveId = meta.resolveId as (
-		id: string,
-		importer?: string,
-		options?: { ssr?: boolean },
-	) => Promise<string | null>;
-	const load = meta.load as (id: string) => Promise<string | undefined>;
-
-	it('client-side imports of adapter packages resolve to the stub, server gets the real one', async () => {
-		for (const id of ['@octanejs/adapter-vercel', '@ripple-ts/adapter-node']) {
-			expect(await resolveId(id, undefined, { ssr: false })).toBe(RESOLVED_ADAPTER_BROWSER_STUB_ID);
-		}
-		expect(await resolveId('@octanejs/adapter-vercel', undefined, { ssr: true })).toBe(null);
-	});
-
-	it('the stub covers the octane adapter surface with no node builtins', async () => {
-		const source = (await load(RESOLVED_ADAPTER_BROWSER_STUB_ID)) as string;
-		// The union of the listed adapters' public names — a client import of any
-		// of them must resolve (and only throw on USE).
-		for (const name of ['vercel', 'adapt', 'serve']) {
-			expect(source).toContain(`export function ${name}`);
-		}
-		expect(source).not.toContain('node:');
-	});
-});