@octanejs/vite-plugin 0.1.5 → 0.1.6

package/types/index.d.ts

@@ -1,278 +1,48 @@
-import type { Plugin, BuildEnvironmentOptions, ViteDevServer } from 'vite';
-import type { RuntimePrimitives } from '@ripple-ts/adapter';
+import type { Plugin, ViteDevServer } from 'vite';
+import type {
+	ConfigModuleRunner,
+	LoadedOctaneConfig,
+	OctaneConfigOptions,
+	ResolvedOctaneConfig,
+} from '@octanejs/app-core';
 
-// ============================================================================
-// Plugin exports
-// ============================================================================
+export * from '@octanejs/app-core';
 
 export interface OctanePluginOptions {
 	/** Override the client HMR default (on in serve mode, off for SSR). */
 	hmr?: boolean;
 	/**
 	 * Path fragments the compiler's plain `.ts`/`.js` hook-slotting pass must
-	 * skip — hand-slot-forwarding library sources that would otherwise be
-	 * double-slotted. Published bindings live in node_modules and are skipped
-	 * automatically; set this for monorepo / aliased-to-source setups where
-	 * pnpm symlinks resolve `@octanejs/*` imports to `packages/*\/src` paths
-	 * (e.g. `['/packages/tanstack-router/src/']`).
+	 * skip. Prefer package manifest `octane.hookSlots.manual` declarations.
 	 */
 	exclude?: string[];
 }
 
-/**
- * The octane metaframework plugin. Returns an array:
- * `[octane(), metaPlugin]` — the first compiles `.tsrx`, the second owns
- * config / routing / dev SSR / hydrate.
- */
+/** The Octane compiler plugin plus Vite app/metaframework integration. */
 export function octane(options?: OctanePluginOptions): Plugin[];
 
-/**
- * Is this a request the Vite dev server owns (module / asset / internal
- * namespace / transform query), as opposed to a page navigation? The dev SSR
- * middleware uses it so a catch-all RenderRoute never swallows Vite requests.
- *
- * `fileRoots` (the Vite root + publicDir) gate the file-extension heuristic:
- * an extension-bearing path is only Vite's when it names a real file under
- * one of them, so page URLs like `/docs/v2.0` still SSR. Without `fileRoots`
- * any extension counts (conservative).
- */
+/** Return whether a dev request belongs to Vite rather than an app route. */
 export function isViteOwnedUrl(url: URL, fileRoots?: string[]): boolean;
-export function defineConfig(options: OctaneConfigOptions): OctaneConfigOptions;
+
+export interface ViteLoadConfigOptions {
+	vite?: ViteDevServer;
+	moduleRunner?: ConfigModuleRunner | ConfigModuleRunner['loadModule'];
+	requireAdapter?: boolean;
+	configFile?: string;
+	cacheDir?: string;
+}
+
+export function getOctaneConfigPath(projectRoot: string, configFile?: string): string;
+export function octaneConfigExists(projectRoot: string, configFile?: string): boolean;
+export function loadOctaneConfig(
+	projectRoot: string,
+	options?: ViteLoadConfigOptions,
+): Promise<ResolvedOctaneConfig>;
+export function loadOctaneConfigWithMetadata(
+	projectRoot: string,
+	options?: ViteLoadConfigOptions,
+): Promise<LoadedOctaneConfig>;
 export function resolveOctaneConfig(
 	raw: OctaneConfigOptions,
 	options?: { requireAdapter?: boolean },
 ): ResolvedOctaneConfig;
