@gracile/engine 0.9.0-next.7 → 0.9.1-next.0

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAetD;;;;;;;;;;;;;;;;GAgBG;AAIH,eAAO,MAAM,OAAO,GAAI,SAAS,aAAa,KAAG,GAAG,EAoEnD,CAAC;AAEF,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAsBtD;;;;;;;;;;;;;;;;GAgBG;AAIH,eAAO,MAAM,OAAO,GAAI,SAAS,aAAa,KAAG,GAAG,EA2EnD,CAAC;AAEF,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/plugin.js

@@ -2,12 +2,18 @@ import { createLogger } from '@gracile/internal-utils/logger/helpers';
 import { getPluginContext, } from '@gracile/internal-utils/plugin-context';
 import { htmlRoutesLoader } from './vite/html-routes.js';
 import { hmrSsrReload } from './vite/hmr.js';
-import { virtualRoutesClient } from './vite/virtual-routes.js';
+import { virtualRoutesClient, virtualRoutes } from './vite/virtual-routes.js';
 import { createPluginSharedState } from './vite/plugin-shared-state.js';
 import { gracileServePlugin } from './vite/plugin-serve.js';
 import { gracileClientBuildPlugin } from './vite/plugin-client-build.js';
-import { gracileCollectClientAssetsPlugin, gracileServerBuildPlugin, } from './vite/plugin-server-build.js';
+import { gracileBuildEnvironmentPlugin } from './vite/plugin-build-environment.js';
+import { gracileCollectClientAssetsPlugin, gracileEntrypointPlugin, gracileMoveServerAssetsPlugin, } from './vite/plugin-server-build.js';
 import { gracileCETrackerPlugin } from './vite/plugin-ce-tracker.js';
