@emkodev/emroute 1.7.2 → 1.8.0-beta.1

package/dist/{src/renderer/ssr → core/renderer}/ssr.renderer.js

@@ -4,18 +4,20 @@
  * Abstract base class for server-side renderers.
  * Provides the shared render() pipeline; subclasses supply format-specific rendering.
  */
-import { logger } from "../../type/logger.type.js";
-import defaultPageComponent from "../../component/page.component.js";
-import { assertSafeRedirect, DEFAULT_ROOT_ROUTE, RouteCore, } from "../../route/route.core.js";
+import defaultPageComponent from "../component/page.component.js";
+import { DEFAULT_ROOT_ROUTE } from "../pipeline/pipeline.js";
+import { assertSafeRedirect } from "../util/html.util.js";
 /**
  * Abstract SSR renderer with shared routing pipeline.
  */
 export class SsrRenderer {
-    core;
+    pipeline;
     widgets;
     widgetFiles;
-    constructor(resolver, options = {}) {
-        this.core = new RouteCore(resolver, options);
+    logger;
+    constructor(pipeline, options = {}) {
+        this.pipeline = pipeline;
+        this.logger = pipeline.logger;
         this.widgets = options.widgets ?? null;
         this.widgetFiles = options.widgetFiles ?? {};
     }
@@ -23,24 +25,24 @@ export class SsrRenderer {
      * Render a URL to a content string.
      */
     async render(url, signal) {
-        const matched = this.core.match(url);
+        const matched = await this.pipeline.match(url);
         if (!matched) {
-            const statusPage = this.core.getStatusPage(404);
+            const statusPage = await this.pipeline.getStatusPage(404);
             if (statusPage) {
                 try {
                     const ri = { url, params: {} };
                     const result = await this.renderRouteContent(ri, statusPage, undefined, signal);
-                    return { content: this.stripSlots(result.content), status: 404, title: result.title };
+                    return { content: this.stripSlots(result.content), status: 404, ...(result.title !== undefined ? { title: result.title } : {}) };
                 }
                 catch (e) {
-                    logger.error(`[${this.label}] Failed to render 404 status page for ${url.pathname}`, e instanceof Error ? e : undefined);
+                    this.logger.error(`[${this.label}] Failed to render 404 status page for ${url.pathname}`, e instanceof Error ? e : undefined);
                 }
             }
             return { content: this.renderStatusPage(404, url), status: 404 };
         }
         // Handle redirect
         if (matched.route.type === 'redirect') {
-            const module = await this.core.loadModule(matched.route.modulePath);
+            const module = await this.pipeline.loadModule(matched.route.modulePath);
             const redirectConfig = module.default;
             assertSafeRedirect(redirectConfig.to);
             return {
@@ -49,14 +51,14 @@ export class SsrRenderer {
                 redirect: redirectConfig.to,
             };
         }
-        const routeInfo = this.core.toRouteInfo(matched, url);
+        const routeInfo = this.pipeline.toRouteInfo(matched, url);
         try {
             const { content, title } = await this.renderPage(routeInfo, matched, signal);
-            return { content, status: 200, title };
+            return { content, status: 200, ...(title !== undefined ? { title } : {}) };
         }
         catch (error) {
             if (error instanceof Response) {
-                const statusPage = this.core.getStatusPage(error.status);
+                const statusPage = await this.pipeline.getStatusPage(error.status);
                 if (statusPage) {
                     try {
                         const ri = { url, params: {} };
@@ -64,23 +66,23 @@ export class SsrRenderer {
                         return {
                             content: this.stripSlots(result.content),
                             status: error.status,
-                            title: result.title,
+                            ...(result.title !== undefined ? { title: result.title } : {}),
                         };
                     }
                     catch (e) {
-                        logger.error(`[${this.label}] Failed to render ${error.status} status page for ${url.pathname}`, e instanceof Error ? e : undefined);
+                        this.logger.error(`[${this.label}] Failed to render ${error.status} status page for ${url.pathname}`, e instanceof Error ? e : undefined);
                     }
                 }
                 return { content: this.renderStatusPage(error.status, url), status: error.status };
             }
-            logger.error(`[${this.label}] Error rendering ${url.pathname}:`, error instanceof Error ? error : undefined);
-            const boundary = this.core.findErrorBoundary(url.pathname);
+            this.logger.error(`[${this.label}] Error rendering ${url.pathname}:`, error instanceof Error ? error : undefined);
+            const boundary = await this.pipeline.findErrorBoundary(url.pathname);
             if (boundary) {
                 const result = await this.tryRenderErrorModule(boundary.modulePath, url, 'boundary');
                 if (result)
                     return result;
             }
-            const errorHandler = this.core.getErrorHandler();
+            const errorHandler = await this.pipeline.getErrorHandler();
             if (errorHandler) {
                 const result = await this.tryRenderErrorModule(errorHandler.modulePath, url, 'handler');
                 if (result)
@@ -93,12 +95,11 @@ export class SsrRenderer {
      * Render a matched page by composing the route hierarchy.
      */
     async renderPage(routeInfo, matched, signal) {
-        const hierarchy = this.core.buildRouteHierarchy(matched.route.pattern);
-        // Resolve routes for each hierarchy segment (skip missing / duplicate wildcard)
+        const hierarchy = this.pipeline.buildRouteHierarchy(matched.route.pattern);
         const segments = [];
         for (let i = 0; i < hierarchy.length; i++) {
             const routePattern = hierarchy[i];
-            let route = this.core.findRoute(routePattern);
+            let route = await this.pipeline.findRoute(routePattern);
             if (!route && routePattern === '/') {
                 route = DEFAULT_ROOT_ROUTE;
             }
@@ -108,9 +109,7 @@ export class SsrRenderer {
                 continue;
             segments.push({ route, isLeaf: i === hierarchy.length - 1 });
         }
-        // Fire all renderRouteContent calls in parallel
         const results = await Promise.all(segments.map(({ route, isLeaf }) => this.renderRouteContent(routeInfo, route, isLeaf, signal)));
-        // Sequential slot injection
         let result = '';
         let pageTitle;
         let lastRenderedPattern = '';
@@ -125,7 +124,7 @@ export class SsrRenderer {
             else {
                 const injected = this.injectSlot(result, content, lastRenderedPattern);
                 if (injected === result) {
-                    logger.warn(`[${this.label}] Route "${lastRenderedPattern}" has no <router-slot> ` +
+                    this.logger.warn(`[${this.label}] Route "${lastRenderedPattern}" has no <router-slot> ` +
                         `for child route "${hierarchy[i]}" to render into. ` +
                         `Add <router-slot></router-slot> to the parent template.`);
                 }
@@ -134,30 +133,29 @@ export class SsrRenderer {
             lastRenderedPattern = segments[i].route.pattern;
         }
         result = this.stripSlots(result);
-        return { content: result, title: pageTitle };
+        return { content: result, ...(pageTitle !== undefined ? { title: pageTitle } : {}) };
     }
     /** Load component, build context, get data, render content, get title. */
     async loadRouteContent(routeInfo, route, isLeaf, signal) {
         const files = route.files ?? {};
         const tsModule = files.ts ?? files.js;
-        const component = tsModule
-            ? (await this.core.loadModule(tsModule)).default
-            : defaultPageComponent;
-        const context = await this.core.buildComponentContext(routeInfo, route, signal, isLeaf);
-        const data = await component.getData({ params: routeInfo.params, signal, context });
+        const loadedModule = tsModule
+            ? await this.pipeline.loadModule(tsModule)
+            : undefined;
+        const component = loadedModule?.default ?? defaultPageComponent;
+        const context = await this.pipeline.buildContext(routeInfo, route, signal, isLeaf, loadedModule);
+        const data = await component.getData({ params: routeInfo.params, ...(signal ? { signal } : {}), context });
         const content = this.renderContent(component, { data, params: routeInfo.params, context });
         const title = component.getTitle({ data, params: routeInfo.params, context });
-        return { content, title };
+        return { content, ...(title !== undefined ? { title } : {}) };
     }
-    /** Render a component for error boundary/handler with minimal context. */
     renderComponent(component, data, context) {
         return this.renderContent(component, { data, params: {}, context });
     }
     static EMPTY_URL = new URL('http://error');
-    /** Try to load and render an error boundary or handler module. Returns null on failure. */
     async tryRenderErrorModule(modulePath, url, kind) {
         try {
-            const module = await this.core.loadModule(modulePath);
+            const module = await this.pipeline.loadModule(modulePath);
             const component = module.default;
             const minCtx = {
                 url: SsrRenderer.EMPTY_URL,
@@ -170,7 +168,7 @@ export class SsrRenderer {
             return { content, status: 500 };
         }
         catch (e) {
-            logger.error(`[${this.label}] Error ${kind} failed for ${url.pathname}`, e instanceof Error ? e : undefined);
+            this.logger.error(`[${this.label}] Error ${kind} failed for ${url.pathname}`, e instanceof Error ? e : undefined);
             return null;
         }
     }

package/dist/core/renderer/ssr.renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.renderer.js","sourceRoot":"","sources":["../../../core/renderer/ssr.renderer.ts"],"names":[],"mappings":"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"}

package/dist/{src/route → core/router}/route.resolver.d.ts

@@ -5,24 +5,17 @@
  * provides O(depth) matching, error boundary lookup, and hierarchy traversal.
  *
  * Implementations: RouteTrie (in-memory trie from RouteNode tree).
- * RouteCore depends on this interface, not on the algorithm.
  */
 import type { RouteNode } from '../type/route-tree.type.ts';
 /** Result of matching a URL pathname against the route tree. */
 export interface ResolvedRoute {
-    /** The matched route node. */
     readonly node: RouteNode;
-    /** URL pattern reconstructed from the tree path (e.g. "/projects/:id"). */
     readonly pattern: string;
-    /** Extracted URL parameters (e.g. { id: "42" }). */
     readonly params: Record<string, string>;
 }
-/** Route lookup interface. Decouples matching algorithm from the router. */
+/** Route lookup interface. Decouples matching algorithm from the server. */
 export interface RouteResolver {
-    /** Match a URL pathname to a route. */
     match(pathname: string): ResolvedRoute | undefined;
-    /** Find the most specific error boundary for a pathname. */
     findErrorBoundary(pathname: string): string | undefined;
-    /** Look up a route node by its exact pattern (e.g. "/projects/:id"). */
     findRoute(pattern: string): RouteNode | undefined;
 }

package/dist/{src/route → core/router}/route.resolver.js

@@ -5,7 +5,6 @@
  * provides O(depth) matching, error boundary lookup, and hierarchy traversal.
  *
  * Implementations: RouteTrie (in-memory trie from RouteNode tree).
- * RouteCore depends on this interface, not on the algorithm.
  */
 export {};
 //# sourceMappingURL=route.resolver.js.map

package/dist/core/router/route.resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.resolver.js","sourceRoot":"","sources":["../../../core/router/route.resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/core/router/route.trie.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Route Trie
+ *
+ * Default RouteResolver implementation. O(depth) route matching over
+ * the RouteNode tree.
+ *
+ * Walks the RouteNode tree directly — no conversion step, no internal state
+ * beyond the tree reference. Each URL segment is matched in order:
+ * static → dynamic (:param) → wildcard (:rest*). Backtracking handles
+ * cases where a dynamic path leads to a dead end but a wildcard at an
+ * ancestor would match.
+ *
+ * Static segment matching is case-sensitive, per RFC 3986.
+ */
+import type { RouteNode } from '../type/route-tree.type.ts';
+import type { ResolvedRoute, RouteResolver } from './route.resolver.ts';
+/**
+ * Default RouteResolver implementation.
+ * Walks the RouteNode tree directly — no conversion, no Maps.
+ */
+export declare class RouteTrie implements RouteResolver {
+    private readonly tree;
+    constructor(tree: RouteNode);
+    match(pathname: string): ResolvedRoute | undefined;
+    findErrorBoundary(pathname: string): string | undefined;
+    findRoute(pattern: string): RouteNode | undefined;
+    private safeDecode;
+    private splitSegments;
+    private normalizePath;
+    private walk;
+    private walkForBoundary;
+}

package/dist/core/router/route.trie.js

@@ -0,0 +1,152 @@
+/**
+ * Route Trie
+ *
+ * Default RouteResolver implementation. O(depth) route matching over
+ * the RouteNode tree.
+ *
+ * Walks the RouteNode tree directly — no conversion step, no internal state
+ * beyond the tree reference. Each URL segment is matched in order:
+ * static → dynamic (:param) → wildcard (:rest*). Backtracking handles
+ * cases where a dynamic path leads to a dead end but a wildcard at an
+ * ancestor would match.
+ *
+ * Static segment matching is case-sensitive, per RFC 3986.
+ */
+/**
+ * Default RouteResolver implementation.
+ * Walks the RouteNode tree directly — no conversion, no Maps.
+ */
+export class RouteTrie {
+    tree;
+    constructor(tree) {
+        this.tree = tree;
+    }
+    match(pathname) {
+        pathname = this.normalizePath(pathname);
+        if (pathname === '/') {
+            if (this.tree.files || this.tree.redirect) {
+                return { node: this.tree, pattern: '/', params: {} };
+            }
+            return undefined;
+        }
+        return this.walk(this.tree, this.splitSegments(pathname), 0, {}, '/');
+    }
+    findErrorBoundary(pathname) {
+        pathname = this.normalizePath(pathname);
+        if (pathname === '/')
+            return this.tree.errorBoundary;
+        return this.walkForBoundary(this.tree, this.splitSegments(pathname), 0, this.tree.errorBoundary);
+    }
+    findRoute(pattern) {
+        if (pattern === '/') {
+            return (this.tree.files || this.tree.redirect) ? this.tree : undefined;
+        }
+        const segments = this.splitSegments(pattern);
+        let node = this.tree;
+        for (const segment of segments) {
+            let child;
+            if (segment.startsWith(':') && segment.endsWith('*')) {
+                child = node.wildcard?.child;
+            }
+            else if (segment.startsWith(':')) {
+                child = node.dynamic?.child;
+            }
+            else {
+                child = node.children?.[segment];
+            }
+            if (!child)
+                return undefined;
+            node = child;
+        }
+        return (node.files || node.redirect) ? node : undefined;
+    }
+    // ── Private helpers ─────────────────────────────────────────────────
+    safeDecode(segment) {
+        try {
+            return decodeURIComponent(segment);
+        }
+        catch {
+            return segment;
+        }
+    }
+    splitSegments(pathname) {
+        return pathname.substring(1).split('/');
+    }
+    normalizePath(pathname) {
+        if (pathname.length > 1 && pathname.endsWith('/')) {
+            pathname = pathname.slice(0, -1);
+        }
+        if (!pathname.startsWith('/')) {
+            pathname = '/' + pathname;
+        }
+        return pathname;
+    }
+    walk(node, segments, index, params, pattern) {
+        if (index === segments.length) {
+            if (node.files || node.redirect) {
+                return { node, pattern, params: { ...params } };
+            }
+            if (node.wildcard && (node.wildcard.child.files || node.wildcard.child.redirect)) {
+                const wp = pattern === '/' ? `/:${node.wildcard.param}*` : `${pattern}/:${node.wildcard.param}*`;
+                return {
+                    node: node.wildcard.child,
+                    pattern: wp,
+                    params: { ...params, [node.wildcard.param]: '' },
+                };
+            }
+            return undefined;
+        }
+        const segment = segments[index];
+        // Static
+        const staticChild = node.children?.[segment];
+        if (staticChild) {
+            const childPattern = pattern === '/' ? `/${segment}` : `${pattern}/${segment}`;
+            const result = this.walk(staticChild, segments, index + 1, params, childPattern);
+            if (result)
+                return result;
+        }
+        // Dynamic
+        if (node.dynamic) {
+            const { param, child } = node.dynamic;
+            params[param] = this.safeDecode(segment);
+            const childPattern = pattern === '/' ? `/:${param}` : `${pattern}/:${param}`;
+            const result = this.walk(child, segments, index + 1, params, childPattern);
+            if (result)
+                return result;
+            delete params[param];
+        }
+        // Wildcard
+        if (node.wildcard && (node.wildcard.child.files || node.wildcard.child.redirect)) {
+            const { param, child } = node.wildcard;
+            let rest = this.safeDecode(segments[index]);
+            for (let i = index + 1; i < segments.length; i++) {
+                rest += '/' + this.safeDecode(segments[i]);
+            }
+            const wp = pattern === '/' ? `/:${param}*` : `${pattern}/:${param}*`;
+            return {
+                node: child,
+                pattern: wp,
+                params: { ...params, [param]: rest },
+            };
+        }
+        return undefined;
+    }
+    walkForBoundary(node, segments, index, deepest) {
+        if (index === segments.length) {
+            return node.errorBoundary ?? deepest;
+        }
+        const segment = segments[index];
+        const staticChild = node.children?.[segment];
+        if (staticChild) {
+            return this.walkForBoundary(staticChild, segments, index + 1, staticChild.errorBoundary ?? deepest);
+        }
+        if (node.dynamic) {
+            return this.walkForBoundary(node.dynamic.child, segments, index + 1, node.dynamic.child.errorBoundary ?? deepest);
+        }
+        if (node.wildcard) {
+            return node.wildcard.child.errorBoundary ?? deepest;
+        }
+        return deepest;
+    }
+}
+//# sourceMappingURL=route.trie.js.map

package/dist/core/router/route.trie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.trie.js","sourceRoot":"","sources":["../../../core/router/route.trie.ts"],"names":[],"mappings":"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"}

package/dist/core/runtime/abstract.runtime.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Abstract Runtime
+ *
+ * Storage contract. Speaks Request/Response.
+ * Concrete implementations decide how to store, cache, scan, and serve.
+ *
+ * Three access patterns:
+ * - handle() — raw passthrough
+ * - query()  — read (Response or string)
+ * - command() — write/delete
+ */
+export type FetchParams = Parameters<typeof fetch>;
+export type FetchReturn = ReturnType<typeof fetch>;
+/** Well-known manifest paths (convention between Runtime and consumers). */
+export declare const ROUTES_MANIFEST_PATH = "/routes.manifest.json";
+export declare const WIDGETS_MANIFEST_PATH = "/widgets.manifest.json";
+export declare const ELEMENTS_MANIFEST_PATH = "/elements.manifest.json";
+export declare abstract class Runtime {
+    /** Raw passthrough — same signature as fetch(). */
+    abstract handle(resource: FetchParams[0], init?: FetchParams[1]): FetchReturn;
+    /** Read. Returns Response, or string with { as: 'text' }. */
+    abstract query(resource: FetchParams[0], options: FetchParams[1] & {
+        as: 'text';
+    }): Promise<string>;
+    abstract query(resource: FetchParams[0], options?: FetchParams[1]): FetchReturn;
+    /** Write (PUT) or delete (DELETE). */
+    abstract command(resource: FetchParams[0], options?: FetchParams[1]): FetchReturn;
+    /** Dynamically import a module from storage. */
+    loadModule(_path: string): Promise<unknown>;
+    /** Transpile TypeScript to JavaScript. */
+    transpile(_source: string): Promise<string>;
+}

package/dist/core/runtime/abstract.runtime.js

@@ -0,0 +1,26 @@
+/**
+ * Abstract Runtime
+ *
+ * Storage contract. Speaks Request/Response.
+ * Concrete implementations decide how to store, cache, scan, and serve.
+ *
+ * Three access patterns:
+ * - handle() — raw passthrough
+ * - query()  — read (Response or string)
+ * - command() — write/delete
+ */
+/** Well-known manifest paths (convention between Runtime and consumers). */
+export const ROUTES_MANIFEST_PATH = '/routes.manifest.json';
+export const WIDGETS_MANIFEST_PATH = '/widgets.manifest.json';
+export const ELEMENTS_MANIFEST_PATH = '/elements.manifest.json';
+export class Runtime {
+    /** Dynamically import a module from storage. */
+    loadModule(_path) {
+        throw new Error(`loadModule not implemented for ${this.constructor.name}`);
+    }
+    /** Transpile TypeScript to JavaScript. */
+    transpile(_source) {
+        throw new Error(`transpile not implemented for ${this.constructor.name}`);
+    }
+}
+//# sourceMappingURL=abstract.runtime.js.map

package/dist/core/runtime/abstract.runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.runtime.js","sourceRoot":"","sources":["../../../core/runtime/abstract.runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAC5D,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAG,yBAAyB,CAAC;AAEhE,MAAM,OAAgB,OAAO;IAiB3B,gDAAgD;IAChD,UAAU,CAAC,KAAa;QACtB,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,0CAA0C;IAC1C,SAAS,CAAC,OAAe;QACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/core/server/emroute.server.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Emroute
+ *
+ * Framework entry point. Reads manifests from Runtime,
+ * builds Pipeline + Renderers, handles Request → Response.
+ */
+import type { Runtime } from '../runtime/abstract.runtime.ts';
+import { SsrHtmlRenderer } from '../renderer/html.renderer.ts';
+import { SsrMdRenderer } from '../renderer/md.renderer.ts';
+import { WidgetRegistry } from '../widget/widget.registry.ts';
+import type { RouteNode } from '../type/route-tree.type.ts';
+import type { MarkdownRenderer } from '../type/markdown.type.ts';
+import type { SpaMode } from '../type/widget.type.ts';
+import type { ContextProvider } from '../type/component.type.ts';
+export declare const DEFAULT_BASE_PATH: {
+    html: string;
+    md: string;
+    app: string;
+};
+export type BasePath = Record<keyof typeof DEFAULT_BASE_PATH, string>;
+export declare class Emroute {
+    private readonly runtime;
+    private readonly htmlBase;
+    private readonly mdBase;
+    private readonly appBase;
+    private readonly spa;
+    private readonly title;
+    readonly htmlRenderer: SsrHtmlRenderer | null;
+    readonly mdRenderer: SsrMdRenderer | null;
+    readonly shell: string;
+    private constructor();
+    static create(config: {
+        routeTree?: RouteNode;
+        widgets?: WidgetRegistry;
+        spa?: SpaMode;
+        basePath?: BasePath;
+        title?: string;
+        markdownRenderer?: MarkdownRenderer;
+        extendContext?: ContextProvider;
+        moduleLoaders?: Record<string, () => Promise<unknown>>;
+    }, runtime: Runtime): Promise<Emroute>;
+    handleRequest(req: Request): Promise<Response | null>;
+    private static extractWidgetExport;
+    private static importWidgets;
+    private static buildHtmlShell;
+    private static injectSsrContent;
+    private static resolveShell;
+}