-export function getOctaneConfigPath(projectRoot: string): string;
-export function octaneConfigExists(projectRoot: string): boolean;
-export function loadOctaneConfig(
-	projectRoot: string,
-	options?: { vite?: ViteDevServer; requireAdapter?: boolean },
-): Promise<ResolvedOctaneConfig>;
-
-// ============================================================================
-// Route classes
-// ============================================================================
-
-export class RenderRoute {
-	readonly type: 'render';
-	path: string;
-	entry: RenderRouteEntry;
-	layout?: string;
-	before: Middleware[];
-	status?: number;
-	constructor(options: RenderRouteOptions);
-}
-
-export class ServerRoute {
-	readonly type: 'server';
-	path: string;
-	methods: string[];
-	handler: RouteHandler;
-	before: Middleware[];
-	after: Middleware[];
-	constructor(options: ServerRouteOptions);
-}
-
-export type Route = RenderRoute | ServerRoute;
-
-// ============================================================================
-// Route options
-// ============================================================================
-
-export interface RenderRouteOptions {
-	/** URL path pattern (e.g., '/', '/posts/:id', '/docs/*slug') */
-	path: string;
-	/** Path to the component entry file, optionally with a preferred named export */
-	entry: RenderRouteEntry;
-	/** Path to the layout component (wraps the entry) */
-	layout?: string;
-	/** Middleware to run before rendering */
-	before?: Middleware[];
-	/**
-	 * HTTP status for the rendered response (default 200). Set 404 on a
-	 * catch-all route so the SSR'd not-found page reports its real status.
-	 */
-	status?: number;
-}
-
-export interface ServerRouteOptions {
-	/** URL path pattern (e.g., '/api/hello', '/api/posts/:id') */
-	path: string;
-	/** HTTP methods to handle (default: ['GET']) */
-	methods?: string[];
-	/** Request handler that returns a Response */
-	handler: RouteHandler;
-	/** Middleware to run before the handler */
-	before?: Middleware[];
-	/** Middleware to run after the handler */
-	after?: Middleware[];
-}
-
-// ============================================================================
-// Context and middleware
-// ============================================================================
-
-export interface Context {
-	/** The incoming Request object */
-	request: Request;
-	/** URL parameters extracted from the route pattern */
-	params: Record<string, string>;
-	/** Parsed URL object */
-	url: URL;
-	/** Shared state for passing data between middlewares */
-	state: Map<string, unknown>;
-}
-
-export type NextFunction = () => Promise<Response>;
-export type Middleware = (context: Context, next: NextFunction) => Response | Promise<Response>;
-export type RouteHandler = (context: Context) => Response | Promise<Response>;
-
-// ============================================================================
-// Configuration
-// ============================================================================
-
-export type Component<T = Record<string, any>> = (
-	scope: any,
-	props: T,
-	extra?: any,
-) => string | void;
-
-export type RenderRouteEntry = string | readonly [exportName: string, path: string];
-
-/**
- * Props every RenderRoute component (and layout) receives: the route params
- * and the request `url` (pathname + search, origin-free — the client hydrate
- * entry re-renders with the identical string).
- */
-export interface RenderRouteProps {
-	params: Record<string, string>;
-	url: string;
-}
-
-/**
- * The app hook run by the client hydrate entry BEFORE `hydrateRoot` (config
- * `router.preHydrate`): commit client-side state the server already resolved —
- * typically a client router loading its match tree — so the first hydration
- * pass adopts the same tree the server rendered.
- */
-export type PreHydrateHook = (info: {
-	url: string;
-	params: Record<string, string>;
-}) => void | Promise<void>;
-
-export interface RootBoundaryOptions {
-	pending?: Component<Record<string, never>>;
-	catch?: Component<{ error: unknown; reset: () => void }>;
-}
-
-export interface OctaneConfigOptions {
-	build?: {
-		/** Output directory for the production build. @default 'dist' */
-		outDir?: string;
-		minify?: boolean;
-		target?: BuildEnvironmentOptions['target'];
-	};
-	adapter?: OctaneAdapter;
-	router?: {
-		routes: Route[];
-		/**
-		 * Vite-root path (e.g. '/src/pre-hydrate.ts') of a module whose default
-		 * export is a {@link PreHydrateHook}. The client hydrate entry imports it
-		 * and awaits the hook before calling `hydrateRoot`.
-		 */
-		preHydrate?: string;
-	};
-	/** Global root pending/catch UI used by client and SSR render roots */
-	rootBoundary?: RootBoundaryOptions;
-	/** Global middlewares applied to all routes */
-	middlewares?: Middleware[];
-	platform?: {
-		env: Record<string, string>;
-	};
-	server?: {
-		/**
-		 * Trust `X-Forwarded-Proto` / `X-Forwarded-Host` when deriving the
-		 * request origin. Enable only behind a trusted reverse proxy.
-		 * @default false
-		 */
-		trustProxy?: boolean;
-		/**
-		 * Production SSR mode: 'streaming' (default) flushes the shell at
-		 * first await and streams suspense segments out-of-order (same engine
-		 * as dev SSR); 'buffered' awaits everything (`prerender`) and sends
-		 * one document — for hosts that break streamed responses.
-		 * @default 'streaming'
-		 */
-		render?: 'streaming' | 'buffered';
-	};
-}
-
-/**
- * Resolved configuration with all defaults applied.
- */
-export interface ResolvedOctaneConfig {
-	build: {
-		/** @default 'dist' */
-		outDir: string;
-		minify?: boolean;
-		target?: BuildEnvironmentOptions['target'];
-	};
-	adapter?: OctaneAdapter;
-	router: {
-		routes: Route[];
-		preHydrate?: string;
-	};
-	rootBoundary: RootBoundaryOptions;
-	/** @default [] */
-	middlewares: Middleware[];
-	platform: {
-		/** @default {} */
-		env: Record<string, string>;
-	};
-	server: {
-		/** @default false */
-		trustProxy: boolean;
-		/** @default 'streaming' */
-		render: 'streaming' | 'buffered';
-	};
-}
-
-/**
- * The build context @octanejs/vite-plugin passes to an adapter's `adapt()`
- * after `vite build` produced both bundles.
- */
-export interface AdaptContext {
-	/** Absolute project root (the Vite root). */
-	root: string;
-	/** The config `build.outDir` (relative to root, e.g. 'dist'). */
-	outDir: string;
-	/** Absolute path of the static client bundle ({outDir}/client). */
-	clientDir: string;
-	/** Absolute path of the server bundle ({outDir}/server, contains entry.js). */
-	serverDir: string;
-	/** Prefixed build logger. */
-	log: (message: string) => void;
-}
-
-/**
- * The octane.config.ts `adapter` contract. All parts are optional and
- * independent:
- *
- * - `adapt(ctx)` — post-build hook: restructure dist/client + dist/server for
- *   a deployment target (e.g. @octanejs/adapter-vercel emits `.vercel/output`).
- * - `serve(handler, opts)` — replaces the generated server entry's built-in
- *   Node boot when running `node dist/server/entry.js` / `octane-preview`.
- * - `runtime` — platform primitives (hashing, async context) replacing the
- *   entry's Node defaults; needed on non-Node runtimes.
- */
-export interface OctaneAdapter {
-	name?: string;
-	adapt?: (ctx: AdaptContext) => void | Promise<void>;
-	serve?: AdapterServeFunction;
-	runtime?: RuntimePrimitives;
-}
-
-export type AdapterServeFunction = (
-	handler: (request: Request, platform?: unknown) => Response | Promise<Response>,
-	options?: Record<string, unknown>,
-) => { listen: (port?: number) => unknown; close: () => void };

