@gracile/engine 0.7.0-next.0 → 0.7.0

package/dist/build/static.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/build/static.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAK1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,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;AAeD,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;;;GAmJA"}
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/build/static.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAK1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,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;AAeD,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;;;GAwJA"}

package/dist/build/static.js

@@ -1,6 +1,6 @@
 import { Buffer } from 'node:buffer';
 import path, { join } from 'node:path';
-import { logger } from '@gracile/internal-utils/logger';
+import { getLogger } from '@gracile/internal-utils/logger/helpers';
 import c from 'picocolors';
 import { renderRouteTemplate } from '../render/route-template.js';
 import { collectRoutes } from '../routes/collect.js';
@@ -18,6 +18,7 @@ async function streamToString(stream) {
     return Buffer.concat(chunks).toString('utf-8');
 }
 export async function renderRoutes({ routes, vite, serverMode, root = process.cwd(), gracileConfig, }) {
+    const logger = getLogger();
     logger.info(c.green('Rendering routes…'), { timestamp: true });
     // MARK: Collect
     await collectRoutes(routes, root, gracileConfig.routes?.exclude);
@@ -83,6 +84,8 @@ export async function renderRoutes({ routes, vite, serverMode, root = process.cw
                 : 'index.html');
             if (name === '404/index.html')
                 name = '404.html';
+            if (name === '500/index.html')
+                name = '500.html';
             const url = new URL(pathnameWithParams, 'http://gracile-static');
             // MARK: Render
             const { output, document } = await renderRouteTemplate({
@@ -103,6 +106,8 @@ export async function renderRoutes({ routes, vite, serverMode, root = process.cw
             });
             const htmlString = output ? await streamToString(output) : null;
             const existing = renderedRoutes.find((rendered) => rendered?.name === name);
+            // NOTE: IIRC, this happens when two or more routes has the
+            // same priority, that will output the same static path.
             if (existing)
                 throw new Error(`${c.red(`"${existing.name}" page was defined twice!`)}\n`);
             const savePrerender = routeModule.prerender || null;

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

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/dev/dev.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;AAGvD,wBAAsB,gBAAgB,CAAC,EACtC,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,CA4CD"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/dev/dev.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;AAGvD,wBAAsB,gBAAgB,CAAC,EACtC,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"}

package/dist/dev/dev.js

@@ -1,26 +1,33 @@
-import { logger } from '@gracile/internal-utils/logger';
+import { getLogger } from '@gracile/internal-utils/logger/helpers';
 import c from 'picocolors';
 import {} from 'vite';
-import { collectRoutes } from '../routes/collect.js';
+import { collectRoutes, WATCHED_FILES_REGEX } from '../routes/collect.js';
 import { createGracileHandler, } from '../server/request.js';
 import { generateRoutesTypings } from './route-typings.js';
 export async function createDevHandler({ routes, vite, gracileConfig, }) {
+    const logger = getLogger();
     const root = vite.config.root;
-    logger.info(c.dim('\nCreating handler…'), { timestamp: true });
-    await collectRoutes(routes, root, gracileConfig.routes?.exclude);
-    if (gracileConfig.experimental?.generateRoutesTypings)
-        generateRoutesTypings(root, routes).catch((error) => logger.error(String(error)));
+    logger.info('');
+    logger.info(c.dim('Creating the request handler…'), { timestamp: true });
+    const collect = async () => {
+        await collectRoutes(routes, root, gracileConfig.routes?.exclude);
+        if (gracileConfig.experimental?.generateRoutesTypings)
+            await generateRoutesTypings(root, routes).catch((error) => logger.error(String(error)));
+    };
+    await collect();
+    let wait;
     vite.watcher.on('all', (event, file) => {
-        // console.log({ event });
-        if (file.match(/\/src\/routes\/(.*)\.(ts|js|css|scss|sass|less|styl|stylus)$/) &&
-            ['add', 'unlink'].includes(event))
-            collectRoutes(routes, root, gracileConfig.routes?.exclude)
-                .then(() => {
-                vite.hot.send('vite:invalidate');
-                if (gracileConfig.experimental?.generateRoutesTypings)
-                    generateRoutesTypings(root, routes).catch((error) => logger.error(String(error)));
-            })
-                .catch((e) => logger.error(String(e)));
+        if (file.match(WATCHED_FILES_REGEX) &&
+            ['add', 'unlink'].includes(event)
+        //
+        ) {
+            clearTimeout(wait);
+            wait = setTimeout(() => {
+                collect()
+                    .then(() => vite.hot.send('vite:invalidate'))
+                    .catch((error) => logger.error(String(error)));
+            }, 100);
+        }
     });
     //
     // NOTE: Wrong place?

package/dist/dev/vite-logger.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vite-logger.d.ts.map

package/dist/dev/vite-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-logger.d.ts","sourceRoot":"","sources":["../../src/dev/vite-logger.ts"],"names":[],"mappings":""}

package/dist/dev/vite-logger.js

@@ -0,0 +1,2 @@
+import { createGracileViteLogger } from '@gracile/internal-utils/logger/vite-logger';
+createGracileViteLogger();

package/dist/errors/create-vite-better-error.d.ts

@@ -0,0 +1,6 @@
+import type { ViteDevServer } from 'vite';
+export declare function emitViteBetterError({ error, vite, }: {
+    error: Error;
+    vite: ViteDevServer;
+}): Promise<string>;
+//# sourceMappingURL=create-vite-better-error.d.ts.map

package/dist/errors/create-vite-better-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-vite-better-error.d.ts","sourceRoot":"","sources":["../../src/errors/create-vite-better-error.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,MAAM,CAAC;AAQxD,wBAAsB,mBAAmB,CAAC,EACzC,KAAK,EACL,IAAI,GACJ,EAAE;IACF,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;CACpB,mBA6BA"}

package/dist/errors/create-vite-better-error.js

@@ -0,0 +1,27 @@
+import { pathToFileURL } from 'node:url';
+import { getLogger } from '@gracile/internal-utils/logger/helpers';
+import { formatErrorMessage } from '@gracile-labs/better-errors/dev/logger';
+import { collectErrorMetadata } from '@gracile-labs/better-errors/dev/utils';
+import { getViteErrorPayload } from '@gracile-labs/better-errors/dev/vite';
+import { renderLitTemplate } from '../render/utils.js';
+import { GRACILE_JS_ERRORS_DOCS_BASE, GracileErrorData } from './errors.js';
+import { builtInErrorPage } from './pages.js';
+const logger = getLogger();
+export async function emitViteBetterError({ error, vite, }) {
+    const errorWithMetadata = collectErrorMetadata(error, pathToFileURL(vite.config.root));
+    logger.error(formatErrorMessage(errorWithMetadata, false, GracileErrorData, GRACILE_JS_ERRORS_DOCS_BASE), {
+        timestamp: true,
+    });
+    const payload = await getViteErrorPayload({
+        docsBaseUrl: GRACILE_JS_ERRORS_DOCS_BASE,
+        errorsData: GracileErrorData,
+        err: errorWithMetadata,
+    });
+    setTimeout(() => {
+        vite.hot.send(payload);
+        // NOTE: Arbitrary value. Lower seems to be too fast, higher is not guaranteed to work.
+    }, 200);
+    const errorPage = builtInErrorPage(error.name ?? 'Error', true);
+    const renderedErrorPage = await renderLitTemplate(errorPage);
+    return renderedErrorPage;
+}

package/dist/errors/errors-data.d.ts

@@ -0,0 +1,81 @@
+export interface ErrorData {
+    name: string;
+    title: string;
+    message?: string | ((...params: any) => string) | undefined;
+    hint?: string | ((...params: any) => string) | undefined;
+}
+/**
+ * @docs
+ * @kind heading
+ * @name Gracile Errors
+ */
+/**
+ *
+ */
+export declare const FailedToLoadModuleSSR: {
+    readonly name: "FailedToLoadModuleSSR";
+    readonly title: "Could not import file.";
+    readonly message: (importName: string) => string;
+    readonly hint: "This is often caused by a typo in the import path. Please make sure the file exists.";
+};
+/**
+ *
+ */
+/**
+ *
+ */
+export declare const InvalidRequestInAdapter: {
+    readonly name: "InvalidRequestInAdapter";
+    readonly title: "Invalid request in adapter.";
+    readonly message: (adapterName: string) => string;
+    readonly hint: "Check that you have configured the adapter correctly.";
+};
+/**
+ *
+ */
+export declare const InvalidResponseInAdapter: {
+    readonly name: "InvalidResponseInAdapter";
+    readonly title: "Invalid response in adapter.";
+    readonly message: (adapterName: string) => string;
+    readonly hint: undefined;
+};
+/**
+ *
+ */
+export declare const InvalidRouteDocument: {
+    readonly name: "RoutePageRender";
+    readonly title: "Invalid route document configuration.";
+    readonly message: (routePath: string) => string;
+    readonly hint: undefined;
+};
+/**
+ *
+ */
+export declare const InvalidRouteDocumentResult: {
+    readonly name: "RoutePageRender";
+    readonly title: "Incorrect document template result.";
+    readonly message: (routePath: string) => string;
+    readonly hint: undefined;
+};
+/**
+ *
+ */
+export declare const InvalidRouteExport: {
+    readonly name: "InvalidRouteExport";
+    readonly title: "Invalid route export.";
+    readonly message: (routePath: string) => string;
+    readonly hint: "Should export a default `defineRoute` function.";
+};
+/**
+ *
+ */
+export declare const CouldNotRenderRouteDocument: {
+    readonly name: "CouldNotRenderRouteDocument";
+    readonly title: "Could not render the route document.";
+    readonly message: (routePath: string) => string;
+    readonly hint: undefined;
+};
+/**
+ *
+ */
+//# sourceMappingURL=errors-data.d.ts.map

package/dist/errors/errors-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-data.d.ts","sourceRoot":"","sources":["../../src/errors/errors-data.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;IAC5D,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;CACzD;AAED;;;;GAIG;AAGH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;mCAGX,MAAM;;CAEC,CAAC;AAC/B;;GAEG;AAgBH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;oCAGZ,MAAM;;CAGA,CAAC;AAC/B;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;oCAGb,MAAM;;CAGA,CAAC;AAC/B;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;kCAGX,MAAM;;CAGE,CAAC;AAC/B;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;kCAGjB,MAAM;;CAGE,CAAC;AAC/B;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;kCAGT,MAAM;;CAEE,CAAC;AAC/B;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;kCAGlB,MAAM;;CAGE,CAAC;AAC/B;;GAEG"}

package/dist/errors/errors-data.js

@@ -0,0 +1,98 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * @docs
+ * @kind heading
+ * @name Gracile Errors
+ */
+// Gracile Errors, most errors will go here!
+/**
+ *
+ */
+export const FailedToLoadModuleSSR = {
+    name: 'FailedToLoadModuleSSR',
+    title: 'Could not import file.',
+    message: (importName) => `Could not import \`${importName}\`.`,
+    hint: 'This is often caused by a typo in the import path. Please make sure the file exists.',
+};
+/**
+ *
+ */
+// export const FailedToGlobalLogger = {
+// 	name: 'FailedToGlobalLogger',
+// 	title: 'Could not get the global logger.',
+// 	message: undefined,
+// 	hint: 'This a Gracile internal fault.',
+// };
+// /**
+//  *
+//  */
+// export const FailedToGetGracileVersion = {
+// 	name: 'FailedToGetGracileVersion',
+// 	title: 'Version must be set before.',
+// 	message: undefined,
+// 	hint: 'This a Gracile internal fault.',
+// } as const satisfies ErrorData;
+/**
+ *
+ */
+export const InvalidRequestInAdapter = {
+    name: 'InvalidRequestInAdapter',
+    title: 'Invalid request in adapter.',
+    message: (adapterName) => `Invalid request for adapter name: \`${adapterName}\`.`,
+    hint: 'Check that you have configured the adapter correctly.',
+};
+/**
+ *
+ */
+export const InvalidResponseInAdapter = {
+    name: 'InvalidResponseInAdapter',
+    title: 'Invalid response in adapter.',
+    message: (adapterName) => `Invalid response for adapter name: \`${adapterName}\`.`,
+    hint: undefined,
+};
+/**
+ *
+ */
+export const InvalidRouteDocument = {
+    name: 'RoutePageRender',
+    title: 'Invalid route document configuration.',
+    message: (routePath) => `Route document must be a function for: \`${routePath}\`.`,
+    hint: undefined,
+};
+/**
+ *
+ */
+export const InvalidRouteDocumentResult = {
+    name: 'RoutePageRender',
+    title: 'Incorrect document template result.',
+    message: (routePath) => `Incorrect document template result for: \`${routePath}\`.`,
+    hint: undefined,
+};
+/**
+ *
+ */
+export const InvalidRouteExport = {
+    name: 'InvalidRouteExport',
+    title: 'Invalid route export.',
+    message: (routePath) => `Incorrect route module: \`${routePath}\`.`,
+    hint: `Should export a default \`defineRoute\` function.`,
+};
+/**
+ *
+ */
+export const CouldNotRenderRouteDocument = {
+    name: 'CouldNotRenderRouteDocument',
+    title: 'Could not render the route document.',
+    message: (routePath) => `Could not render the route document for: \`${routePath}\`.`,
+    hint: undefined,
+};
+/**
+ *
+ */
+// export const NoRoutesFound = {
+// 	name: 'NoRoutesFound',
+// 	title: 'Could not find any routes.',
+// 	message: `Could not find any routes for your project.`,
+// 	hint: 'You have to populate the `src/routes` folder.',
+// };
+// `Wrong template result for fragment template ${routeInfos.foundRoute.filePath}.`,

package/dist/errors/errors.d.ts

@@ -0,0 +1,22 @@
+import { BetterError, type BuiltinErrorTypes } from '@gracile-labs/better-errors/errors';
+export * as GracileErrorData from './errors-data.js';
+export declare const GRACILE_JS_ERRORS_DOCS_BASE = "https://gracile.js.org/docs/references/errors";
+type ErrorTypes = BuiltinErrorTypes | 'GracileError' | 'TemplateError' | 'InternalError' | 'TypeGuardError' | 'AggregateError';
+export declare class GracileError extends BetterError<ErrorTypes> {
+    type: ErrorTypes;
+    static is(err: unknown): err is GracileError;
+}
+export declare class TemplateError extends GracileError {
+    type: ErrorTypes;
+    static is(err: unknown): err is TemplateError;
+}
+export declare class InternalError extends GracileError {
+    type: ErrorTypes;
+    static is(err: unknown): err is InternalError;
+}
+/**
+ * An error util. that should never be called in theory.
+ */
+export declare class TypeGuardError extends Error {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,WAAW,EACX,KAAK,iBAAiB,EACtB,MAAM,oCAAoC,CAAC;AAI5C,OAAO,KAAK,gBAAgB,MAAM,kBAAkB,CAAC;AAErD,eAAO,MAAM,2BAA2B,kDACQ,CAAC;AAEjD,KAAK,UAAU,GACZ,iBAAiB,GACjB,cAAc,GACd,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,gBAAgB,CAAC;AAQpB,qBAAa,YAAa,SAAQ,WAAW,CAAC,UAAU,CAAC;IACxD,IAAI,EAAE,UAAU,CAAkB;IAElC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,YAAY;CAG5C;AAED,qBAAa,aAAc,SAAQ,YAAY;IAC9C,IAAI,EAAE,UAAU,CAAmB;IAEnC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa;CAG7C;AAED,qBAAa,aAAc,SAAQ,YAAY;IAC9C,IAAI,EAAE,UAAU,CAAmB;IAEnC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa;CAG7C;AAuGD;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;CAAG"}

package/dist/errors/errors.js

@@ -0,0 +1,122 @@
+/* eslint-disable max-classes-per-file */
+/* eslint-disable @typescript-eslint/lines-between-class-members */
+// NOTE: Taken and adapted from https://github.com/withGracile/Gracile/blob/cf65476b27053333cf5a36f6f9f46b794c98dfa2/packages/Gracile/src/core/errors/errors.ts
+import { BetterError, } from '@gracile-labs/better-errors/errors';
+// import { codeFrame } from '@gracile-labs/better-errors/printer';
+export * as GracileErrorData from './errors-data.js';
+export const GRACILE_JS_ERRORS_DOCS_BASE = 'https://gracile.js.org/docs/references/errors';
+// | 'BetterError'
+// | 'GracileUserError'
+// | 'CompilerError'
+// | 'CSSError'
+// | 'MarkdownError'
+export class GracileError extends BetterError {
+    type = 'GracileError';
+    static is(err) {
+        return err.type === 'GracileError';
+    }
+}
+export class TemplateError extends GracileError {
+    type = 'TemplateError';
+    static is(err) {
+        return err.type === 'TemplateError';
+    }
+}
+export class InternalError extends GracileError {
+    type = 'InternalError';
+    static is(err) {
+        return err.type === 'InternalError';
+    }
+}
+//
+// /* eslint-disable @typescript-eslint/lines-between-class-members */
+// /* eslint-disable max-classes-per-file */
+// import type { buildErrorMessage } from 'vite';
+// export type RollupError = Parameters<typeof buildErrorMessage>['0'];
+// export abstract class BetterError extends Error implements RollupError {
+// 	// --- RollupError
+// 	watchFiles?: string[];
+// 	binding?: string;
+// 	cause?: unknown;
+// 	code?: string;
+// 	exporter?: string;
+// 	frame?: string;
+// 	hook?: string;
+// 	id?: string;
+// 	ids?: string[];
+// 	loc?: { column: number; file?: string; line: number };
+// 	meta?: unknown;
+// 	names?: string[];
+// 	plugin?: string;
+// 	pluginCode?: unknown;
+// 	pos?: number;
+// 	reexporter?: string;
+// 	stack?: string;
+// 	url?: string;
+// 	// --- End RollupError
+// 	constructor(message: string, options?: { cause?: unknown }) {
+// 		super(message);
+// 		this.name = 'BetterError';
+// 		this.cause = options?.cause;
+// 	}
+// }
+// export class GracileUnknownError extends BetterError {
+// 	constructor(message: string, options?: { cause?: unknown }) {
+// 		super(message, options);
+// 		this.name = 'GracileUnknownError';
+// 	}
+// }
+// export class SsrError extends BetterError {
+// 	constructor(message: string, options?: { cause?: unknown }) {
+// 		super(message, options);
+// 		this.name = 'SsrError';
+// 	}
+// }
+// export function isViteError(error: unknown): error is RollupError {
+// 	if (
+// 		typeof error === 'object' &&
+// 		error &&
+// 		'message' in error &&
+// 		'plugin' in error &&
+// 		typeof error.plugin === 'string' &&
+// 		error.plugin.startsWith(`vite:`)
+// 	)
+// 		return true;
+// 	return false;
+// }
+// // export type EsbuildError = {
+// // 	plugin: 'vite:esbuild';
+// // } & RollupError;
+// // export class GracileRouterError extends Error implements e {
+// // 	constructor(message: string, options: { cause: unknown }) {
+// // 		super(message);
+// // 		this.name = 'GracileRouterError';
+// // 		this.cause = options.cause;
+// // 	}
+// // }
+// /**
+//  * Special error that is exposed to users.
+//  * Compared to BetterError, it contains a subset of information.
+//  */
+// export class GracileUserError extends Error {
+// 	type: ErrorTypes = 'GracileUserError';
+// 	/**
+// 	 * A message that explains to the user how they can fix the error.
+// 	 */
+// 	hint: string | undefined;
+// 	name = 'GracileUserError';
+// 	constructor(message: string, hint?: string) {
+// 		super();
+// 		this.message = message;
+// 		this.hint = hint;
+// 	}
+// 	static is(err: unknown): err is GracileUserError {
+// 		return (err as GracileUserError).type === 'GracileUserError';
+// 	}
+// }
+// ---
+/**
+ * An error util. that should never be called in theory.
+ */
+export class TypeGuardError extends Error {
+}

package/dist/errors/pages.d.ts

@@ -0,0 +1,4 @@
+export declare function errorInline(error: Error): import("@lit-labs/ssr").ServerRenderedTemplate;
+export declare function builtIn404Page(path: string, dev?: boolean): import("@lit-labs/ssr").ServerRenderedTemplate;
+export declare function builtInErrorPage(name?: string, dev?: boolean): import("@lit-labs/ssr").ServerRenderedTemplate;
+//# sourceMappingURL=pages.d.ts.map

package/dist/errors/pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/errors/pages.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,kDASvC;AAgBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAQ,kDAwFvD;AAOD,wBAAgB,gBAAgB,CAAC,IAAI,SAAU,EAAE,GAAG,UAAQ,kDAoB3D"}

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;AAOtD,YAAY,EAAE,aAAa,EAAE,CAAC;AAI9B;;;;;;;;;;;;;;;;;GAiBG;AAIH,eAAO,MAAM,OAAO,YAAa,aAAa,KAAG,GAAG,EA4RnD,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"}