@emkodev/emroute 1.6.2 → 1.6.4

package/dist/src/route/route.core.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Route Core
+ *
+ * Shared routing logic used by all renderers:
+ * - Route matching and hierarchy building
+ * - Module loading and caching
+ * - Event emission
+ * - URL normalization
+ */
+import type { MatchedRoute, RouteConfig, RouteInfo, RouteParams, RouterEvent, RouterEventListener, RoutesManifest } from '../type/route.type.ts';
+import type { ComponentContext, ContextProvider } from '../component/abstract.component.ts';
+import { RouteMatcher } from './route.matcher.ts';
+/** Base paths for the two SSR rendering endpoints. */
+export interface BasePath {
+    /** Base path for SSR HTML rendering (default: '/html') */
+    html: string;
+    /** Base path for SSR Markdown rendering (default: '/md') */
+    md: string;
+}
+/** Default base paths — backward compatible with existing /html/ and /md/ prefixes. */
+export declare const DEFAULT_BASE_PATH: BasePath;
+/**
+ * Create a copy of a manifest with basePath prepended to all patterns.
+ * Used by the server to prefix bare in-memory manifests before passing to routers.
+ */
+export declare function prefixManifest(manifest: RoutesManifest, basePath: string): RoutesManifest;
+/** Throw if a redirect URL uses a dangerous protocol. */
+export declare function assertSafeRedirect(url: string): void;
+/** Default root route - renders a slot for child routes */
+export declare const DEFAULT_ROOT_ROUTE: RouteConfig;
+/** Options for RouteCore */
+export interface RouteCoreOptions {
+    /**
+     * Read a companion file (.html, .md, .css) by path — returns its text content.
+     * SSR: `(path) => runtime.query(path, { as: 'text' })`.
+     * SPA default: `fetch(path, { headers: { Accept: 'text/plain' } }).then(r => r.text())`.
+     */
+    fileReader?: (path: string) => Promise<string>;
+    /** Enriches every ComponentContext with app-level services before it reaches components. */
+    extendContext?: ContextProvider;
+    /** Base path prepended to route patterns for URL matching (e.g. '/html'). No trailing slash. */
+    basePath?: string;
+}
+/**
+ * Core router functionality shared across all rendering contexts.
+ */
+export declare class RouteCore {
+    readonly matcher: RouteMatcher;
+    /** Registered context provider (if any). Exposed so renderers can apply it to inline contexts. */
+    readonly contextProvider: ContextProvider | undefined;
+    /** Base path for URL matching (e.g. '/html'). Empty string when no basePath. */
+    readonly basePath: string;
+    /** The root pattern — basePath when set, '/' otherwise. */
+    get root(): string;
+    private listeners;
+    private moduleCache;
+    private widgetFileCache;
+    private moduleLoaders;
+    currentRoute: MatchedRoute | null;
+    private readFile;
+    constructor(manifest: RoutesManifest, options?: RouteCoreOptions);
+    /**
+     * Get current route parameters.
+     */
+    getParams(): RouteParams;
+    /**
+     * Add event listener for router events.
+     */
+    addEventListener(listener: RouterEventListener): () => void;
+    /**
+     * Emit router event to listeners.
+     */
+    emit(event: RouterEvent): void;
+    /**
+     * Match a URL to a route.
+     * Falls back to the default root route for the basePath root (or '/' when no basePath).
+     */
+    match(url: URL | string): MatchedRoute | undefined;
+    /**
+     * Build route hierarchy from a pattern.
+     *
+     * When basePath is set, the root is the basePath itself and only
+     * segments after it are split into ancestors.
+     *
+     * e.g., basePath='/html', pattern='/html/projects/:id/tasks'
+     *   → ['/html', '/html/projects', '/html/projects/:id', '/html/projects/:id/tasks']
+     *
+     * Without basePath: '/projects/:id/tasks'
+     *   → ['/', '/projects', '/projects/:id', '/projects/:id/tasks']
+     */
+    buildRouteHierarchy(pattern: string): string[];
+    /**
+     * Normalize URL by removing trailing slashes (except bare '/').
+     */
+    normalizeUrl(url: string): string;
+    /**
+     * Convert relative path to absolute path.
+     */
+    toAbsolutePath(path: string): string;
+    /**
+     * Load a module with caching.
+     * Uses pre-bundled loaders when available, falls back to dynamic import.
+     */
+    loadModule<T>(modulePath: string): Promise<T>;
+    /**
+     * Load widget file contents with caching.
+     * Returns an object with loaded file contents.
+     */
+    loadWidgetFiles(widgetFiles: {
+        html?: string;
+        md?: string;
+        css?: string;
+    }): Promise<{
+        html?: string;
+        md?: string;
+        css?: string;
+    }>;
+    /**
+     * Build a RouteInfo from a matched route and the resolved URL pathname.
+     * Called once per navigation; the result is reused across the route hierarchy.
+     */
+    toRouteInfo(matched: MatchedRoute, pathname: string): RouteInfo;
+    /**
+     * Build a ComponentContext by extending RouteInfo with loaded file contents.
+     * When a signal is provided it is forwarded to fetch() calls and included
+     * in the returned context so that getData() can observe cancellation.
+     */
+    buildComponentContext(routeInfo: RouteInfo, route: RouteConfig, signal?: AbortSignal, isLeaf?: boolean): Promise<ComponentContext>;
+}