package/types/node.d.ts

@@ -1,31 +1 @@
-import type { IncomingMessage, ServerResponse, Server } from 'node:http';
-
-/** Convert a Node.js IncomingMessage to a Web Request. */
-export function nodeRequestToWebRequest(nodeRequest: IncomingMessage): Request;
-
-/**
- * Pipe a Web Response to a Node.js ServerResponse, streaming chunk-by-chunk
- * (a streaming SSR body flushes as it renders).
- */
-export function sendWebResponse(nodeResponse: ServerResponse, webResponse: Response): Promise<void>;
-
-/**
- * Serve a static file from `staticDir` when the request path maps to one.
- * `/assets/*` (hash-named build output) gets immutable caching; other files
- * revalidate. Returns true when the request was handled.
- */
-export function serveStaticFile(
-	req: IncomingMessage,
-	res: ServerResponse,
-	staticDir: string,
-): boolean;
-
-/**
- * Minimal production HTTP server: static files from `staticDir` first (the
- * built client assets), then the fetch-style SSR handler. The default boot for
- * `node dist/server/entry.js` when octane.config.ts has no adapter.
- */
-export function createNodeServer(
-	handler: (request: Request) => Response | Promise<Response>,
-	options?: { staticDir?: string },
-): { listen: (port?: number) => Server; close: () => void };
+export * from '@octanejs/app-core/node';

