@gracile/engine 0.6.0 → 0.7.0-next.1

package/dist/errors/pages.js

@@ -0,0 +1,135 @@
+import { html } from '@lit-labs/ssr';
+export function errorInline(error) {
+    return html `<!--  --></a>
+  <div data-ssr-error>
+    <strong style="color: red">SSR Template error!</strong>
+    <details>
+      <summary style="user-select: none; cursor: pointer">Stack trace</summary>
+      <pre style="overflow: auto">${error.stack}</pre>
+    </details>
+  </div>`;
+}
+const minimalStyles = () => html `<style>
+		html {
+			color-scheme: light dark;
+			font-size: 16px;
+			line-height: 1.23rem;
+			font-family: system-ui;
+		}
+	</style>`;
+const logo = () => 
+/* prettier-ignore */
+html `<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2" viewBox="0 0 630 630"><g transform="matrix(.877 .23499 -.25635 .95673 119.498 -60.39)"><circle cx="315" cy="315" r="315" style="fill:url(#a)"/><path d="M315 0c173.853 0 315 141.147 315 315S488.853 630 315 630 0 488.853 0 315 141.147 0 315 0Zm0 13.125c166.309 0 300.682 135.566 300.682 301.875S481.309 616.875 315 616.875C148.691 616.875 14.318 481.309 14.318 315S148.691 13.125 315 13.125Z" style="fill:#1a1a1e"/></g><path d="M.238.087A.195.195 0 0 1 .135.058.215.215 0 0 1 .06-.029a.293.293 0 0 1-.028-.135c0-.051.008-.103.024-.156a.699.699 0 0 1 .162-.278.475.475 0 0 1 .115-.089.258.258 0 0 1 .121-.032.14.14 0 0 1 .07.016c.017.011.03.026.038.044a.158.158 0 0 1 .011.058.215.215 0 0 1-.012.07.181.181 0 0 1-.034.058C.512-.458.496-.45.479-.45a.036.036 0 0 1-.022-.007.073.073 0 0 1-.02-.026.162.162 0 0 0 .034-.035.303.303 0 0 0 .032-.056.135.135 0 0 0 .014-.054.05.05 0 0 0-.012-.034C.496-.671.482-.675.463-.675a.16.16 0 0 0-.092.033.447.447 0 0 0-.091.089.764.764 0 0 0-.152.4c0 .061.013.108.04.141.026.034.057.051.094.051A.127.127 0 0 0 .338.013a.243.243 0 0 0 .061-.069.454.454 0 0 0 .062-.19.9.9 0 0 0-.051-.008 1.011 1.011 0 0 0-.056-.002H.322l-.034.002a.1.1 0 0 1 .029-.052.076.076 0 0 1 .051-.016c.02 0 .04.003.061.009a4.452 4.452 0 0 0 .123.039l-.01.031-.029.091a.854.854 0 0 0-.026.108l-.002.043.001.042.002.052C.468.09.453.085.444.076A.063.063 0 0 1 .425.044.148.148 0 0 1 .42.009v-.01l.001-.01a.317.317 0 0 1-.08.071.2.2 0 0 1-.103.027Z" style="fill-rule:nonzero" transform="translate(115.745 497.368) scale(589.0308)"/><path d="M6516.9 5139.28c-23.64 24.86-49.83 45.96-78.54 63.32-38.12 23.04-81.04 34.61-128.8 34.61-46.96 0-90.14-12.37-129.56-37.11-39.27-24.65-70.68-60.51-94.08-107.72-23.09-46.59-34.76-102.43-34.76-167.57 0-62.67 9.75-126.16 29.28-190.46 19.46-64.05 46.21-125.05 80.26-183.02 34.06-57.99 73-109.68 116.79-155.1 44.07-45.7 90.8-81.78 140.17-108.29 50.15-26.95 100.53-40.34 151.1-40.34 37.75 0 67.7 7.39 90.01 21.55 22.8 14.47 39.21 33.58 49.3 57.27 9.78 22.96 14.7 47.62 14.7 73.99 0 29.25-5.21 58.51-15.66 87.77-10.56 29.57-24.99 54.04-43.16 73.48-19.63 20.99-41.46 31.15-65.19 31.15-11.93 0-22.88-3.46-32.82-10.42-9.08-6.35-18.42-17.93-27.5-35.16-2.67-5.08-1.07-11.36 3.71-14.55 11.2-7.47 23.58-20.66 37.4-39.34 14.36-19.4 26.96-40.94 37.83-64.61 10.4-22.67 15.78-42.88 15.78-60.72 0-12.95-3.93-23.85-12.02-32.59-8.3-8.96-22.33-12.61-41.58-12.61-33.94 0-68.72 12.89-104.54 38.15-37.17 26.22-72.55 61.08-106.2 104.51-33.98 43.85-64.59 92.85-91.85 146.98-27.27 54.14-48.81 109.46-64.62 165.98-15.7 56.14-23.58 109.33-23.58 159.58 0 69.79 14.72 124.16 45.02 162.89 29.19 37.32 63.93 56.3 104.57 56.3 30.37 0 58.3-9.68 83.86-28.94 26.57-20.03 50.02-46.45 70.43-79.18 20.72-33.23 37.33-69.39 49.84-108.49 11.42-35.68 18.94-70.7 22.56-105.08-16.51-3-33.42-5.31-50.74-6.95-20.87-1.97-42.72-2.95-65.55-2.95-12.68 0-25.37.2-38.05.6-12.71.39-26.22.99-40.53 1.78a11.194 11.194 0 0 1-11.47-13.97c7.89-30.7 20.71-53.1 37.81-67.57 17.46-14.76 40.4-22.45 69.04-22.45 25.1 0 50.41 3.96 75.93 11.91 24.52 7.64 49.44 15.88 74.77 24.72 24.8 8.66 49.02 15.75 72.65 21.27 3.05.71 5.66 2.66 7.2 5.39 1.55 2.73 1.88 5.98.92 8.96 0 0-12 37.2-12.02 37.24-14.39 43.95-26.17 80.52-35.36 109.68-9.1 28.89-16.03 53.42-20.78 73.6-4.67 19.86-7.8 37.76-9.36 53.72-1.56 16.06-2.34 32.69-2.34 49.92 0 15.83.39 32.26 1.18 49.28.81 17.24 1.61 38.29 2.41 63.16.11 3.29-1.24 6.46-3.68 8.67a11.2 11.2 0 0 1-9 2.79c-26.84-3.58-46.58-11.82-59.55-23.9-13.28-12.36-21.92-26.81-26.04-43.29-3.23-12.91-5.09-25.52-5.59-37.84Zm-207.34 86.73c-44.8 0-86-11.8-123.6-35.4-37.6-23.6-67.6-58-90-103.2-22.4-45.2-33.6-99.4-33.6-162.6 0-61.6 9.6-124 28.8-187.2 19.2-63.2 45.6-123.4 79.2-180.6 33.6-57.2 72-108.2 115.2-153s89-80.2 137.4-106.2c48.4-26 97-39 145.8-39 35.2 0 63.2 6.6 84 19.8 20.8 13.2 35.8 30.6 45 52.2 9.2 21.6 13.8 44.8 13.8 69.6 0 28-5 56-15 84s-23.6 51.2-40.8 69.6c-17.2 18.4-36.2 27.6-57 27.6-9.6 0-18.4-2.8-26.4-8.4-8-5.6-16-16-24-31.2 12-8 25.4-22 40.2-42 14.8-20 27.8-42.2 39-66.6 11.2-24.4 16.8-46.2 16.8-65.4 0-16-5-29.4-15-40.2-10-10.8-26.6-16.2-49.8-16.2-36 0-73 13.4-111 40.2-38 26.8-74.2 62.4-108.6 106.8-34.4 44.4-65.4 94-93 148.8-27.6 54.8-49.4 110.8-65.4 168-16 57.2-24 111.4-24 162.6 0 72.8 15.8 129.4 47.4 169.8 31.6 40.4 69.4 60.6 113.4 60.6 32.8 0 63-10.4 90.6-31.2 27.6-20.8 52-48.2 73.2-82.2 21.2-34 38.2-71 51-111 12.8-40 20.8-79.2 24-117.6-20-4-40.6-7-61.8-9-21.2-2-43.4-3-66.6-3-12.8 0-25.6.2-38.4.6-12.8.4-26.4 1-40.8 1.8 7.2-28 18.6-48.6 34.2-61.8 15.6-13.2 36.2-19.8 61.8-19.8 24 0 48.2 3.8 72.6 11.4 24.4 7.6 49.2 15.8 74.4 24.6 25.2 8.8 49.8 16 73.8 21.6l-12 37.2c-14.4 44-26.2 80.6-35.4 109.8-9.2 29.2-16.2 54-21 74.4-4.8 20.4-8 38.8-9.6 55.2-1.6 16.4-2.4 33.4-2.4 51 0 16 .4 32.6 1.2 49.8.8 17.2 1.6 38.2 2.4 63-24-3.2-41.8-10.2-53.4-21-11.6-10.8-19.2-23.4-22.8-37.8-3.6-14.4-5.4-28.4-5.4-42v-12c0-4 .4-8 1.2-12-28 34.4-60.2 62.6-96.6 84.6-36.4 22-77.4 33-123 33Z" style="fill:#fff" transform="matrix(.49086 0 0 .49086 -2841.17 -2016.62)"/><defs><radialGradient id="a" cx="0" cy="0" r="1" gradientTransform="matrix(315 0 0 315 315 315)" gradientUnits="userSpaceOnUse"><stop offset="0" style="stop-color:white;stop-opacity:1"/><stop offset="1" style="stop-color:#57d5a3;stop-opacity:1"/></radialGradient></defs></svg>`;
+export function builtIn404Page(path, dev = false) {
+    return html `
+		<!doctype html>
+		<html lang="en">
+			<head>
+				<meta charset="UTF-8" />
+				<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+				<meta name="generator" content="Gracile" />
+				<title>404: Not found</title>
+
+				${minimalStyles()}
+				<style>
+					body {
+						padding: 1rem;
+					}
+
+					pre {
+						padding: 0.5rem 0.75rem;
+
+						overflow-y: auto;
+					}
+
+					button {
+						font-size: 2rem;
+					}
+
+					h1 {
+						color: tomato;
+					}
+
+					pre {
+						border: 1px solid grey;
+						border-radius: 0.15rem;
+						padding: 1rem;
+					}
+
+					.middle {
+						width: 100%;
+						height: 100dvh;
+						display: flex;
+						align-items: center;
+						justify-content: center;
+						flex-direction: column;
+						position: relative;
+						top: -5dvh;
+					}
+
+					.gracile-logo {
+						height: 8rem;
+						width: 8rem;
+						margin: 4rem;
+					}
+
+					section {
+						text-align: center;
+					}
+				</style>
+			</head>
+			<body>
+				<main class="middle">
+					<div class="gracile-logo">${logo()}</div>
+
+					<h1>404: Not found</h1>
+
+					<section>
+						<div>Path:</div>
+						<pre>${path}</pre>
+					</section>
+
+					${dev
+        ? html ` <section>
+								<p>The page or route may be not configured properly.</p>
+
+								<p>
+									See
+									<a
+										target="_blank"
+										href="https://gracile.js.org/docs/learn/usage/defining-routes/"
+										>Defining routes</a
+									>
+									in the documentation.
+								</p>
+							</section>`
+        : null}
+				</main>
+			</body>
+		</html>
+	`;
+}
+// TODO: Extract
+// const ESCAPE_SEQUENCE_CHARACTER =
+// 	// eslint-disable-next-line no-control-regex
+// 	/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
+export function builtInErrorPage(name = 'Error', dev = false) {
+    const title = `500: ${name ? `${name} | ` : ''}Internal Server Error`;
+    return html `
+		<!doctype html>
+		<html lang="en">
+			<head>
+				<meta charset="UTF-8" />
+				<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+				<title>${title}</title>
+				${minimalStyles()}
+				${dev
+        ? html `<script type="module" src="/@vite/client"></script>`
+        : null}
+			</head>
+			<body>
+				<h1>${title}</h1>
+			</body>
+		</html>
+	`;
+}