+import { gracileHtmlRoutesBuildPlugins } from './vite/plugin-html-routes-build.js';
+// When plugin-client-build creates a temporary dev server via createServer(),
+// the user's vite.config is re-evaluated, calling gracile() again.
+// This guard prevents that re-entrant call from initializing the full plugin set.
+// Reset in configureServer so dev-mode config hot-reloads still work.
 let isClientBuilt = false;
 /**
  * The main Vite plugin for loading the Gracile framework.
@@ -32,8 +38,6 @@ let isClientBuilt = false;
 export const gracile = (config) => {
     const logger = createLogger();
     const state = createPluginSharedState(config);
-    // HACK: Prevent duplicate client build for the SSR build step in server mode.
-    // TODO: Move to the new, clean, environments builders API.
     if (isClientBuilt)
         return [];
     isClientBuilt = true;
@@ -54,11 +58,11 @@ export const gracile = (config) => {
                     sharedPluginContext.litSsrRenderInfo;
             },
         },
-        // MARK: 1.5. CE registry tracker (dev HMR cleanup)
+        // MARK: 2. CE registry tracker (dev HMR cleanup)
         gracileCETrackerPlugin(),
-        // MARK: 2. HMR SSR reload
+        // MARK: 3. HMR SSR reload
         hmrSsrReload(),
-        // MARK: 3. Dev serve middleware
+        // MARK: 4. Dev serve middleware
         gracileServePlugin({
             state,
             config,
@@ -67,21 +71,26 @@ export const gracile = (config) => {
                 isClientBuilt = false;
             },
         }),
-        // MARK: 4. Client virtual routes
+        // MARK: 5. Client virtual routes
         virtualRoutesForClient,
-        // MARK: 5. HTML routes loader
+        // MARK: 6. HTML routes loader
         htmlRoutesLoader(),
-        // MARK: 6. Client build
+        // MARK: 7. Client build (route rendering → populates shared state)
         gracileClientBuildPlugin({
             state,
             virtualRoutesForClient,
         }),
-        // MARK: 7. Collect client assets for server
+        // MARK: 8. HTML route resolution + asset collection (client build only)
+        ...gracileHtmlRoutesBuildPlugins({ state }),
+        // MARK: 9. Build environment configuration (consumes shared state)
+        gracileBuildEnvironmentPlugin({ state }),
+        // MARK: 9. Collect client assets for server
         gracileCollectClientAssetsPlugin({ state }),
-        // MARK: 8. Server build (nested)
-        gracileServerBuildPlugin({
-            state,
-            virtualRoutesForClient,
-        }),
+        // MARK: 10. Server virtual routes (SSR environment only)
+        ...virtualRoutes({ state }),
+        // MARK: 11. Server entrypoint (SSR environment only)
+        gracileEntrypointPlugin({ state }),
+        // MARK: 12. Move server assets (SSR environment only)
+        gracileMoveServerAssetsPlugin({ state }),
     ];
 };

package/dist/render/route-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-template.d.ts","sourceRoot":"","sources":["../../src/render/route-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAOxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAO1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,KAAK,CAAC,MAAM,oBAAoB,CAAC;AAa7C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEhF,wBAAsB,mBAAmB,CAAC,EACzC,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,WAAW,EACX,UAAU,EACV,OAAO,EACP,UAAU,GACV,EAAE;IACF,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,CAAC,YAAY,GAAG,SAAS,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;CAC7C,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAC,CA4JhE"}
+{"version":3,"file":"route-template.d.ts","sourceRoot":"","sources":["../../src/render/route-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAOxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAO1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,KAAK,CAAC,MAAM,oBAAoB,CAAC;AAa7C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AA0BhF,wBAAsB,mBAAmB,CAAC,EACzC,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,WAAW,EACX,UAAU,EACV,OAAO,EACP,UAAU,GACV,EAAE;IACF,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,CAAC,YAAY,GAAG,SAAS,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;CAC7C,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAC,CAwJhE"}

package/dist/render/route-template.js

@@ -2,11 +2,36 @@ import { Readable } from 'node:stream';
 import * as assert from '@gracile/internal-utils/assertions';
 import { render as renderLitSsr } from '@lit-labs/ssr';
 import { collectResult } from '@lit-labs/ssr/lib/render-result.js';
+// Lit's purpose-built Readable subclass for RenderResult. Handles nested
+// iterables, thunks, and Promises from sub-templates with proper back-pressure,
+// whereas generic `Readable.from()` only sees the top-level iterable.
+// Inherits from the same Node `Readable` we already depend on.
+import { RenderResultReadable } from '@lit-labs/ssr/lib/render-result-readable.js';
 import { GracileError, GracileErrorData, TemplateError, } from '../errors/errors.js';
 import { SSR_OUTLET_MARKER } from './markers.js';
 import { concatStreams, mergeRenderInfo, injectSiblingAssets, ensureDoctype, injectDevelopmentOverlay, injectServerAssets, } from './route-template-pipeline.js';
 // Re-export for consumers that import these regexes from this module.
 export { REGEX_TAG_SCRIPT, REGEX_TAG_LINK } from './route-template-pipeline.js';
+/**
+ * Lit SSR's `RenderResultReadable._read()` is `async`, but Node.js
+ * calls `_read()` without awaiting its return value.  If a thunk inside
+ * the render result throws (e.g. template expressions in invalid
+ * locations), the rejected Promise escapes and becomes an
+ * `unhandledRejection`.
+ *
+ * This subclass overrides `_read()` to catch that rejection and convert
+ * it into a stream `'error'` event via `this.destroy(err)`, which is
+ * the standard Node Readable contract.
+ */
+class SafeRenderResultReadable extends RenderResultReadable {
+    _read(size) {
+        const maybePromise = super._read(size);
+        void maybePromise?.catch?.((error) => {
+            this.destroy(error);
+        });
+        return maybePromise;
+    }
+}
 export async function renderRouteTemplate({ url, vite, mode, routeInfos, routeAssets, serverMode, docOnly, renderInfo, }) {
     const location = {
         file: routeInfos.foundRoute.filePath,
@@ -31,10 +56,7 @@ export async function renderRouteTemplate({ url, vite, mode, routeInfos, routeAs
                 // location,
             });
         const fragmentRender = renderLitSsr(fragmentOutput, mergedRenderInfo);
-        const output = Readable.from(fragmentRender);
-        // TODO: Disabled for now. Causes issue in static renders.
-        // Needs investigations.
-        // const output = new RenderResultReadable(fragmentRender);
+        const output = new SafeRenderResultReadable(fragmentRender);
         return { output, document: null };
     }
     // MARK: Document
@@ -90,8 +112,7 @@ export async function renderRouteTemplate({ url, vite, mode, routeInfos, routeAs
         const routeOutput = await Promise.resolve(routeInfos.routeModule.template(context));
         if (assert.isLitTemplate(routeOutput) === false)
             throw new Error(`Wrong template result for page template ${routeInfos.foundRoute.filePath}.`);
-        const renderStream = 
-        /* TODO: Use `new RenderResultReadable` */ Readable.from(renderLitSsr(routeOutput, mergedRenderInfo));
+        const renderStream = new SafeRenderResultReadable(renderLitSsr(routeOutput, mergedRenderInfo));
         const output = Readable.from(concatStreams(baseDocumentRenderStreamPre, renderStream, baseDocumentRenderStreamPost));
         return { output, document: baseDocumentHtml };
     }

package/dist/routes/load-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-module.d.ts","sourceRoot":"","sources":["../../src/routes/load-module.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AAI1C,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC;AAGhC,eAAO,MAAM,OAAO;;;;;;CASnB,CAAC;AAQF,wBAAsB,sBAAsB,CAAC,EAC5C,IAAI,EACJ,KAAK,EACL,YAAY,GACZ,EAAE;IACF,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,CAAC,aAAa,GAAG,SAAS,CAAC;CAC3C,0BA2CA"}
+{"version":3,"file":"load-module.d.ts","sourceRoot":"","sources":["../../src/routes/load-module.ts"],"names":[],"mappings":"AAKA,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AAIpE,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC;AAGhC,eAAO,MAAM,OAAO;;;;;;CASnB,CAAC;AAQF,wBAAsB,sBAAsB,CAAC,EAC5C,IAAI,EACJ,KAAK,EACL,YAAY,GACZ,EAAE;IACF,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,CAAC,aAAa,GAAG,SAAS,CAAC;CAC3C,0BAgDA"}

package/dist/routes/load-module.js

@@ -2,7 +2,7 @@ import { join } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { collectErrorMetadata } from '@gracile-labs/better-errors/dev/utils';
 import { enhanceViteSSRError } from '@gracile-labs/better-errors/dev/vite';
-import {} from 'vite';
+import { isRunnableDevEnvironment } from 'vite';
 import { GracileError, GracileErrorData } from '../errors/errors.js';
 import * as R from './route.js';
 // const ROUTE_SPREAD = /^\.{3}.+$/;
@@ -24,7 +24,10 @@ export async function loadForeignRouteObject({ vite, route, routeImports, }) {
     let unknownRouteModule;
     if (vite) {
         try {
-            unknownRouteModule = await vite.ssrLoadModule(route.filePath, {});
+            const ssrEnvironment = vite.environments.ssr;
+            if (!isRunnableDevEnvironment(ssrEnvironment))
+                throw new Error('Not in a SSR path');
+            unknownRouteModule = await ssrEnvironment.runner.import(route.filePath);
         }
         catch (error) {
             const error_ = error;

package/dist/routes/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/routes/render.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,uBAAuB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,MAAM,EAAE;QACP,KAAK,EAAE,OAAO,CAAC;QACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;IAEF,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAwBD,wBAAsB,YAAY,CAAC,EAClC,MAAM,EACN,IAAI,EACJ,UAAU,EACV,IAAoB,EACpB,aAAa,GACb,EAAE;IACF,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,aAAa,CAAC;CAC7B;;;GAwKA"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/routes/render.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,uBAAuB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,MAAM,EAAE;QACP,KAAK,EAAE,OAAO,CAAC;QACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;IAEF,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAsBD,wBAAsB,YAAY,CAAC,EAClC,MAAM,EACN,IAAI,EACJ,UAAU,EACV,IAAoB,EACpB,aAAa,GACb,EAAE;IACF,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,aAAa,CAAC;CAC7B;;;GAwKA"}

package/dist/routes/render.js

@@ -8,18 +8,19 @@ import { loadForeignRouteObject } from './load-module.js';
 async function streamToString(stream) {
     const chunks = [];
     for await (const chunk of stream) {
-        // NOTE: Since using Lit's `RenderResultReadable` instead of pure
-        // Node Readable, the chunk can be a string or a Buffer.
-        // If it's a string, convert it to Buffer first.
+        // `RenderResultReadable` always pushes strings (it resolves promises,
+        // thunks, and nested iterables internally). `Readable.from(string)`
+        // used for the document-only path also yields strings.
+        // Accept Buffer too for safety (plain `Readable` streams may emit them).
         if (typeof chunk === 'string') {
             chunks.push(Buffer.from(chunk));
         }
-        else
-            throw new TypeError('Wrong buffer type from stream. Should be a `string` only.');
-        // NOTE: Disabled for now. Causes issues with `RenderResultReadable`.
-        /* else {
+        else if (Buffer.isBuffer(chunk)) {
             chunks.push(chunk);
-        } */
+        }
+        else {
+            throw new TypeError(`Unexpected chunk type in stream: ${typeof chunk}`);
+        }
     }
     return Buffer.concat(chunks).toString('utf8');
 }

package/dist/vite/build-routes.d.ts

@@ -1,4 +1,4 @@
-import { type Plugin, type ViteDevServer } from 'vite';
+import { type ViteDevServer } from 'vite';
 import { type RenderedRouteDefinition } from '../routes/render.js';
 import type { RoutesManifest } from '../routes/route.js';
 import type { GracileConfig } from '../user-config.js';
@@ -12,6 +12,5 @@ export declare const buildRoutes: ({ routes, viteServerForBuild, root, gracileCo
     routes: RoutesManifest;
     renderedRoutes: RenderedRouteDefinition[];
     inputList: string[];
-    plugin: Plugin[];
 }>;
 //# sourceMappingURL=build-routes.d.ts.map

package/dist/vite/build-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-routes.d.ts","sourceRoot":"","sources":["../../src/vite/build-routes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AAErE,OAAO,EAEN,KAAK,uBAAuB,EAC5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AASvD,eAAO,MAAM,WAAW,GAAU,kEAM/B;IACF,MAAM,EAAE,cAAc,CAAC;IACvB,kBAAkB,EAAE,aAAa,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB,KAAG,OAAO,CAAC;IACX,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,uBAAuB,EAAE,CAAC;IAC1C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB,CA6JA,CAAC"}
+{"version":3,"file":"build-routes.d.ts","sourceRoot":"","sources":["../../src/vite/build-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AAExD,OAAO,EAEN,KAAK,uBAAuB,EAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AASvD,eAAO,MAAM,WAAW,GAAU,kEAM/B;IACF,MAAM,EAAE,cAAc,CAAC;IACvB,kBAAkB,EAAE,aAAa,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB,KAAG,OAAO,CAAC;IACX,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,uBAAuB,EAAE,CAAC;IAC1C,SAAS,EAAE,MAAM,EAAE,CAAC;CACpB,CAkCA,CAAC"}

package/dist/vite/build-routes.js

@@ -1,7 +1,5 @@
-import { basename, extname, join } from 'node:path';
 import { createFilter } from 'vite';
 import { renderRoutes, } from '../routes/render.js';
-import { REGEX_TAG_LINK, REGEX_TAG_SCRIPT } from '../render/route-template.js';
 function stripPremises(input) {
     return input
         .replace(/index\.html$/, '__index.doc.html')
@@ -9,7 +7,6 @@ function stripPremises(input) {
         .replace(/500\.html$/, '__500.doc.html');
 }
 export const buildRoutes = async ({ routes, viteServerForBuild, root, gracileConfig, serverMode = false, }) => {
-    // TODO: extract upstream, return just the plugins
     const { renderedRoutes } = await renderRoutes({
         vite: viteServerForBuild,
         serverMode,
@@ -35,100 +32,5 @@ export const buildRoutes = async ({ routes, viteServerForBuild, root, gracileCon
         routes,
         renderedRoutes,
         inputList,
-        plugin: [
-            {
-                name: 'gracile-html-routes',
-                apply: 'build',
-                enforce: 'pre',
-                resolveId(id) {
-                    if (extname(id) === '.html' && inputList.includes(id))
-                        return join(root, id);
-                    return null;
-                },
-                load(id) {
-                    if (extname(id) === '.html') {
-                        if (['index.html', '404.html', '500.html'].includes(basename(id))) {
-                            const content = renderedRoutes.find((index) => index.absoluteId === id)?.html;
-                            if (content)
-                                return content;
-                        }
-                        if (gracileConfig.pages?.premises?.expose) {
-                            if (basename(id).endsWith('doc.html')) {
-                                const content = renderedRoutes.find((index) => stripPremises(index.absoluteId) === id)?.static.document;
-                                if (content)
-                                    return content;
-                            }
-                            const content = renderedRoutes.find((index) => index.name === basename(id))?.html;
-                            if (content)
-                                return content;
-                            // return '';}
-                        }
-                    }
-                    return null;
-                },
-            },
-            {
-                name: 'gracile-collect-handler-assets',
-                enforce: 'post',
-                buildStart() {
-                    if (!gracileConfig.pages?.premises?.expose || !premisesFilter)
-                        return;
-                    for (const route of renderedRoutes) {
-                        if (premisesFilter(route.name) === false)
-                            continue;
-                        if (serverMode && route.savePrerender !== true)
-                            continue;
-                        const fileNameParts = route.name.split('/');
-                        const last = fileNameParts.pop();
-                        const properties = last?.replace(/(.*)\.html$/, (_, r) => `__${r}.props.json`);
-                        if (!properties)
-                            throw new Error('No props.');
-                        fileNameParts.push(properties);
-                        const fileName = fileNameParts.join('/');
-                        this.emitFile({
-                            fileName,
-                            type: 'asset',
-                            source: JSON.stringify(route.static.props ?? {}),
-                        });
-                    }
-                },
-                generateBundle(_, bundle) {
-                    if (serverMode === false)
-                        return;
-                    for (const fileKey in bundle) {
-                        const file = bundle[fileKey];
-                        if (fileKey.endsWith('.html') && file && 'source' in file) {
-                            const source = file.source.toString();
-                            const collectedAssets = [
-                                ...[...source.matchAll(REGEX_TAG_SCRIPT)]
-                                    .map((v) => v[0])
-                                    // NOTE: Too brittle
-                                    .filter((v) => v.includes(`type="module"`)),
-                                ...[...source.matchAll(REGEX_TAG_LINK)]
-                                    .map((v) => v[0])
-                                    // NOTE: Too brittle
-                                    .filter((v) => /rel="(stylesheet|modulepreload)"/.test(v)),
-                            ].join('\n');
-                            // NOTE: Not used (for now?)
-                            // file.source = alteredContent;
-                            const route = renderedRoutes.find((r) => {
-                                if (gracileConfig.pages?.premises?.expose)
-                                    return (`/${r.name}` ===
-                                        `/${fileKey}`.replace(/(.*?)\/__(.*?)\.doc\.html$/, (a, b, c) => `${b}/${c}.html`));
-                                return r.name === fileKey;
-                            });
-                            if (route)
-                                route.handlerAssets = collectedAssets;
-                            if (route?.savePrerender !== true) {
-                                delete bundle[fileKey];
-                                // NOTE: Not sure if it's useful
-                                if (route?.html)
-                                    route.html = null;
-                            }
-                        }
-                    }
-                },
-            },
-        ],
     };
 };

package/dist/vite/plugin-build-environment.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Vite plugin: build environment configuration.
+ *
+ * Owns all Environment API concerns for builds:
+ * - Top-level config: `builder.sharedConfigBuild`, `ssr.external` (server mode)
+ * - `configEnvironment('client')`: rollupOptions.input, outDir
+ * - `configEnvironment('ssr')`: outDir, SSR-specific build options, rollupOptions
+ * - `buildApp()`: orchestrates build order (client-only or client → SSR)
+ *
+ * `rollupOptions.input` must be set via `configEnvironment` (not the
+ * top-level `config` hook) because `builder.build(env)` uses
+ * environment-resolved config, not the top-level config.
+ *
+ * @internal
+ */
+import type { PluginOption } from 'vite';
+import type { PluginSharedState } from './plugin-shared-state.js';
+export declare function gracileBuildEnvironmentPlugin({ state, }: {
+    state: PluginSharedState;
+}): PluginOption;
+//# sourceMappingURL=plugin-build-environment.d.ts.map

package/dist/vite/plugin-build-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-build-environment.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-build-environment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,MAAM,CAAC;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,wBAAgB,6BAA6B,CAAC,EAC7C,KAAK,GACL,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;CACzB,GAAG,YAAY,CA4Ef"}

package/dist/vite/plugin-build-environment.js

@@ -0,0 +1,83 @@
+/**
+ * Vite plugin: build environment configuration.
+ *
+ * Owns all Environment API concerns for builds:
+ * - Top-level config: `builder.sharedConfigBuild`, `ssr.external` (server mode)
+ * - `configEnvironment('client')`: rollupOptions.input, outDir
+ * - `configEnvironment('ssr')`: outDir, SSR-specific build options, rollupOptions
+ * - `buildApp()`: orchestrates build order (client-only or client → SSR)
+ *
+ * `rollupOptions.input` must be set via `configEnvironment` (not the
+ * top-level `config` hook) because `builder.build(env)` uses
+ * environment-resolved config, not the top-level config.
+ *
+ * @internal
+ */
+import { join } from 'node:path';
+export function gracileBuildEnvironmentPlugin({ state, }) {
+    const isServerMode = state.outputMode === 'server';
+    return {
+        name: 'vite-plugin-gracile-build-env',
+        apply: 'build',
+        config() {
+            return {
+                ...(isServerMode ? { ssr: { external: ['@gracile/gracile'] } } : {}),
+                builder: { sharedConfigBuild: true },
+            };
+        },
+        configEnvironment(name, config) {
+            if (name === 'client') {
+                if (!state.clientBuildInputList)
+                    return null;
+                return {
+                    build: {
+                        rollupOptions: {
+                            input: state.clientBuildInputList,
+                        },
+                        outDir: join(config.build?.outDir || 'dist', isServerMode ? 'client' : ''),
+                    },
+                };
+            }
+            if (name === 'ssr' && isServerMode) {
+                return {
+                    build: {
+                        outDir: 'dist/server',
+                        copyPublicDir: false,
+                        ssrEmitAssets: true,
+                        cssMinify: true,
+                        cssCodeSplit: true,
+                        rollupOptions: {
+                            input: 'entrypoint.js',
+                            output: {
+                                entryFileNames: '[name].js',
+                                assetFileNames: (chunkInfo) => {
+                                    if (chunkInfo.name) {
+                                        const fileName = state.clientAssets[chunkInfo.name];
+                                        if (fileName)
+                                            return fileName;
+                                        return `assets/${chunkInfo.name.replace(/\.(.*)$/, '')}-[hash].[ext]`;
+                                    }
+                                    return 'assets/[name]-[hash].[ext]';
+                                },
+                                chunkFileNames: 'chunk/[name].js',
+                            },
+                        },
+                    },
+                };
+            }
+            return null;
+        },
+        async buildApp(builder) {
+            const client = builder.environments['client'];
+            if (!client)
+                throw new Error('Missing client build environment.');
+            await builder.build(client);
+            if (isServerMode) {
+                const ssr = builder.environments['ssr'];
+                if (!ssr)
+                    throw new Error('Missing ssr build environment.');
+                await builder.build(ssr);
+            }
+        },
+    };
+}

package/dist/vite/plugin-client-build.d.ts

@@ -1,9 +1,13 @@
 /**
- * Vite plugin: client-side build configuration.
+ * Vite plugin: client-side build route rendering.
  *
  * During `vite build`, this spins up a temporary dev server to render
- * all routes into static HTML, then configures Rollup with the
- * generated HTML pages as inputs.
+ * all routes into static HTML, then populates shared state with the
+ * rendered routes and input list.
+ *
+ * The actual HTML route resolution and asset collection are handled by
+ * separate Vite plugins (see `plugin-html-routes-build.ts`) that read
+ * from shared state and use `applyToEnvironment` to scope to the client.
  *
  * @internal
  */

package/dist/vite/plugin-client-build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-client-build.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-client-build.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAGvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,wBAAgB,wBAAwB,CAAC,EACxC,KAAK,EACL,sBAAsB,GACtB,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;IACzB,sBAAsB,EAAE,YAAY,CAAC;CACrC,GAAG,YAAY,CA+Df"}
+{"version":3,"file":"plugin-client-build.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-client-build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAGvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,wBAAgB,wBAAwB,CAAC,EACxC,KAAK,EACL,sBAAsB,GACtB,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;IACzB,sBAAsB,EAAE,YAAY,CAAC;CACrC,GAAG,YAAY,CAoDf"}

package/dist/vite/plugin-client-build.js

@@ -1,13 +1,16 @@
 /**
- * Vite plugin: client-side build configuration.
+ * Vite plugin: client-side build route rendering.
  *
  * During `vite build`, this spins up a temporary dev server to render
- * all routes into static HTML, then configures Rollup with the
- * generated HTML pages as inputs.
+ * all routes into static HTML, then populates shared state with the
+ * rendered routes and input list.
+ *
+ * The actual HTML route resolution and asset collection are handled by
+ * separate Vite plugins (see `plugin-html-routes-build.ts`) that read
+ * from shared state and use `applyToEnvironment` to scope to the client.
  *
  * @internal
  */
-import { join } from 'node:path';
 import { getPluginContext } from '@gracile/internal-utils/plugin-context';
 import { createServer } from 'vite';
 import { buildRoutes } from './build-routes.js';
@@ -16,8 +19,9 @@ export function gracileClientBuildPlugin({ state, virtualRoutesForClient, }) {
         name: 'vite-plugin-gracile-build',
         apply: 'build',
         async config(viteConfig) {
+            state.root = viteConfig.root || process.cwd();
             const viteServerForClientHtmlBuild = await createServer({
-                root: viteConfig.root || process.cwd(),
+                root: state.root,
                 server: { middlewareMode: true },
                 // NOTE: Stub. KEEP IT!
                 optimizeDeps: { include: [] },
@@ -34,6 +38,7 @@ export function gracileClientBuildPlugin({ state, virtualRoutesForClient, }) {
                 routes: state.routes,
             });
             state.renderedRoutes = htmlPages.renderedRoutes;
+            state.clientBuildInputList = htmlPages.inputList;
             // NOTE: Vite's dev server does not invoke Rollup's `closeWatcher`
             // hook when shutting down. Plugins like @rollup/plugin-typescript
             // use `ts.createWatchProgram()` which sets up hundreds of FS
@@ -45,15 +50,6 @@ export function gracileClientBuildPlugin({ state, virtualRoutesForClient, }) {
                 }
             }
             await viteServerForClientHtmlBuild.close();
-            return {
-                build: {
-                    rollupOptions: {
-                        input: htmlPages.inputList,
-                        plugins: [htmlPages.plugin],
-                    },
-                    outDir: join(viteConfig.build?.outDir || 'dist', state.outputMode === 'server' ? 'client' : ''),
-                },
-            };
         },
     };
 }

package/dist/vite/plugin-html-routes-build.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Vite plugins: HTML route resolution and asset collection for builds.
+ *
+ * These are registered as Vite plugins (not Rollup plugins via
+ * `rollupOptions.plugins`) so they work correctly with the Environment
+ * API's `builder.build(env)`, which does not inherit top-level
+ * `rollupOptions` into environment builds.
+ *
+ * They use `applyToEnvironment` to scope to the client build only,
+ * preventing the SSR build from trying to resolve HTML entries.
+ *
+ * Data is read lazily from shared state, which is populated by the
+ * client build plugin's `config` hook before these hooks run.
+ *
+ * @internal
+ */
+import { type PluginOption } from 'vite';
+import type { PluginSharedState } from './plugin-shared-state.js';
+export declare function gracileHtmlRoutesBuildPlugins({ state, }: {
+    state: PluginSharedState;
+}): PluginOption[];
+//# sourceMappingURL=plugin-html-routes-build.d.ts.map

package/dist/vite/plugin-html-routes-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-html-routes-build.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-html-routes-build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAIvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AASlE,wBAAgB,6BAA6B,CAAC,EAC7C,KAAK,GACL,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;CACzB,GAAG,YAAY,EAAE,CAiJjB"}

package/dist/vite/plugin-html-routes-build.js

@@ -0,0 +1,140 @@
+/**
+ * Vite plugins: HTML route resolution and asset collection for builds.
+ *
+ * These are registered as Vite plugins (not Rollup plugins via
+ * `rollupOptions.plugins`) so they work correctly with the Environment
+ * API's `builder.build(env)`, which does not inherit top-level
+ * `rollupOptions` into environment builds.
+ *
+ * They use `applyToEnvironment` to scope to the client build only,
+ * preventing the SSR build from trying to resolve HTML entries.
+ *
+ * Data is read lazily from shared state, which is populated by the
+ * client build plugin's `config` hook before these hooks run.
+ *
+ * @internal
+ */
+import { basename, extname, join } from 'node:path';
+import { createFilter } from 'vite';
+import { REGEX_TAG_LINK, REGEX_TAG_SCRIPT } from '../render/route-template.js';
+function stripPremises(input) {
+    return input
+        .replace(/index\.html$/, '__index.doc.html')
+        .replace(/404\.html$/, '__404.doc.html')
+        .replace(/500\.html$/, '__500.doc.html');
+}
+export function gracileHtmlRoutesBuildPlugins({ state, }) {
+    return [
+        {
+            name: 'gracile-html-routes',
+            apply: 'build',
+            enforce: 'pre',
+            applyToEnvironment(environment) {
+                return environment.name !== 'ssr';
+            },
+            resolveId(id) {
+                const inputList = state.clientBuildInputList;
+                const root = state.root;
+                if (!inputList || !root)
+                    return null;
+                if (extname(id) === '.html' && inputList.includes(id))
+                    return join(root, id);
+                return null;
+            },
+            load(id) {
+                const renderedRoutes = state.renderedRoutes;
+                if (!renderedRoutes)
+                    return null;
+                if (extname(id) === '.html') {
+                    if (['index.html', '404.html', '500.html'].includes(basename(id))) {
+                        const content = renderedRoutes.find((index) => index.absoluteId === id)?.html;
+                        if (content)
+                            return content;
+                    }
+                    if (state.gracileConfig.pages?.premises?.expose) {
+                        if (basename(id).endsWith('doc.html')) {
+                            const content = renderedRoutes.find((index) => stripPremises(index.absoluteId) === id)?.static.document;
+                            if (content)
+                                return content;
+                        }
+                        const content = renderedRoutes.find((index) => index.name === basename(id))?.html;
+                        if (content)
+                            return content;
+                    }
+                }
+                return null;
+            },
+        },
+        {
+            name: 'gracile-collect-handler-assets',
+            apply: 'build',
+            enforce: 'post',
+            applyToEnvironment(environment) {
+                return environment.name !== 'ssr';
+            },
+            buildStart() {
+                const renderedRoutes = state.renderedRoutes;
+                if (!renderedRoutes)
+                    return;
+                if (!state.gracileConfig.pages?.premises?.expose)
+                    return;
+                const premisesFilter = createFilter(state.gracileConfig.pages.premises.include, state.gracileConfig.pages.premises.exclude);
+                for (const route of renderedRoutes) {
+                    if (premisesFilter(route.name) === false)
+                        continue;
+                    if (state.outputMode === 'server' && route.savePrerender !== true)
+                        continue;
+                    const fileNameParts = route.name.split('/');
+                    const last = fileNameParts.pop();
+                    const properties = last?.replace(/(.*)\.html$/, (_, r) => `__${r}.props.json`);
+                    if (!properties)
+                        throw new Error('No props.');
+                    fileNameParts.push(properties);
+                    const fileName = fileNameParts.join('/');
+                    this.emitFile({
+                        fileName,
+                        type: 'asset',
+                        source: JSON.stringify(route.static.props ?? {}),
+                    });
+                }
+            },
+            generateBundle(_, bundle) {
+                const renderedRoutes = state.renderedRoutes;
+                if (!renderedRoutes)
+                    return;
+                if (state.outputMode !== 'server')
+                    return;
+                for (const fileKey in bundle) {
+                    const file = bundle[fileKey];
+                    if (fileKey.endsWith('.html') && file && 'source' in file) {
+                        const source = file.source.toString();
+                        const collectedAssets = [
+                            ...[...source.matchAll(REGEX_TAG_SCRIPT)]
+                                .map((v) => v[0])
+                                // NOTE: Too brittle
+                                .filter((v) => v.includes(`type="module"`)),
+                            ...[...source.matchAll(REGEX_TAG_LINK)]
+                                .map((v) => v[0])
+                                // NOTE: Too brittle
+                                .filter((v) => /rel="(stylesheet|modulepreload)"/.test(v)),
+                        ].join('\n');
+                        const route = renderedRoutes.find((r) => {
+                            if (state.gracileConfig.pages?.premises?.expose)
+                                return (`/${r.name}` ===
+                                    `/${fileKey}`.replace(/(.*?)\/__(.*?)\.doc\.html$/, (a, b, c) => `${b}/${c}.html`));
+                            return r.name === fileKey;
+                        });
+                        if (route)
+                            route.handlerAssets = collectedAssets;
+                        if (route?.savePrerender !== true) {
+                            delete bundle[fileKey];
+                            // NOTE: Not sure if it's useful
+                            if (route?.html)
+                                route.html = null;
+                        }
+                    }
+                }
+            },
+        },
+    ];
+}

package/dist/vite/plugin-serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-serve.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-serve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAIjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,wBAAgB,kBAAkB,CAAC,EAClC,KAAK,EACL,MAAM,EACN,MAAM,EACN,oBAAoB,GACpB,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,MAAM,IAAI,CAAC;CACjC,GAAG,YAAY,CA6Df"}
+{"version":3,"file":"plugin-serve.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-serve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAIjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,wBAAgB,kBAAkB,CAAC,EAClC,KAAK,EACL,MAAM,EACN,MAAM,EACN,oBAAoB,GACpB,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,MAAM,IAAI,CAAC;CACjC,GAAG,YAAY,CA4Df"}

package/dist/vite/plugin-serve.js

@@ -27,8 +27,7 @@ export function gracileServePlugin({ state, config, logger, resetClientBuiltFlag
             };
         },
         async configureServer(server) {
-            // HACK: We know we are in dev here, this will prevent incorrect
-            // vite.config hot reloading. Will be removed when adopting env. API.
+            // Reset so dev-mode config hot-reloads don't hit the guard.
             resetClientBuiltFlag();
             const version = getVersion();
             logger.info(`${c.cyan(c.italic(c.underline('🧚 Gracile')))}` +

package/dist/vite/plugin-server-build.d.ts

@@ -1,18 +1,17 @@
 /**
  * Vite plugins: server-side build pipeline.
  *
- * After the client build completes, these plugins run a nested
- * `vite build` in SSR mode to produce the server entrypoint.
+ * Uses the Vite Environment API (`builder.buildApp()`) to coordinate
+ * client and SSR builds instead of a nested `build()` call.
  *
  * Includes:
- * - Client asset filename collector (from the client writeBundle)
- * - Server build trigger (closeBundle)
- * - Virtual entrypoint codegen
- * - Server-to-client asset mover
+ * - Client asset filename collector (client env writeBundle)
+ * - Virtual entrypoint codegen (SSR env only)
+ * - Server-to-client asset mover (SSR env only)
  *
  * @internal
  */
-import { type PluginOption } from 'vite';
+import type { PluginOption } from 'vite';
 import type { PluginSharedState } from './plugin-shared-state.js';
 /**
  * Tracks client bundle assets so the server build can reference them
@@ -22,12 +21,23 @@ export declare function gracileCollectClientAssetsPlugin({ state, }: {
     state: PluginSharedState;
 }): PluginOption;
 /**
- * After the client build finishes (`closeBundle`), run a nested SSR
- * build that produces the server entrypoint and moves assets back into
- * the client output directory.
+ * Generates the virtual `entrypoint.js` module for the server build.
+ * This is the server's main entry: it imports routes and creates the
+ * Gracile handler.
+ *
+ * Scoped to the SSR environment via `applyToEnvironment`.
+ */
+export declare function gracileEntrypointPlugin({ state, }: {
+    state: PluginSharedState;
+}): PluginOption;
+/**
+ * After the server build writes its bundle, move any assets from
+ * `dist/server/assets/` into `dist/client/assets/` so the client
+ * can serve them.
+ *
+ * Scoped to the SSR environment via `applyToEnvironment`.
  */
-export declare function gracileServerBuildPlugin({ state, virtualRoutesForClient, }: {
+export declare function gracileMoveServerAssetsPlugin({ state, }: {
     state: PluginSharedState;
-    virtualRoutesForClient: PluginOption;
 }): PluginOption;
 //# sourceMappingURL=plugin-server-build.d.ts.map

package/dist/vite/plugin-server-build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-server-build.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-server-build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAGhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAIlE;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,EAChD,KAAK,GACL,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;CACzB,GAAG,YAAY,CAYf;AAID;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,EACxC,KAAK,EACL,sBAAsB,GACtB,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;IACzB,sBAAsB,EAAE,YAAY,CAAC;CACrC,GAAG,YAAY,CAqEf"}
+{"version":3,"file":"plugin-server-build.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-server-build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAIlE;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,EAChD,KAAK,GACL,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;CACzB,GAAG,YAAY,CAgBf;AAID;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,EACvC,KAAK,GACL,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;CACzB,GAAG,YAAY,CAsCf;AAID;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,EAC7C,KAAK,GACL,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;CACzB,GAAG,YAAY,CA2Bf"}

package/dist/vite/plugin-server-build.js

@@ -1,21 +1,18 @@
 /**
  * Vite plugins: server-side build pipeline.
  *
- * After the client build completes, these plugins run a nested
- * `vite build` in SSR mode to produce the server entrypoint.
+ * Uses the Vite Environment API (`builder.buildApp()`) to coordinate
+ * client and SSR builds instead of a nested `build()` call.
  *
  * Includes:
- * - Client asset filename collector (from the client writeBundle)
- * - Server build trigger (closeBundle)
- * - Virtual entrypoint codegen
- * - Server-to-client asset mover
+ * - Client asset filename collector (client env writeBundle)
+ * - Virtual entrypoint codegen (SSR env only)
+ * - Server-to-client asset mover (SSR env only)
  *
  * @internal
  */
 import { join } from 'node:path';
 import { rename, rm } from 'node:fs/promises';
-import { build } from 'vite';
-import { virtualRoutes } from './virtual-routes.js';
 // ── Client asset collector ───────────────────────────────────────────
 /**
  * Tracks client bundle assets so the server build can reference them
@@ -24,6 +21,9 @@ import { virtualRoutes } from './virtual-routes.js';
 export function gracileCollectClientAssetsPlugin({ state, }) {
     return {
         name: 'vite-plugin-gracile-collect-client-assets-for-server',
+        applyToEnvironment(environment) {
+            return environment.name !== 'ssr';
+        },
         writeBundle(_, bundle) {
             if (state.outputMode === 'static')
                 return;
@@ -33,76 +33,21 @@ export function gracileCollectClientAssetsPlugin({ state, }) {
         },
     };
 }
-// ── Server build trigger ─────────────────────────────────────────────
-/**
- * After the client build finishes (`closeBundle`), run a nested SSR
- * build that produces the server entrypoint and moves assets back into
- * the client output directory.
- */
-export function gracileServerBuildPlugin({ state, virtualRoutesForClient, }) {
-    return {
-        name: 'vite-plugin-gracile-server-build',
-        apply: 'build',
-        config(viteConfig) {
-            state.root = viteConfig.root || null;
-        },
-        async closeBundle() {
-            if (state.outputMode === 'static' ||
-                !state.routes ||
-                !state.renderedRoutes)
-                return;
-            const root = state.root || process.cwd();
-            await build({
-                root,
-                ssr: { external: ['@gracile/gracile'] },
-                build: {
-                    target: 'esnext',
-                    ssr: true,
-                    copyPublicDir: false,
-                    outDir: 'dist/server',
-                    ssrEmitAssets: true,
-                    cssMinify: true,
-                    cssCodeSplit: true,
-                    rollupOptions: {
-                        input: 'entrypoint.js',
-                        output: {
-                            entryFileNames: '[name].js',
-                            assetFileNames: (chunkInfo) => {
-                                if (chunkInfo.name) {
-                                    const fileName = state.clientAssets[chunkInfo.name];
-                                    if (fileName)
-                                        return fileName;
-                                    // NOTE: When not imported at all from client
-                                    return `assets/${chunkInfo.name.replace(/\.(.*)$/, '')}-[hash].[ext]`;
-                                }
-                                return 'assets/[name]-[hash].[ext]';
-                            },
-                            chunkFileNames: 'chunk/[name].js',
-                        },
-                    },
-                },
-                plugins: [
-                    virtualRoutesForClient,
-                    virtualRoutes({
-                        routes: state.routes,
-                        renderedRoutes: state.renderedRoutes,
-                    }),
-                    gracileEntrypointPlugin(state),
-                    gracileMoveServerAssetsPlugin(state),
-                ],
-            });
-        },
-    };
-}
 // ── Virtual entrypoint ───────────────────────────────────────────────
 /**
  * Generates the virtual `entrypoint.js` module for the server build.
  * This is the server's main entry: it imports routes and creates the
  * Gracile handler.
+ *
+ * Scoped to the SSR environment via `applyToEnvironment`.
  */
-function gracileEntrypointPlugin(state) {
+export function gracileEntrypointPlugin({ state, }) {
     return {
         name: 'vite-plugin-gracile-entry',
+        apply: 'build',
+        applyToEnvironment(environment) {
+            return environment.name === 'ssr';
+        },
         resolveId(id) {
             if (id === 'entrypoint.js') {
                 return id;
@@ -137,10 +82,16 @@ export const handler = createGracileHandler({
  * After the server build writes its bundle, move any assets from
  * `dist/server/assets/` into `dist/client/assets/` so the client
  * can serve them.
+ *
+ * Scoped to the SSR environment via `applyToEnvironment`.
  */
-function gracileMoveServerAssetsPlugin(state) {
+export function gracileMoveServerAssetsPlugin({ state, }) {
     return {
         name: 'gracile-move-server-assets',
+        apply: 'build',
+        applyToEnvironment(environment) {
+            return environment.name === 'ssr';
+        },
         async writeBundle(_, bundle) {
             const cwd = state.root || process.cwd();
             await Promise.all(Object.entries(bundle).map(async ([file]) => {

package/dist/vite/plugin-shared-state.d.ts

@@ -15,6 +15,8 @@ export interface PluginSharedState {
     routes: RoutesManifest;
     /** Rendered route definitions from the client build phase. */
     renderedRoutes: RenderedRouteDefinition[] | null;
+    /** Rollup input list for the client build (populated by route renderer). */
+    clientBuildInputList: string[] | null;
     /** Maps original asset names → hashed filenames from the client bundle. */
     clientAssets: Record<string, string>;
     /** Vite `root` captured during build config. */

package/dist/vite/plugin-shared-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-shared-state.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-shared-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IACjC,qEAAqE;IACrE,MAAM,EAAE,cAAc,CAAC;IAEvB,8DAA8D;IAC9D,cAAc,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAAC;IAEjD,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,gDAAgD;IAChD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB,0CAA0C;IAC1C,aAAa,EAAE,aAAa,CAAC;IAE7B,6CAA6C;IAC7C,UAAU,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,aAAa,GAAG,SAAS,GAC/B,iBAAiB,CASnB"}
+{"version":3,"file":"plugin-shared-state.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-shared-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IACjC,qEAAqE;IACrE,MAAM,EAAE,cAAc,CAAC;IAEvB,8DAA8D;IAC9D,cAAc,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAAC;IAEjD,4EAA4E;IAC5E,oBAAoB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEtC,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,gDAAgD;IAChD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB,0CAA0C;IAC1C,aAAa,EAAE,aAAa,CAAC;IAE7B,6CAA6C;IAC7C,UAAU,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,aAAa,GAAG,SAAS,GAC/B,iBAAiB,CAUnB"}

package/dist/vite/plugin-shared-state.js

@@ -14,6 +14,7 @@ export function createPluginSharedState(config) {
     return {
         routes: new Map(),
         renderedRoutes: null,
+        clientBuildInputList: null,
         clientAssets: {},
         root: null,
         gracileConfig: config || {},

package/dist/vite/virtual-routes.d.ts

@@ -1,13 +1,16 @@
 import { type Plugin } from 'vite';
-import type { RenderedRouteDefinition } from '../routes/render.js';
 import type { RoutesManifest } from '../routes/route.js';
 import type { GracileConfig } from '../user-config.js';
+import type { PluginSharedState } from './plugin-shared-state.js';
 /**
- * @todo Client-side testing, docs.
+ * Server-side routes virtual module (`gracile:routes`).
+ *
+ * Scoped to the SSR build environment via `applyToEnvironment`.
+ * Reads from shared state lazily so `renderedRoutes` is available
+ * (populated during the client build).
  */
-export declare function virtualRoutes({ routes, renderedRoutes, }: {
-    routes: RoutesManifest;
-    renderedRoutes: RenderedRouteDefinition[];
+export declare function virtualRoutes({ state, }: {
+    state: PluginSharedState;
 }): Plugin[];
 export declare function virtualRoutesClient({ routes: routesMap, mode, gracileConfig, }: {
     routes: RoutesManifest;

package/dist/vite/virtual-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"virtual-routes.d.ts","sourceRoot":"","sources":["../../src/vite/virtual-routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAEjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAE7B,MAAM,EACN,cAAc,GACd,EAAE;IAEF,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,uBAAuB,EAAE,CAAC;CAC1C,GAAG,MAAM,EAAE,CAyEX;AAKD,wBAAgB,mBAAmB,CAAC,EACnC,MAAM,EAAE,SAAS,EACjB,IAAe,EACf,aAAa,GACb,EAAE;IACF,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,aAAa,EAAE,aAAa,CAAC;CAC7B,GAAG,MAAM,EAAE,CA4DX"}
+{"version":3,"file":"virtual-routes.d.ts","sourceRoot":"","sources":["../../src/vite/virtual-routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAC7B,KAAK,GACL,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;CACzB,GAAG,MAAM,EAAE,CAwEX;AAKD,wBAAgB,mBAAmB,CAAC,EACnC,MAAM,EAAE,SAAS,EACjB,IAAe,EACf,aAAa,GACb,EAAE;IACF,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,aAAa,EAAE,aAAa,CAAC;CAC7B,GAAG,MAAM,EAAE,CA4DX"}

package/dist/vite/virtual-routes.js

@@ -1,25 +1,22 @@
 import { normalizeToPosix } from '@gracile/internal-utils/paths';
 import { createFilter } from 'vite';
 /**
- * @todo Client-side testing, docs.
+ * Server-side routes virtual module (`gracile:routes`).
+ *
+ * Scoped to the SSR build environment via `applyToEnvironment`.
+ * Reads from shared state lazily so `renderedRoutes` is available
+ * (populated during the client build).
  */
-export function virtualRoutes({ 
-// root,
-routes, renderedRoutes, }) {
+export function virtualRoutes({ state, }) {
     const virtualModuleId = 'gracile:routes';
     const resolvedVirtualModuleId = `\0${virtualModuleId}`;
-    // TODO: Remove handler when prerendering route
-    const routesWithoutPrerender = [...routes];
-    const renderedRoutesWithoutPrerender = renderedRoutes;
-    // const routesWithoutPrerender = [...routes].filter(
-    // 	([, r]) => r.prerender !== true,
-    // );
-    // const renderedRoutesWithoutPrerender = renderedRoutes.filter(
-    // 	(r) => r.savePrerender !== true,
-    // );
     return [
         {
             name: 'gracile-server-routes',
+            apply: 'build',
+            applyToEnvironment(environment) {
+                return environment.name === 'ssr';
+            },
             resolveId(id) {
                 if (id === virtualModuleId) {
                     return resolvedVirtualModuleId;
@@ -27,39 +24,43 @@ routes, renderedRoutes, }) {
                 return null;
             },
             load(id) {
-                if (id === resolvedVirtualModuleId) {
-                    return `
+                if (id !== resolvedVirtualModuleId)
+                    return null;
+                const routes = state.routes;
+                const renderedRoutes = state.renderedRoutes;
+                if (!routes || routes.size === 0 || !renderedRoutes)
+                    return null;
+                const routesArray = [...routes];
+                return `
 import { URLPattern } from '@gracile/gracile/url-pattern';
 
 const routes = new Map(${
-                    //
-                    JSON.stringify(routesWithoutPrerender, null, 2).replaceAll(
-                    // NOTE: Not strictly necessary, but just in case.
-                    '"pattern": {}', '"pattern": null')})
+                //
+                JSON.stringify(routesArray, null, 2).replaceAll(
+                // NOTE: Not strictly necessary, but just in case.
+                '"pattern": {}', '"pattern": null')})
 routes.forEach((route, pattern) => {
 	route.pattern = new URLPattern(pattern, 'http://gracile');
 });
 
 const routeImports = new Map(
 	[
-		${routesWithoutPrerender
-                        .map(([pattern, route]) => `['${pattern}', () => import('/${normalizeToPosix(route.filePath)}')],`)
-                        .join('\n		')}
+		${routesArray
+                    .map(([pattern, route]) => `['${pattern}', () => import('/${normalizeToPosix(route.filePath)}')],`)
+                    .join('\n		')}
 	]
 );
 
-const routeAssets = new Map(${JSON.stringify(renderedRoutesWithoutPrerender.map((r) => [
-                        `/${r.name
-                            //
-                            .replace(/index\.html$/, '')
-                            .replace(/* Error pages */ /\.html$/, '/')}`,
-                        r.handlerAssets,
-                    ]), null, 2)});
+const routeAssets = new Map(${JSON.stringify(renderedRoutes.map((r) => [
+                    `/${r.name
+                        //
+                        .replace(/index\.html$/, '')
+                        .replace(/* Error pages */ /\.html$/, '/')}`,
+                    r.handlerAssets,
+                ]), null, 2)});
 
 export { routes, routeImports, routeAssets };
 `;
-                }
-                return null;
             },
         },
     ];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gracile/engine",
-  "version": "0.9.0-next.7",
-  "description": "A thin, full-stack, web framework",
+  "version": "0.9.1-next.0",
+  "description": "Vite-powered build and dev server engine for the Gracile framework",
   "keywords": [
     "custom-elements",
     "full-stack",
@@ -43,8 +43,8 @@
     "!/dist/typedoc-entrypoint.*"
   ],
   "dependencies": {
-    "@gracile-labs/better-errors": "^0.2.1-next.0",
-    "@gracile/internal-utils": "^0.6.1-next.0",
+    "@gracile-labs/better-errors": "^0.3.1-next.0",
+    "@gracile/internal-utils": "^0.6.2-next.0",
     "@whatwg-node/server": "^0.10.18",
     "fdir": "^6.5.0",
     "picocolors": "^1.1.1",
@@ -60,5 +60,5 @@
     "access": "public",
     "provenance": true
   },
-  "gitHead": "9abb3f9de0217a6284a88b114194b4d254d0a104"
+  "gitHead": "d9d9fc5711f843aaa0356d0f5a781aa68f264af2"
 }