package/types/production.d.ts

@@ -1,71 +1 @@
-import type { RuntimePrimitives } from '@ripple-ts/adapter';
-import type {
-	Route,
-	Middleware,
-	ResolvedOctaneConfig,
-	OctaneConfigOptions,
-	RootBoundaryOptions,
-} from '@octanejs/vite-plugin';
-import type { RenderResult, StreamOptions, RenderOptions } from 'octane/server';
-
-export function resolveOctaneConfig(
-	raw: OctaneConfigOptions,
-	options?: { requireAdapter?: boolean },
-): ResolvedOctaneConfig;
-
-export interface ClientAssetEntry {
-	/** Path to the built JS file (relative to the client output dir) */
-	js: string;
-	/** Paths to the built CSS files (relative to the client output dir) */
-	css: string[];
-}
-
-export interface ServerManifest {
-	routes: Route[];
-	/** RenderRoute entry module path → module namespace (export picked per-route) */
-	components: Record<string, Record<string, unknown>>;
-	/** Layout module path → module namespace */
-	layouts: Record<string, Record<string, unknown>>;
-	middlewares: Middleware[];
-	/** Trust X-Forwarded-* headers when deriving origin for RPC fetch */
-	trustProxy?: boolean;
-	/** 'streaming' (default) renders via renderToReadableStream; 'buffered' awaits everything via prerender */
-	render?: 'streaming' | 'buffered';
-	rootBoundary?: RootBoundaryOptions;
-	/** config `router.preHydrate`, serialized into #__octane_data for the client entry */
-	preHydrate?: string | null;
-	/** Map of entry path → `module server` namespace for RPC support */
-	rpcModules?: Record<string, Record<string, Function>>;
-	/** Platform primitives (adapter's, or the generated entry's Node defaults) */
-	runtime?: RuntimePrimitives;
-	/** Route entry module path → built client asset paths (preload tags) */
-	clientAssets?: Record<string, ClientAssetEntry>;
-}
-
-export interface HandlerOptions {
-	/** `renderToReadableStream` from 'octane/server' (the streaming engine dev SSR uses) */
-	renderToReadableStream: (
-		component: Function,
-		props?: unknown,
-		options?: StreamOptions,
-	) => Promise<ReadableStream<Uint8Array>>;
-	/** `prerender` from 'octane/static' (the buffered await-everything fallback) */
-	prerender: (
-		component: Function,
-		props?: unknown,
-		options?: RenderOptions,
-	) => Promise<RenderResult>;
-	/** The BUILT dist client index.html (moved to dist/server by the build) */
-	htmlTemplate: string;
-	/** RPC executor from 'octane/server' */
-	executeServerFunction: (fn: Function, body: string) => Promise<string>;
-}
-
-/**
- * Production fetch-handler factory. Mirrors the dev middleware's render path
- * byte-for-byte in everything hydration can see (see server/production.js).
- */
-export function createHandler(
-	manifest: ServerManifest,
-	options: HandlerOptions,
-): (request: Request) => Promise<Response>;
+export * from '@octanejs/app-core/production';

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>