package/dist/logging/messages.d.ts

@@ -0,0 +1,2 @@
+export declare function emptyRoutes(): string;
+//# sourceMappingURL=messages.d.ts.map

package/dist/logging/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/logging/messages.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,WAO1B"}

package/dist/logging/messages.js

@@ -0,0 +1,6 @@
+import c from 'picocolors';
+export function emptyRoutes() {
+    const message = c.yellow(`No route were found in the \`src/routes/\` folder.\n\n`) +
+        c.magenta(`▶ See https://gracile.js.org/docs/learn/usage/defining-routes/.`);
+    return `${message}\n`;
+}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD,YAAY,EAAE,aAAa,EAAE,CAAC;AAI9B;;;;;;;;;;;;;;;;;GAiBG;AAGH,eAAO,MAAM,OAAO,YAAa,aAAa,KAAG,GAAG,EA4QnD,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOtD,YAAY,EAAE,aAAa,EAAE,CAAC;AAI9B;;;;;;;;;;;;;;;;;GAiBG;AAIH,eAAO,MAAM,OAAO,YAAa,aAAa,KAAG,GAAG,EAyTnD,CAAC"}

package/dist/plugin.js

@@ -1,5 +1,7 @@
 import { join } from 'node:path';
-import { logger } from '@gracile/internal-utils/logger';
+import { createLogger } from '@gracile/internal-utils/logger/helpers';
+import { getVersion } from '@gracile/internal-utils/version';
+import { betterErrors } from '@gracile-labs/better-errors/plugin';
 import { rename, rm } from 'fs/promises';
 import c from 'picocolors';
 import { build, createServer } from 'vite';
