@gracile/engine 0.9.0-next.4 → 0.9.0-next.6

package/dist/dev/development.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"development.d.ts","sourceRoot":"","sources":["../../src/dev/development.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAEN,KAAK,cAAc,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,wBAAsB,wBAAwB,CAAC,EAC9C,MAAM,EACN,IAAI,EACJ,aAAa,GACb,EAAE;IACF,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;CAC7B,GAAG,OAAO,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;CACvB,CAAC,CAgDD"}
+{"version":3,"file":"development.d.ts","sourceRoot":"","sources":["../../src/dev/development.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAEN,KAAK,cAAc,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,wBAAsB,wBAAwB,CAAC,EAC9C,MAAM,EACN,IAAI,EACJ,aAAa,GACb,EAAE;IACF,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;CAC7B,GAAG,OAAO,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;CACvB,CAAC,CAqDD"}

package/dist/dev/development.js

@@ -10,7 +10,7 @@ export async function createDevelopmentHandler({ routes, vite, gracileConfig, })
     logger.info('');
     logger.info(c.dim('Creating the request handler…'), { timestamp: true });
     const collectAndCodegen = async () => {
-        await collectRoutes(routes, root, gracileConfig.routes?.exclude);
+        await collectRoutes(routes, root, gracileConfig.routes?.exclude, gracileConfig.trailingSlash);
         if (gracileConfig.experimental?.generateRoutesTypings)
             await generateRoutesTypings(root, routes).catch((error) => logger.error(String(error)));
     };

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAQtD;;;;;;;;;;;;;;;;GAgBG;AAIH,eAAO,MAAM,OAAO,GAAI,SAAS,aAAa,KAAG,GAAG,EAuVnD,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;AActD;;;;;;;;;;;;;;;;GAgBG;AAIH,eAAO,MAAM,OAAO,GAAI,SAAS,aAAa,KAAG,GAAG,EAiEnD,CAAC;AAEF,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/plugin.js

@@ -1,18 +1,12 @@
-import { join } from 'node:path';
-import { rename, rm } from 'node:fs/promises';
 import { createLogger } from '@gracile/internal-utils/logger/helpers';
 import { getPluginContext, } from '@gracile/internal-utils/plugin-context';
-import { getVersion } from '@gracile/internal-utils/version';
-// import { betterErrors } from '@gracile-labs/better-errors/plugin';
-import c from 'picocolors';
-import { build, createServer } from 'vite';
-import {} from './routes/render.js';
-import { createDevelopmentHandler } from './dev/development.js';
-import { nodeAdapter } from './server/adapters/node.js';
-import { buildRoutes } from './vite/build-routes.js';
 import { htmlRoutesLoader } from './vite/html-routes.js';
-import { virtualRoutes, virtualRoutesClient } from './vite/virtual-routes.js';
 import { hmrSsrReload } from './vite/hmr.js';
+import { virtualRoutesClient } 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';
 let isClientBuilt = false;
 /**
  * The main Vite plugin for loading the Gracile framework.
@@ -36,274 +30,55 @@ let isClientBuilt = false;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export const gracile = (config) => {
     const logger = createLogger();
-    const outputMode = config?.output || 'static';
-    const clientAssets = {};
-    const routes = new Map();
-    let renderedRoutes = null;
-    let root = null;
-    const gracileConfig = config || {};
+    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;
     const virtualRoutesForClient = virtualRoutesClient({
-        mode: outputMode,
-        routes,
-        // NOTE: This will be a dedicated setting when it will not be experimental
-        // anymore.
-        gracileConfig,
-        // enabled: gracileConfig?.pages?.premises?.expose || false,
+        mode: state.outputMode,
+        routes: state.routes,
+        gracileConfig: state.gracileConfig,
     });
     let sharedPluginContext;
     return [
+        // MARK: 1. Plugin context setup
         {
             name: 'vite-plugin-gracile-context',
-            config(config) {
-                sharedPluginContext = getPluginContext(config);
-                gracileConfig.litSsr ??= { renderInfo: {} };
-                gracileConfig.litSsr.renderInfo = sharedPluginContext.litSsrRenderInfo;
+            config(viteConfig) {
+                sharedPluginContext = getPluginContext(viteConfig);
+                state.gracileConfig.litSsr ??= { renderInfo: {} };
+                state.gracileConfig.litSsr.renderInfo =
+                    sharedPluginContext.litSsrRenderInfo;
             },
         },
-        // betterErrors({
-        // 	overlayImportPath: '@gracile/gracile/_internals/vite-custom-overlay',
-        // }),
-        // 		{
-        // 			name: 'gracile-routes-codegen',
-        // 			// watchChange(change) {
-        // 			// 	console.log({ change });
-        // 			// },
-        // 			resolveId(id) {
-        // 				const virtualModuleId = 'gracile:route';
-        // 				const resolvedVirtualModuleId = `\0${virtualModuleId}`;
-        // 				if (id === virtualModuleId) {
-        // 					return resolvedVirtualModuleId;
-        // 				}
-        // 				return null;
-        // 			},
-        // 			load(id) {
-        // 				const virtualModuleId = 'gracile:route';
-        // 				const resolvedVirtualModuleId = `\0${virtualModuleId}`;
-        // 				if (id === resolvedVirtualModuleId) {
-        // 					return `
-        // export function route(input){
-        // return input;
-        // }`;
-        // 				}
-        // 				return null;
-        // 			},
-        // 		},
+        // MARK: 2. HMR SSR reload
         hmrSsrReload(),
-        {
-            name: 'vite-plugin-gracile-serve-middleware',
-            apply: 'serve',
-            config(_, environment) {
-                if (environment.isPreview)
-                    return null;
-                return {
-                    // NOTE: Supresses message: `Could not auto-determine entry point from rollupOptions or html files…`
-                    // FIXME: It's not working when reloading the Vite config.
-                    // Is user config, putting `optimizeDeps: { include: [] }` solve this.
-                    optimizeDeps: { include: [] },
-                    // NOTE: Useful? It breaks preview (expected)
-                    appType: 'custom',
-                    // resolve: {
-                    // 	conditions: ['development'],
-                    // },
-                };
-            },
-            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.
+        // MARK: 3. Dev serve middleware
+        gracileServePlugin({
+            state,
+            config,
+            logger,
+            resetClientBuiltFlag: () => {
                 isClientBuilt = false;
-                // Infos
-                // // NOTE: Beware import.meta.resolve is only compatible
-                // // with v20.6.0 (without cli flag)and upward
-                // // Not working with StackBlitz ATM?
-                // const mainPjson = import.meta
-                // 	.resolve('@gracile/gracile')
-                // 	// NOTE: Weirdly, it will assume that it's `dist/**.js`,
-                // 	// even after fiddling with pjson exports.
-                // 	.replace('/dist/index.js', '/package.json');
-                // const { version } = JSON.parse(
-                // 	await readFile(new URL(mainPjson), 'utf-8'),
-                // ) as {
-                // 	version: number;
-                // };
-                const version = getVersion();
-                logger.info(`${c.cyan(c.italic(c.underline('🧚 Gracile')))}` +
-                    ` ${c.dim(`~`)} ${c.green(`v${version ?? 'X'}`)}`);
-                // ---
-                const { handler } = await createDevelopmentHandler({
-                    routes,
-                    vite: server,
-                    gracileConfig,
-                });
-                logger.info(c.dim('Vite development server is starting…'), {
-                    timestamp: true,
-                });
-                server.watcher.on('ready', () => {
-                    setTimeout(() => {
-                        logger.info('');
-                        logger.info(c.green('Watching for file changes…'), {
-                            timestamp: true,
-                        });
-                        logger.info('');
-                        // NOTE: We want it to show after the Vite intro stuff
-                    }, 100);
-                });
-                return () => {
-                    server.middlewares.use((request, response, next) => {
-                        const locals = config?.dev?.locals?.({ nodeRequest: request });
-                        Promise.resolve(nodeAdapter(handler, { logger })(request, response, locals)).catch((error) => next(error));
-                    });
-                };
             },
-        },
+        }),
+        // MARK: 4. Client virtual routes
         virtualRoutesForClient,
+        // MARK: 5. HTML routes loader
         htmlRoutesLoader(),
-        {
-            name: 'vite-plugin-gracile-build',
-            apply: 'build',
-            async config(viteConfig) {
-                const viteServerForClientHtmlBuild = await createServer({
-                    // configFile: false,
-                    root: viteConfig.root || process.cwd(),
-                    server: { middlewareMode: true },
-                    // NOTE: Stub. KEEP IT!
-                    optimizeDeps: { include: [] },
-                    plugins: [virtualRoutesForClient],
-                });
-                // NOTE: Important. Get the dev. server elements renderers.
-                gracileConfig.litSsr ??= {};
-                gracileConfig.litSsr.renderInfo = getPluginContext(viteServerForClientHtmlBuild.config)?.litSsrRenderInfo;
-                const htmlPages = await buildRoutes({
-                    viteServerForBuild: viteServerForClientHtmlBuild,
-                    root: viteConfig.root || process.cwd(),
-                    gracileConfig,
-                    serverMode: outputMode === 'server',
-                    routes,
-                });
-                renderedRoutes = htmlPages.renderedRoutes;
-                await viteServerForClientHtmlBuild.close();
-                return {
-                    build: {
-                        // ssrManifest: true,
-                        rollupOptions: {
-                            input: htmlPages.inputList,
-                            plugins: [htmlPages.plugin],
-                        },
-                        outDir: join(viteConfig.build?.outDir || 'dist', outputMode === 'server' ? 'client' : ''),
-                    },
-                };
-            },
-        },
-        {
-            name: 'vite-plugin-gracile-collect-client-assets-for-server',
-            writeBundle(_, bundle) {
-                if (outputMode === 'static')
-                    return;
-                for (const file of Object.values(bundle))
-                    if (file.type === 'asset' && file.name)
-                        clientAssets[file.name] = file.fileName;
-            },
-        },
-        {
-            name: 'vite-plugin-gracile-server-build',
-            apply: 'build',
-            config(viteConfig) {
-                root = viteConfig.root || null;
-            },
-            async closeBundle() {
-                if (outputMode === 'static' || !routes || !renderedRoutes)
-                    return;
-                await build({
-                    root: root || process.cwd(),
-                    ssr: { external: ['@gracile/gracile'] },
-                    build: {
-                        target: 'esnext',
-                        ssr: true,
-                        // ssrManifest: true,
-                        copyPublicDir: false,
-                        outDir: 'dist/server',
-                        ssrEmitAssets: true,
-                        cssMinify: true,
-                        cssCodeSplit: true,
-                        rollupOptions: {
-                            input: 'entrypoint.js',
-                            // external: ['@gracile/gracile'],
-                            // FIXME: ~~MUST import css from client somewhere.~~
-                            // ~~Hack could be using dynamic imports on client, so asset is picked up~~
-                            output: {
-                                entryFileNames: '[name].js',
-                                // assetFileNames: 'assets/[name].[ext]',
-                                // NOTE: Useful for, e.g., link tag with `?url`
-                                assetFileNames: (chunkInfo) => {
-                                    if (chunkInfo.name) {
-                                        const fileName = clientAssets[chunkInfo.name];
-                                        if (fileName)
-                                            return fileName;
-                                        // NOTE: When not imported at all from client
-                                        return `assets/${chunkInfo.name.replace(/\.(.*)$/, '')}-[hash].[ext]`;
-                                    }
-                                    // throw new Error(`Not a client asset`);
-                                    return 'assets/[name]-[hash].[ext]';
-                                },
-                                chunkFileNames: 'chunk/[name].js',
-                            },
-                        },
-                    },
-                    plugins: [
-                        virtualRoutesForClient,
-                        virtualRoutes({ routes, renderedRoutes }),
-                        {
-                            name: 'vite-plugin-gracile-entry',
-                            resolveId(id) {
-                                if (id === 'entrypoint.js') {
-                                    return id;
-                                }
-                                return null;
-                            },
-                            load(id) {
-                                if (id === 'entrypoint.js' && routes && renderedRoutes) {
-                                    return `
-import { routeAssets, routeImports, routes } from 'gracile:routes';
-import { createGracileHandler } from '@gracile/gracile/_internals/server-runtime';
-import { createLogger } from '@gracile/gracile/_internals/logger';
-
-createLogger();
-
-export const handler = createGracileHandler({
-	root: process.cwd(),
-	routes,
-	routeImports,
-	routeAssets,
-	serverMode: true,
-	gracileConfig: ${JSON.stringify(gracileConfig, null, 2)}
-});
-`;
-                                }
-                                return null;
-                            },
-                        },
-                        {
-                            name: 'gracile-move-server-assets',
-                            async writeBundle(_, bundle) {
-                                const cwd = root || process.cwd();
-                                await Promise.all(Object.entries(bundle).map(async ([file]) => {
-                                    if (file.startsWith('assets/') === false)
-                                        return;
-                                    await rename(join(cwd, `/dist/server/${file}`), join(cwd, `/dist/client/${file}`));
-                                }));
-                                // NOTE: Disabled for now, because it conflict with test's folder comparer
-                                await rm(join(cwd, `/dist/server/assets`), {
-                                    recursive: true,
-                                }).catch(() => null);
-                            },
-                        },
-                    ],
-                });
-            },
-        },
+        // MARK: 6. Client build
+        gracileClientBuildPlugin({
+            state,
+            virtualRoutesForClient,
+        }),
+        // MARK: 7. Collect client assets for server
+        gracileCollectClientAssetsPlugin({ state }),
+        // MARK: 8. Server build (nested)
+        gracileServerBuildPlugin({
+            state,
+            virtualRoutesForClient,
+        }),
     ];
 };

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

@@ -0,0 +1,64 @@
+/**
+ * Pure, testable pipeline steps extracted from the route template renderer.
+ *
+ * Each function here is a focused stage of the document post-processing
+ * lifecycle. They are composed by `renderRouteTemplate` in
+ * `./route-template.ts`.
+ *
+ * @internal
+ */
+import { Readable } from 'node:stream';
+import type { RenderInfo } from '@lit-labs/ssr';
+export declare const REGEX_TAG_SCRIPT: RegExp;
+export declare const REGEX_TAG_LINK: RegExp;
+/**
+ * Concatenate multiple `Readable` streams into a single async iterable.
+ */
+export declare function concatStreams(...readables: Readable[]): AsyncGenerator<any, void, unknown>;
+/**
+ * Merge user-provided `RenderInfo` with the default `LitElementRenderer`.
+ * Always appends `LitElementRenderer` to whatever the user supplied.
+ */
+export declare function mergeRenderInfo(renderInfo: Partial<RenderInfo> | undefined): Partial<RenderInfo>;
+/**
+ * Inject sibling page assets into the rendered document HTML.
+ *
+ * Inserts the `PAGE_ASSETS_MARKER` before `</head>`, then replaces it
+ * with concrete `<script>` / `<link>` tags for each asset path.
+ *
+ * @param documentHtml  The rendered document string.
+ * @param pageAssets    Array of asset file paths (e.g. `['src/pages/about.css']`).
+ * @returns The document with asset tags injected (or unchanged if no assets).
+ */
+export declare function injectSiblingAssets(documentHtml: string, pageAssets: string[]): string;
+/**
+ * Prepend `<!doctype html>` if the document doesn't already start with one.
+ *
+ * @param documentHtml  The rendered document string.
+ * @returns The document guaranteed to start with a doctype declaration.
+ */
+export declare function ensureDoctype(documentHtml: string): string;
+/**
+ * The HMR error overlay script injected in dev mode.
+ * Returns the raw HTML string for the `<script>` tag.
+ */
+export declare function developmentOverlaySnippet(): string;
+/**
+ * Inject the dev overlay script right after `<head>`.
+ * Only applied when `mode === 'dev'`.
+ *
+ * @param documentHtml  The rendered document string.
+ * @returns The document with the overlay injected.
+ */
+export declare function injectDevelopmentOverlay(documentHtml: string): string;
+/**
+ * For server-output builds: strip dev-time `<script type="module">` and
+ * `<link rel="stylesheet">` tags, then inject the production asset string
+ * before `</head>`.
+ *
+ * @param documentHtml     The rendered document string.
+ * @param routeAssetsHtml  The production asset tags to inject.
+ * @returns The document with dev assets stripped and production assets injected.
+ */
+export declare function injectServerAssets(documentHtml: string, routeAssetsHtml: string): string;
+//# sourceMappingURL=route-template-pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"route-template-pipeline.d.ts","sourceRoot":"","sources":["../../src/render/route-template-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAMhD,eAAO,MAAM,gBAAgB,QACkC,CAAC;AAEhE,eAAO,MAAM,cAAc,QAA2B,CAAC;AAIvD;;GAEG;AACH,wBAAuB,aAAa,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,sCAM5D;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,GACzC,OAAO,CAAC,UAAU,CAAC,CAQrB;AASD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAClC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAAE,GAClB,MAAM,CA2BR;AAID;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAO1D;AAID;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAalD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKrE;AAID;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CACjC,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACrB,MAAM,CAWR"}

package/dist/render/route-template-pipeline.js

@@ -0,0 +1,144 @@
+/**
+ * Pure, testable pipeline steps extracted from the route template renderer.
+ *
+ * Each function here is a focused stage of the document post-processing
+ * lifecycle. They are composed by `renderRouteTemplate` in
+ * `./route-template.ts`.
+ *
+ * @internal
+ */
+import { Readable } from 'node:stream';
+import { html } from '@gracile/internal-utils/dummy-literals';
+import { LitElementRenderer } from '@lit-labs/ssr/lib/lit-element-renderer.js';
+import { PAGE_ASSETS_MARKER } from './markers.js';
+// ── Regexes (re-exported for testability) ────────────────────────────
+export const REGEX_TAG_SCRIPT = /\s?<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script\s*>\s?/gi;
+export const REGEX_TAG_LINK = /\s?<link\b[^>]*?>\s?/gi;
+// ── Helpers ──────────────────────────────────────────────────────────
+/**
+ * Concatenate multiple `Readable` streams into a single async iterable.
+ */
+export async function* concatStreams(...readables) {
+    for (const readable of readables) {
+        for await (const chunk of readable) {
+            yield chunk;
+        }
+    }
+}
+// ── 1. Merge render info ─────────────────────────────────────────────
+/**
+ * Merge user-provided `RenderInfo` with the default `LitElementRenderer`.
+ * Always appends `LitElementRenderer` to whatever the user supplied.
+ */
+export function mergeRenderInfo(renderInfo) {
+    return {
+        ...renderInfo,
+        elementRenderers: [
+            ...(renderInfo?.elementRenderers || []),
+            LitElementRenderer,
+        ],
+    };
+}
+// ── 2. Inject sibling page assets ───────────────────────────────────
+/** Regex matching JS/TS asset extensions. */
+const REGEX_SCRIPT_EXT = /\.(js|ts|jsx|tsx)$/;
+/** Regex matching CSS-like asset extensions. */
+const REGEX_STYLE_EXT = /\.(css|scss|sass|less|styl|stylus)$/;
+/**
+ * Inject sibling page assets into the rendered document HTML.
+ *
+ * Inserts the `PAGE_ASSETS_MARKER` before `</head>`, then replaces it
+ * with concrete `<script>` / `<link>` tags for each asset path.
+ *
+ * @param documentHtml  The rendered document string.
+ * @param pageAssets    Array of asset file paths (e.g. `['src/pages/about.css']`).
+ * @returns The document with asset tags injected (or unchanged if no assets).
+ */
+export function injectSiblingAssets(documentHtml, pageAssets) {
+    return documentHtml
+        .replace('</head>', `\n${PAGE_ASSETS_MARKER}</head>`)
+        .replace(PAGE_ASSETS_MARKER, pageAssets.length > 0
+        ? html `<!-- PAGE ASSETS -->` +
+            `${pageAssets
+                .map((path) => {
+                if (REGEX_SCRIPT_EXT.test(path)) {
+                    // prettier-ignore
+                    return html `		<script type="module" src="/${path}"></script>`;
+                }
+                if (REGEX_STYLE_EXT.test(path)) {
+                    // prettier-ignore
+                    return html `		<link rel="stylesheet" href="/${path}" />`;
+                }
+                // NOTE: Never called (filtered upstream in `collectRoutes`)
+                return null;
+            })
+                .join('\n')}` +
+            `<!-- /PAGE ASSETS -->\n		`
+        : '');
+}
+// ── 3. Ensure doctype ────────────────────────────────────────────────
+/**
+ * Prepend `<!doctype html>` if the document doesn't already start with one.
+ *
+ * @param documentHtml  The rendered document string.
+ * @returns The document guaranteed to start with a doctype declaration.
+ */
+export function ensureDoctype(documentHtml) {
+    if (documentHtml.trimStart().toLocaleLowerCase().startsWith('<!doctype') ===
+        false)
+        return `<!doctype html>\n${documentHtml}`;
+    return documentHtml;
+}
+// ── 4. Inject dev overlay ────────────────────────────────────────────
+/**
+ * The HMR error overlay script injected in dev mode.
+ * Returns the raw HTML string for the `<script>` tag.
+ */
+export function developmentOverlaySnippet() {
+    return html `
+		<script type="module">
+			if (import.meta.hot) {
+				import.meta.hot.on('gracile:ssr-error', (error) => {
+					console.error(error.message);
+				});
+				import.meta.hot.on('error', (payload) => {
+					console.error(payload.err.message);
+				});
+			}
+		</script>
+	`;
+}
+/**
+ * Inject the dev overlay script right after `<head>`.
+ * Only applied when `mode === 'dev'`.
+ *
+ * @param documentHtml  The rendered document string.
+ * @returns The document with the overlay injected.
+ */
+export function injectDevelopmentOverlay(documentHtml) {
+    return documentHtml.replace('<head>', `<head>\n${developmentOverlaySnippet()}`);
+}
+// ── 5. Inject server runtime assets ─────────────────────────────────
+/**
+ * For server-output builds: strip dev-time `<script type="module">` and
+ * `<link rel="stylesheet">` tags, then inject the production asset string
+ * before `</head>`.
+ *
+ * @param documentHtml     The rendered document string.
+ * @param routeAssetsHtml  The production asset tags to inject.
+ * @returns The document with dev assets stripped and production assets injected.
+ */
+export function injectServerAssets(documentHtml, routeAssetsHtml) {
+    return documentHtml
+        .replaceAll(REGEX_TAG_SCRIPT, (s) => {
+        if (s.includes(`type="module"`))
+            return '';
+        return s;
+    })
+        .replaceAll(REGEX_TAG_LINK, (s) => {
+        if (s.includes(`rel="stylesheet"`))
+            return '';
+        return s;
+    })
+        .replace('</head>', `${routeAssetsHtml}\n</head>`);
+}

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

@@ -3,8 +3,7 @@ import { type RenderInfo } from '@lit-labs/ssr';
 import type { ViteDevServer } from 'vite';
 import type { RouteInfos } from '../routes/match.js';
 import type * as R from '../routes/route.js';
-export declare const REGEX_TAG_SCRIPT: RegExp;
-export declare const REGEX_TAG_LINK: RegExp;
+export { REGEX_TAG_SCRIPT, REGEX_TAG_LINK } from './route-template-pipeline.js';
 export declare function renderRouteTemplate({ url, vite, mode, routeInfos, routeAssets, serverMode, docOnly, renderInfo, }: {
     url: string;
     vite?: ViteDevServer | undefined;

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;AAKvC,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAGxE,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;AAY7C,eAAO,MAAM,gBAAgB,QACkC,CAAC;AAEhE,eAAO,MAAM,cAAc,QAA2B,CAAC;AAEvD,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,CAyOhE"}
+{"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"}