package/dist/src/route/route.core.js

@@ -0,0 +1,255 @@
+/**
+ * Route Core
+ *
+ * Shared routing logic used by all renderers:
+ * - Route matching and hierarchy building
+ * - Module loading and caching
+ * - Event emission
+ * - URL normalization
+ */
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { RouteMatcher, toUrl } from "./route.matcher.js";
+/** Default base paths — backward compatible with existing /html/ and /md/ prefixes. */
+export const DEFAULT_BASE_PATH = { html: '/html', md: '/md' };
+/**
+ * Create a copy of a manifest with basePath prepended to all patterns.
+ * Used by the server to prefix bare in-memory manifests before passing to routers.
+ */
+export function prefixManifest(manifest, basePath) {
+    if (!basePath)
+        return manifest;
+    return {
+        routes: manifest.routes.map((r) => ({
+            ...r,
+            // Root pattern '/' becomes basePath itself (e.g. '/html'), not '/html/'
+            pattern: r.pattern === '/' ? basePath : basePath + r.pattern,
+            parent: r.parent ? (r.parent === '/' ? basePath : basePath + r.parent) : undefined,
+        })),
+        errorBoundaries: manifest.errorBoundaries.map((e) => ({
+            ...e,
+            pattern: e.pattern === '/' ? basePath : basePath + e.pattern,
+        })),
+        statusPages: new Map([...manifest.statusPages].map(([status, route]) => [
+            status,
+            { ...route, pattern: basePath + route.pattern },
+        ])),
+        errorHandler: manifest.errorHandler,
+        moduleLoaders: manifest.moduleLoaders,
+    };
+}
+const BLOCKED_PROTOCOLS = /^(javascript|data|vbscript):/i;
+/** Throw if a redirect URL uses a dangerous protocol. */
+export function assertSafeRedirect(url) {
+    if (BLOCKED_PROTOCOLS.test(url.trim())) {
+        throw new Error(`Unsafe redirect URL blocked: ${url}`);
+    }
+}
+/** Default root route - renders a slot for child routes */
+export const DEFAULT_ROOT_ROUTE = {
+    pattern: '/',
+    type: 'page',
+    modulePath: '__default_root__',
+};
+/**
+ * Core router functionality shared across all rendering contexts.
+ */
+export class RouteCore {
+    matcher;
+    /** Registered context provider (if any). Exposed so renderers can apply it to inline contexts. */
+    contextProvider;
+    /** Base path for URL matching (e.g. '/html'). Empty string when no basePath. */
+    basePath;
+    /** The root pattern — basePath when set, '/' otherwise. */
+    get root() {
+        return this.basePath || '/';
+    }
+    listeners = new Set();
+    moduleCache = new Map();
+    widgetFileCache = new Map();
+    moduleLoaders;
+    currentRoute = null;
+    readFile;
+    constructor(manifest, options = {}) {
+        this.basePath = options.basePath ?? '';
+        this.matcher = new RouteMatcher(manifest);
+        this.readFile = options.fileReader ??
+            ((path) => fetch(path, { headers: { Accept: 'text/plain' } }).then((r) => r.text()));
+        this.contextProvider = options.extendContext;
+        this.moduleLoaders = manifest.moduleLoaders ?? {};
+    }
+    /**
+     * Get current route parameters.
+     */
+    getParams() {
+        return this.currentRoute?.params ?? {};
+    }
+    /**
+     * Add event listener for router events.
+     */
+    addEventListener(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Emit router event to listeners.
+     */
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (e) {
+                console.error('[Router] Event listener error:', e);
+            }
+        }
+    }
+    /**
+     * Match a URL to a route.
+     * Falls back to the default root route for the basePath root (or '/' when no basePath).
+     */
+    match(url) {
+        const matched = this.matcher.match(url);
+        if (matched)
+            return matched;
+        const urlObj = toUrl(url);
+        if (urlObj.pathname === this.root || urlObj.pathname === this.root + '/') {
+            return {
+                route: { ...DEFAULT_ROOT_ROUTE, pattern: this.root },
+                params: {},
+                searchParams: urlObj.searchParams,
+            };
+        }
+        return undefined;
+    }
+    /**
+     * Build route hierarchy from a pattern.
+     *
+     * When basePath is set, the root is the basePath itself and only
+     * segments after it are split into ancestors.
+     *
+     * e.g., basePath='/html', pattern='/html/projects/:id/tasks'
+     *   → ['/html', '/html/projects', '/html/projects/:id', '/html/projects/:id/tasks']
+     *
+     * Without basePath: '/projects/:id/tasks'
+     *   → ['/', '/projects', '/projects/:id', '/projects/:id/tasks']
+     */
+    buildRouteHierarchy(pattern) {
+        if (pattern === this.root || pattern === this.root + '/') {
+            return [this.root];
+        }
+        // Extract the part after basePath
+        const tail = this.basePath ? pattern.slice(this.basePath.length) : pattern;
+        const segments = tail.split('/').filter(Boolean);
+        const hierarchy = [this.root];
+        let current = this.basePath || '';
+        for (const segment of segments) {
+            current += '/' + segment;
+            hierarchy.push(current);
+        }
+        return hierarchy;
+    }
+    /**
+     * Normalize URL by removing trailing slashes (except bare '/').
+     */
+    normalizeUrl(url) {
+        if (url.length > 1 && url.endsWith('/')) {
+            return url.slice(0, -1);
+        }
+        return url;
+    }
+    /**
+     * Convert relative path to absolute path.
+     */
+    toAbsolutePath(path) {
+        return path.startsWith('/') ? path : '/' + path;
+    }
+    /**
+     * Load a module with caching.
+     * Uses pre-bundled loaders when available, falls back to dynamic import.
+     */
+    async loadModule(modulePath) {
+        if (this.moduleCache.has(modulePath)) {
+            return this.moduleCache.get(modulePath);
+        }
+        let module;
+        const loader = this.moduleLoaders[modulePath];
+        if (loader) {
+            module = await loader();
+        }
+        else {
+            const absolutePath = this.toAbsolutePath(modulePath);
+            module = await import(__rewriteRelativeImportExtension(absolutePath));
+        }
+        this.moduleCache.set(modulePath, module);
+        return module;
+    }
+    /**
+     * Load widget file contents with caching.
+     * Returns an object with loaded file contents.
+     */
+    async loadWidgetFiles(widgetFiles) {
+        const load = async (path) => {
+            const absPath = this.toAbsolutePath(path);
+            const cached = this.widgetFileCache.get(absPath);
+            if (cached !== undefined)
+                return cached;
+            try {
+                const content = await this.readFile(absPath);
+                this.widgetFileCache.set(absPath, content);
+                return content;
+            }
+            catch (e) {
+                console.warn(`[RouteCore] Failed to load widget file ${path}:`, e instanceof Error ? e.message : e);
+                return undefined;
+            }
+        };
+        const [html, md, css] = await Promise.all([
+            widgetFiles.html ? load(widgetFiles.html) : undefined,
+            widgetFiles.md ? load(widgetFiles.md) : undefined,
+            widgetFiles.css ? load(widgetFiles.css) : undefined,
+        ]);
+        return { html, md, css };
+    }
+    /**
+     * Build a RouteInfo from a matched route and the resolved URL pathname.
+     * Called once per navigation; the result is reused across the route hierarchy.
+     */
+    toRouteInfo(matched, pathname) {
+        return {
+            pathname,
+            pattern: matched.route.pattern,
+            params: matched.params,
+            searchParams: matched.searchParams ?? new URLSearchParams(),
+        };
+    }
+    /**
+     * Build a ComponentContext by extending RouteInfo with loaded file contents.
+     * When a signal is provided it is forwarded to fetch() calls and included
+     * in the returned context so that getData() can observe cancellation.
+     */
+    async buildComponentContext(routeInfo, route, signal, isLeaf) {
+        const fetchFile = (filePath) => this.readFile(this.toAbsolutePath(filePath));
+        const rf = route.files;
+        const [html, md, css] = await Promise.all([
+            rf?.html ? fetchFile(rf.html) : undefined,
+            rf?.md ? fetchFile(rf.md) : undefined,
+            rf?.css ? fetchFile(rf.css) : undefined,
+        ]);
+        const base = {
+            ...routeInfo,
+            files: { html, md, css },
+            signal,
+            isLeaf,
+            basePath: this.basePath || undefined,
+        };
+        return this.contextProvider ? this.contextProvider(base) : base;
+    }
+}
+//# sourceMappingURL=route.core.js.map