@@ -7,7 +9,7 @@ import {} from './build/static.js';
 import { createDevHandler } from './dev/dev.js';
 import { nodeAdapter } from './server/adapters/node.js';
 import { buildRoutes } from './vite/plugins/build-routes.js';
-import { virtualRoutes } from './vite/plugins/virtual-routes.js';
+import { virtualRoutes, virtualRoutesClient, } from './vite/plugins/virtual-routes.js';
 let isClientBuilt = false;
 /**
  * The main Vite plugin for loading the Gracile framework.
@@ -27,51 +29,73 @@ let isClientBuilt = false;
  * });
  * ```
  */
-// Return as `any` to avoid Plugin type mismatches when there are multiple Vite versions installed
+// NOTE: for Vite versions mismatches with `exactOptionalPropertyTypes`?
+// This `any[]` AND with a plugin -array- makes ESLint and TS shut up.
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export const gracile = (config) => {
+    const logger = createLogger();
     const outputMode = config?.output || 'static';
     const clientAssets = {};
-    let routes = null;
+    const routes = new Map();
     let renderedRoutes = null;
     let root = null;
     const gracileConfig = config || {};
     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,
+    });
     return [
-        {
-            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;
-            },
-        },
+        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;
+        // 			},
+        // 		},
         {
             name: 'vite-plugin-gracile-serve-middleware',
             apply: 'serve',
-            config() {
+            config(_, env) {
+                if (env.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) {
@@ -89,22 +113,37 @@ return input;
                 // ) as {
                 // 	version: number;
                 // };
-                const version = process.env['__GRACILE_VERSION__'];
-                logger.info(`${c.cyan(c.italic(c.underline('🧚 Gracile ')))}` +
-                    ` ${c.green(` v${version ?? 'X'}`)}`);
+                const version = getVersion();
+                logger.info(`${c.cyan(c.italic(c.underline('🧚 Gracile')))}` +
+                    ` ${c.dim(`~`)} ${c.green(`v${version ?? 'X'}`)}`);
                 // ---
                 const { handler } = await createDevHandler({
+                    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('');
+                    }, 100);
+                    // s
+                });
                 return () => {
                     server.middlewares.use((req, res, next) => {
                         const locals = config?.dev?.locals?.({ nodeRequest: req });
-                        Promise.resolve(nodeAdapter(handler)(req, res, locals)).catch((error) => next(error));
+                        Promise.resolve(nodeAdapter(handler, { logger })(req, res, locals)).catch((error) => next(error));
                     });
                 };
             },
         },
