@gracile/engine 0.6.0 → 0.7.0-next.1

package/dist/build/static.d.ts

@@ -1,19 +1,25 @@
 import type { ViteDevServer } from 'vite';
+import type { RoutesManifest } from '../routes/route.js';
 import type { GracileConfig } from '../user-config.js';
 export interface RenderedRouteDefinition {
     absoluteId: string;
     name: string;
     html: string | null;
     handlerAssets?: string;
+    static: {
+        props: unknown;
+        document: string | null;
+    };
     savePrerender: boolean | null;
 }
-export declare function renderRoutes({ vite, serverMode, root, gracileConfig, }: {
+export declare function renderRoutes({ routes, vite, serverMode, root, gracileConfig, }: {
+    routes: RoutesManifest;
     vite: ViteDevServer;
     serverMode: boolean;
     root?: string;
     gracileConfig: GracileConfig;
 }): Promise<{
-    routes: import("../routes/route.js").RoutesManifest;
+    routes: RoutesManifest;
     renderedRoutes: RenderedRouteDefinition[];
 }>;
 //# sourceMappingURL=static.d.ts.map

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,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,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAeD,wBAAsB,YAAY,CAAC,EAClC,IAAI,EACJ,UAAU,EACV,IAAoB,EACpB,aAAa,GACb,EAAE;IACF,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,aAAa,CAAC;CAC7B;;;GAyHA"}
+{"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';
@@ -17,10 +17,11 @@ async function streamToString(stream) {
     }
     return Buffer.concat(chunks).toString('utf-8');
 }
-export async function renderRoutes({ vite, serverMode, root = process.cwd(), gracileConfig, }) {
+export async function renderRoutes({ routes, vite, serverMode, root = process.cwd(), gracileConfig, }) {
+    const logger = getLogger();
     logger.info(c.green('Rendering routes…'), { timestamp: true });
     // MARK: Collect
-    const routes = await collectRoutes(root, gracileConfig.routes?.exclude);
+    await collectRoutes(routes, root, gracileConfig.routes?.exclude);
     const renderedRoutes = [];
     // MARK: Iterate modules
     await Promise.all([...routes].map(async ([patternString, route]) => {
@@ -31,15 +32,38 @@ export async function renderRoutes({ vite, serverMode, root = process.cwd(), gra
         // NOTE: Skip rendering base document for server
         if (serverMode && typeof routeModule.document !== 'function')
             return;
-        const routeStaticPaths = routeModule.staticPaths?.();
+        const routeStaticPaths = await Promise.resolve(routeModule.staticPaths?.());
         // MARK: Extract data
-        await Promise.all((routeStaticPaths ?? [patternString]).map(async (staticPathOptions) => {
+        await Promise.all(
+        /* Single route */
+        (routeStaticPaths ?? [patternString]).map(async (staticPathOptions) => {
             let pathnameWithParams = patternString;
             let params = {};
             let props;
+            // MARK: Handler data (for single route only, NOT dynamic)
+            if (routeModule.handler) {
+                const url = new URL(pathnameWithParams, 'http://gracile-static');
+                const context = {
+                    url,
+                    params: {},
+                    // NOTE: STUB, maybe it should be better to remove them from typings?
+                    // But that will make more mismatches between static and server.
+                    request: new Request(url),
+                    locals: {},
+                    responseInit: {},
+                };
+                if (typeof routeModule.handler === 'function') {
+                    props = await Promise.resolve(routeModule.handler(context));
+                }
+                else if ('GET' in routeModule.handler) {
+                    props = {
+                        GET: await Promise.resolve(routeModule.handler.GET(context)),
+                    };
+                }
+            }
             // MARK: Convert pattern
             // to real route with static parameters + get props. for after
-            if (typeof staticPathOptions === 'object') {
+            else if (typeof staticPathOptions === 'object') {
                 params = staticPathOptions.params;
                 props = staticPathOptions.props;
                 Object.entries(staticPathOptions.params).forEach(([paramName, value]) => {
@@ -60,11 +84,14 @@ export async function renderRoutes({ vite, serverMode, root = process.cwd(), gra
                 : '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 } = await renderRouteTemplate({
+            const { output, document } = await renderRouteTemplate({
                 //
-                request: { url: url.href },
+                // request: { url: url.href },
+                url: url.href,
                 vite,
                 mode: 'build',
                 routeInfos: {
@@ -79,6 +106,8 @@ export async function renderRoutes({ vite, serverMode, root = process.cwd(), gra
             });
             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;
@@ -90,6 +119,7 @@ export async function renderRoutes({ vite, serverMode, root = process.cwd(), gra
                 name,
                 html: htmlString,
                 savePrerender,
+                static: { props, document },
             };
             renderedRoutes.push(rendered);
         }));

package/dist/dev/dev.d.ts

@@ -1,10 +1,13 @@
 import { type ViteDevServer } from 'vite';
+import type { RoutesManifest } from '../routes/route.js';
 import { type GracileHandler } from '../server/request.js';
 import type { GracileConfig } from '../user-config.js';
-export declare function createDevHandler({ vite, gracileConfig, }: {
+export declare function createDevHandler({ routes, vite, gracileConfig, }: {
+    routes: RoutesManifest;
     vite: ViteDevServer;
     gracileConfig: GracileConfig;
 }): Promise<{
     handler: GracileHandler;
+    routes: RoutesManifest;
 }>;
 //# sourceMappingURL=dev.d.ts.map

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,EAEN,KAAK,cAAc,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,wBAAsB,gBAAgB,CAAC,EACtC,IAAI,EACJ,aAAa,GACb,EAAE;IACF,IAAI,EAAE,aAAa,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;CAC7B,GAAG,OAAO,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;CACxB,CAAC,CAoCD"}
+{"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,30 +1,43 @@
-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({ vite, gracileConfig, }) {
+export async function createDevHandler({ routes, vite, gracileConfig, }) {
+    const logger = getLogger();
     const root = vite.config.root;
-    logger.info(c.dim('\nCreating handler…'), { timestamp: true });
-    const routes = await collectRoutes(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)$/) &&
-            ['add', 'unlink'].includes(event))
-            collectRoutes(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?
     const serverMode = false;
-    const gracile = createGracileHandler({ vite, root, serverMode, routes });
-    return { handler: gracile };
+    const gracile = createGracileHandler({
+        vite,
+        root,
+        serverMode,
+        routes,
+        gracileConfig,
+    });
+    return { handler: gracile, routes };
 }

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"}