package/dist/src/route/route.core.js.map

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

package/dist/src/route/route.matcher.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Route Matcher
+ *
+ * URLPattern-based route matching with support for:
+ * - Static routes (/about)
+ * - Dynamic segments (/projects/:id)
+ * - Wildcard/catch-all (future)
+ *
+ * Uses native URLPattern API (supported in all major browsers).
+ */
+/** Parse a URL path string into a URL object. Passes through URL objects unchanged. */
+export declare function toUrl(url: string | URL): URL;
+import type { ErrorBoundary, MatchedRoute, RouteConfig, RoutesManifest } from '../type/route.type.ts';
+/**
+ * Route matcher using native URLPattern API.
+ *
+ * Routes are matched in order of specificity:
+ * 1. Exact static matches first
+ * 2. Dynamic segment matches
+ * 3. More specific patterns before less specific
+ */
+export declare class RouteMatcher {
+    private compiledRoutes;
+    private errorBoundaries;
+    private statusPages;
+    private errorHandler?;
+    /**
+     * Initialize matcher with routes manifest.
+     * Routes should be pre-sorted by specificity in the manifest.
+     */
+    constructor(manifest: RoutesManifest);
+    /**
+     * Match a URL against registered routes.
+     * Returns the first matching route or undefined.
+     */
+    match(url: URL | string): MatchedRoute | undefined;
+    /**
+     * Find error boundary for a given pathname.
+     * Searches from most specific to least specific.
+     */
+    findErrorBoundary(pathname: string): ErrorBoundary | undefined;
+    /**
+     * Get status-specific page (404, 401, 403).
+     */
+    getStatusPage(status: number): RouteConfig | undefined;
+    /**
+     * Get generic error handler.
+     */
+    getErrorHandler(): RouteConfig | undefined;
+    /**
+     * Find a route by its exact pattern or by matching a pathname.
+     * Used for building route hierarchy.
+     */
+    findRoute(patternOrPath: string): RouteConfig | undefined;
+    /**
+     * Extract params from URLPatternResult.
+     */
+    private extractParams;
+}
+/**
+ * Convert file-based route path to URLPattern.
+ *
+ * Examples:
+ * - index.page.ts → /
+ * - about.page.ts → /about
+ * - projects/index.page.ts → /projects/:rest*
+ * - projects/[id].page.ts → /projects/:id
+ * - projects/[id]/tasks.page.ts → /projects/:id/tasks
+ *
+ * Directory index files (non-root) become wildcard catch-all routes.
+ * See ADR-0002: Wildcard Routes via Directory Index Convention.
+ */
+export declare function filePathToPattern(filePath: string): string;
+/**
+ * Determine route type from filename.
+ */
+export declare function getRouteType(filename: string): 'page' | 'error' | 'redirect' | null;
+/**
+ * Get the file extension type from a page filename.
+ */
+export declare function getPageFileType(filename: string): 'ts' | 'html' | 'md' | 'css' | null;
+/**
+ * Sort routes by specificity.
+ * Non-wildcards before wildcards, static before dynamic, longer paths first.
+ */
+export declare function sortRoutesBySpecificity(routes: RouteConfig[]): RouteConfig[];