+        virtualRoutesForClient,
         {
             name: 'vite-plugin-gracile-build',
             apply: 'build',
@@ -115,14 +154,15 @@ return input;
                     server: { middlewareMode: true },
                     // NOTE: Stub. KEEP IT!
                     optimizeDeps: { include: [] },
+                    plugins: [virtualRoutesForClient],
                 });
                 const htmlPages = await buildRoutes({
                     viteServerForBuild: viteServerForClientHtmlBuild,
                     root: viteConfig.root || process.cwd(),
                     gracileConfig,
                     serverMode: outputMode === 'server',
+                    routes,
                 });
-                routes = htmlPages.routes;
                 renderedRoutes = htmlPages.renderedRoutes;
                 await viteServerForClientHtmlBuild.close();
                 return {
@@ -180,7 +220,6 @@ return input;
                                 // NOTE: Useful for, e.g., link tag with `?url`
                                 assetFileNames: (chunkInfo) => {
                                     if (chunkInfo.name) {
-                                        //  (chunkInfo);
                                         const fileName = clientAssets[chunkInfo.name];
                                         if (fileName)
                                             return fileName;
@@ -195,10 +234,8 @@ return input;
                         },
                     },
                     plugins: [
-                        virtualRoutes({
-                            routes,
-                            renderedRoutes,
-                        }),
+                        virtualRoutesForClient,
+                        virtualRoutes({ routes, renderedRoutes }),
                         {
                             name: 'vite-plugin-gracile-entry',
                             resolveId(id) {
@@ -211,16 +248,18 @@ return input;
                                 if (id === 'entrypoint.js' && routes && renderedRoutes) {
                                     return `
 import { routeAssets, routeImports, routes } from 'gracile:routes';
-import { createGracileMiddleware } from '@gracile/gracile/_internals/server-runtime';
+import { createGracileHandler } from '@gracile/gracile/_internals/server-runtime';
+import { createLogger } from '@gracile/gracile/_internals/logger';
 
-//  ({ routeAssets, routeImports, routes })
+createLogger();
 
-export const handler = createGracileMiddleware({
+export const handler = createGracileHandler({
 	root: process.cwd(),
 	routes,
 	routeImports,
 	routeAssets,
 	serverMode: true,
+	gracileConfig: ${JSON.stringify(gracileConfig, null, 2)}
 });
 `;
                                 }

package/dist/render/markers.d.ts

@@ -0,0 +1,3 @@
+export declare const SSR_OUTLET_MARKER = "<route-template-outlet></route-template-outlet>";
+export declare const PAGE_ASSETS_MARKER = "<!--__GRACILE_PAGE_ASSETS__-->";
+//# sourceMappingURL=markers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../src/render/markers.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,iBAAiB,oDACoB,CAAC;AAGnD,eAAO,MAAM,kBAAkB,mCAAmC,CAAC"}

package/dist/render/markers.js

@@ -0,0 +1,4 @@
+// export const SSR_OUTLET_MARKER = '________SSR_OUTLET________';
+export const SSR_OUTLET_MARKER = '<route-template-outlet></route-template-outlet>';
+// const SSR_OUTLET = unsafeHTML(SSR_OUTLET_MARKER);
+export const PAGE_ASSETS_MARKER = '<!--__GRACILE_PAGE_ASSETS__-->';

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

@@ -1,25 +1,20 @@
-import { Readable } from 'stream';
+import { Readable } from 'node:stream';
 import type { ViteDevServer } from 'vite';
 import type { RouteInfos } from '../routes/match.js';
 import type * as R from '../routes/route.js';
-export declare const SSR_OUTLET_MARKER = "<route-template-outlet></route-template-outlet>";
-export declare const PAGE_ASSETS_MARKER = "<!--__GRACILE_PAGE_ASSETS__-->";
 export declare const REGEX_TAG_SCRIPT: RegExp;
 export declare const REGEX_TAG_LINK: RegExp;
-export type HandlerInfos = {
-    data: unknown;
-    method: string;
-};
-export declare function renderRouteTemplate({ request, vite, mode, routeInfos, handlerInfos, routeAssets, serverMode, }: {
-    request: Request | R.StaticRequest;
+export declare function renderRouteTemplate({ url, vite, mode, routeInfos, routeAssets, serverMode, docOnly, }: {
+    url: string;
     vite?: ViteDevServer | undefined;
     mode: 'dev' | 'build';
     routeInfos: RouteInfos;
-    handlerInfos?: HandlerInfos | undefined;
     routeAssets?: R.RoutesAssets | undefined;
     root: string;
     serverMode?: boolean | undefined;
+    docOnly?: boolean | undefined;
 }): Promise<{
     output: null | Readable;
+    document: null | string;
 }>;
 //# sourceMappingURL=route-template.d.ts.map

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":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,KAAK,CAAC,MAAM,oBAAoB,CAAC;AAa7C,eAAO,MAAM,iBAAiB,oDACoB,CAAC;AAGnD,eAAO,MAAM,kBAAkB,mCAAmC,CAAC;AAEnE,eAAO,MAAM,gBAAgB,QACkC,CAAC;AAEhE,eAAO,MAAM,cAAc,QAA2B,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAsB,mBAAmB,CAAC,EACzC,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,WAAW,EAEX,UAAU,GACV,EAAE;IACF,OAAO,EAAE,OAAO,GAAG,CAAC,CAAC,aAAa,CAAC;IACnC,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACxC,WAAW,CAAC,EAAE,CAAC,CAAC,YAAY,GAAG,SAAS,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAA;CAAE,CAAC,CA0LvC"}
+{"version":3,"file":"route-template.d.ts","sourceRoot":"","sources":["../../src/render/route-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAOvC,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,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,GACP,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;CAC9B,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAC,CAqNhE"}

package/dist/render/route-template.js

@@ -1,8 +1,10 @@
+import { Readable } from 'node:stream';
+import * as assert from '@gracile/internal-utils/assertions';
 import { html } from '@gracile/internal-utils/dummy-literals';
 import { render as renderLitSsr } from '@lit-labs/ssr';
 import { collectResult } from '@lit-labs/ssr/lib/render-result.js';
-import { Readable } from 'stream';
-import { isLitServerTemplate, isLitTemplate } from '../assertions.js';
+import { GracileError, GracileErrorData, TemplateError, } from '../errors/errors.js';
+import { PAGE_ASSETS_MARKER, SSR_OUTLET_MARKER } from './markers.js';
 async function* concatStreams(...readables) {
     // eslint-disable-next-line no-restricted-syntax
     for (const readable of readables) {
@@ -12,71 +14,87 @@ async function* concatStreams(...readables) {
         }
     }
 }
-// export const SSR_OUTLET_MARKER = '________SSR_OUTLET________';
-export const SSR_OUTLET_MARKER = '<route-template-outlet></route-template-outlet>';
-// const SSR_OUTLET = unsafeHTML(SSR_OUTLET_MARKER);
-export const PAGE_ASSETS_MARKER = '<!--__GRACILE_PAGE_ASSETS__-->';
 export const REGEX_TAG_SCRIPT = /\s?<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script\s*>\s?/gi;
 export const REGEX_TAG_LINK = /\s?<link\b[^>]*?>\s?/gi;
-export async function renderRouteTemplate({ request, vite, mode, routeInfos, handlerInfos, routeAssets, 
-// root,
-serverMode, }) {
+export async function renderRouteTemplate({ url, vite, mode, routeInfos, routeAssets, serverMode, docOnly, }) {
+    const location = {
+        file: routeInfos.foundRoute.filePath,
+    };
     if (!routeInfos.routeModule.document && !routeInfos.routeModule.template)
-        return { output: null };
+        return { output: null, document: null };
     // MARK: Context
     const context = {
-        url: new URL(request.url),
+        url: new URL(url),
         params: routeInfos.params,
-        props: handlerInfos?.data
-            ? {
-                [handlerInfos.method]: handlerInfos.data,
-            }
-            : routeInfos.props,
+        props: routeInfos.props,
     };
     // MARK: Fragment
     if (!routeInfos.routeModule.document && routeInfos.routeModule.template) {
         const fragmentOutput = await Promise.resolve(routeInfos.routeModule.template?.(context));
-        if (isLitTemplate(fragmentOutput) === false)
-            throw Error(`Wrong template result for fragment template ${routeInfos.foundRoute.filePath}.`);
+        if (assert.isLitTemplate(fragmentOutput) === false)
+            throw new GracileError({
+                ...GracileErrorData.InvalidRouteDocument,
+                message: GracileErrorData.InvalidRouteDocument.message(location.file),
+                // location,
+            });
         const fragmentRender = renderLitSsr(fragmentOutput);
         const output = Readable.from(fragmentRender);
-        return { output };
+        return { output, document: null };
     }
     // MARK: Document
     if (!routeInfos.routeModule.document ||
         typeof routeInfos.routeModule.document !== 'function')
-        throw new TypeError(`Route document must be a function ${routeInfos.foundRoute.filePath}.`);
+        throw new GracileError({
+            ...GracileErrorData.InvalidRouteDocument,
+            message: GracileErrorData.InvalidRouteDocument.message(location.file),
+            location,
+        });
     const baseDocTemplateResult = await Promise.resolve(routeInfos.routeModule.document?.(context));
-    if (isLitServerTemplate(baseDocTemplateResult) === false)
-        throw new TypeError(`Incorrect document template result for ${routeInfos.foundRoute.filePath}.`);
-    const baseDocRendered = await collectResult(renderLitSsr(baseDocTemplateResult));
+    if (assert.isLitServerTemplate(baseDocTemplateResult) === false)
+        throw new GracileError({
+            ...GracileErrorData.InvalidRouteDocumentResult,
+            message: GracileErrorData.InvalidRouteDocumentResult.message(location.file),
+            location,
+        });
+    let baseDocRendered;
+    // console.log({ ddd: baseDocTemplateResult });
+    try {
+        baseDocRendered = await collectResult(renderLitSsr(baseDocTemplateResult));
+    }
+    catch (e) {
+        throw new TemplateError({
+            ...GracileErrorData.CouldNotRenderRouteDocument,
+            message: GracileErrorData.CouldNotRenderRouteDocument.message(location.file),
+            location,
+        }, { cause: String(e) });
+    }
     // MARK: Sibling assets
     let baseDocRenderedWithAssets = baseDocRendered;
     // If the user doesnt use `pageAssetCustomLocation`, we put this as a fallback
     baseDocRenderedWithAssets = baseDocRenderedWithAssets
-        .replace('</head>', `${PAGE_ASSETS_MARKER}</head>`)
+        .replace('</head>', `\n${PAGE_ASSETS_MARKER}</head>`)
         .replace(PAGE_ASSETS_MARKER, 
     // eslint-disable-next-line prefer-template
-    html `
-				<!-- PAGE ASSETS -->
-				${routeInfos.foundRoute.pageAssets.map((path) => {
-        //
-        if (/\.(js|ts)$/.test(path)) {
-            return html `
-							<script type="module" src="/${path}"></script>
-							<!--  -->
-						`;
-        }
-        if (/\.(css|scss|sass|less|styl|stylus)$/.test(path)) {
-            return html `
-							<link rel="stylesheet" href="/${path}" />
-							<!--  -->
-						`;
-        }
-        throw new Error('Unknown asset.');
-    })}
-				<!-- /PAGE ASSETS -->
-			`);
+    routeInfos.foundRoute.pageAssets.length
+        ? // eslint-disable-next-line prefer-template
+            html `<!-- PAGE ASSETS -->` +
+                `${routeInfos.foundRoute.pageAssets
+                    .map((path) => {
+                    //
+                    if (/\.(js|ts)$/.test(path)) {
+                        // prettier-ignore
+                        return html `		<script type="module" src="/${path}"></script>`;
+                    }
+                    if (/\.(css|scss|sass|less|styl|stylus)$/.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		`
+        : '');
     // MARK: Dev. overlay
     // TODO: Need more testing and refinement (refreshes kills its usefulness)
     const overlay = () => html `
@@ -118,6 +136,8 @@ serverMode, }) {
         // `${routeInfos.pathname}?r=${Math.random()}`,
         routeInfos.pathname, baseDocRenderedWithAssets)
         : baseDocRenderedWithAssets;
+    if (docOnly)
+        return { document: baseDocHtml, output: null };
     const index = baseDocHtml.indexOf(SSR_OUTLET_MARKER);
     const baseDocRenderStreamPre = Readable.from(baseDocHtml.substring(0, index));
     const baseDocRenderStreamPost = Readable.from(baseDocHtml.substring(index + SSR_OUTLET_MARKER.length + 1));
@@ -134,15 +154,15 @@ serverMode, }) {
         // 	const output = Readable.from(
         // 		concatStreams(baseDocRenderStreamPre, baseDocRenderStreamPost),
         // 	);
-        // 	return { output };
+        // 	return { output, document: null };
         // }
-        if (isLitTemplate(routeOutput) === false)
+        if (assert.isLitTemplate(routeOutput) === false)
             throw Error(`Wrong template result for page template ${routeInfos.foundRoute.filePath}.`);
         const renderStream = Readable.from(renderLitSsr(routeOutput));
         const output = Readable.from(concatStreams(baseDocRenderStreamPre, renderStream, baseDocRenderStreamPost));
-        return { output };
+        return { output, document: baseDocHtml };
     }
     // MARK: Just the document
     const output = Readable.from(baseDocHtml);
-    return { output };
+    return { output, document: baseDocHtml };
 }

package/dist/render/utils.d.ts

@@ -1,3 +1,26 @@
 import { type ServerRenderedTemplate } from '@lit-labs/ssr';
-export declare function renderSsrTemplate(template: ServerRenderedTemplate): Promise<string>;
+import type { TemplateResult } from 'lit';
+/**
+ * Just a tiny wrapper for `render` and `collectResult` from `@lit-labs/ssr`.
+ *
+ * Useful for testing server only partials.
+ *
+ * @example
+ * ```js
+ * import assert from 'node:assert';
+ * import {
+ * 	html,
+ * 	type ServerRenderedTemplate,
+ * } from '@gracile/gracile/server-html';
+ *
+ * const myServerTemplate1 = (): ServerRenderedTemplate => html`
+ * 	<div>Hello</div>
+ * `;
+ *
+ * const result = await renderLitTemplate(myServerTemplate1());
+ *
+ * assert.match(result, /Hello/);
+ * ```
+ */
+export declare function renderLitTemplate(template: ServerRenderedTemplate | TemplateResult<1>): Promise<string>;
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/render/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,sBAAsB,EAC3B,MAAM,eAAe,CAAC;AAGvB,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,sBAAsB,mBAEvE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/render/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,sBAAsB,EAC3B,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,iBAAiB,CACtC,QAAQ,EAAE,sBAAsB,GAAG,cAAc,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAEjB"}