@emkodev/emroute 1.7.2 → 1.8.0-beta.1

package/src/type/route-tree.type.ts

@@ -1,51 +0,0 @@
-/**
- * Route Tree
- *
- * Serializable tree structure that mirrors the filesystem layout.
- * Replaces the flat array manifest as the canonical route format.
- *
- * Each node corresponds to a URL segment. The tree is JSON-serializable
- * (no Maps, no classes) so it can be written to disk, sent over the wire,
- * or used directly as the in-memory trie for O(depth) route matching.
- */
-
-/** Files associated with a route (companion files discovered alongside the page). */
-export interface RouteFiles {
-  /** TypeScript module (e.g. "routes/about.page.ts") */
-  ts?: string;
-  /** JavaScript module — merged module with inlined companions (e.g. "routes/about.page.js") */
-  js?: string;
-  /** HTML template (e.g. "routes/about.page.html") */
-  html?: string;
-  /** Markdown content (e.g. "routes/about.page.md") */
-  md?: string;
-  /** Scoped stylesheet (e.g. "routes/about.page.css") */
-  css?: string;
-}
-
-/** A single node in the route tree. */
-export interface RouteNode {
-  /** Route files when this node is a terminal route. */
-  files?: RouteFiles;
-
-  /** Error boundary module path scoped to this prefix (from .error.ts). */
-  errorBoundary?: string;
-
-  /** Redirect module path (from .redirect.ts). Mutually exclusive with files. */
-  redirect?: string;
-
-  /** Static children keyed by URL segment (e.g. "about", "projects"). */
-  children?: Record<string, RouteNode>;
-
-  /** Single-segment dynamic param (from [param] directories/files). */
-  dynamic?: {
-    param: string;
-    child: RouteNode;
-  };
-
-  /** Catch-all wildcard (from directory index.page.* files). */
-  wildcard?: {
-    param: string;
-    child: RouteNode;
-  };
-}

package/src/type/route.type.ts

@@ -1,124 +0,0 @@
-/**
- * Router Types
- *
- * Native browser APIs only - no external dependencies.
- * Follows islands architecture: pages = HTML, widgets = web components.
- */
-
-/** Parameters extracted from URL patterns */
-export type RouteParams = Readonly<Record<string, string>>;
-
-/** Immutable route context built once per navigation, shared across the render pipeline. */
-export interface RouteInfo {
-  /** The URL being rendered. Components read pathname, searchParams, hash from this. */
-  readonly url: URL;
-
-  /** URL parameters extracted by the trie match. */
-  readonly params: RouteParams;
-}
-
-/** Supported file patterns in file-based routing */
-export type RouteFileType = 'page' | 'error' | 'redirect';
-
-/** Redirect configuration */
-export interface RedirectConfig {
-  to: string;
-  status: 301 | 302;
-}
-
-/** Available files for a route */
-export interface RouteFiles {
-  /** TypeScript module path (.page.ts) */
-  ts?: string;
-
-  /** JavaScript module — merged module with inlined companions (.page.js) */
-  js?: string;
-
-  /** HTML template path (.page.html) */
-  html?: string;
-
-  /** Markdown content path (.page.md) */
-  md?: string;
-
-  /** CSS stylesheet path (.page.css) */
-  css?: string;
-}
-
-/** Route configuration for a single route */
-export interface RouteConfig {
-  /** URLPattern pathname pattern (e.g., '/projects/:id') */
-  pattern: string;
-
-  /** Type of route file */
-  type: RouteFileType;
-
-  /** Module path for dynamic import (primary file based on precedence) */
-  modulePath: string;
-
-  /** Available files for this route */
-  files?: RouteFiles;
-
-  /** Parent route pattern for nested routes */
-  parent?: string;
-
-  /** HTTP status code (for status-specific pages like 404, 401, 403) */
-  statusCode?: number;
-}
-
-/** Result of matching a URL against routes */
-export interface MatchedRoute {
-  /** The matched route configuration */
-  readonly route: RouteConfig;
-
-  /** Extracted URL parameters */
-  readonly params: RouteParams;
-}
-
-/** Error boundary configuration */
-export interface ErrorBoundary {
-  /** Pattern prefix this error boundary handles */
-  pattern: string;
-
-  /** Module path for the error handler */
-  modulePath: string;
-}
-
-export type { RouteNode } from './route-tree.type.ts';
-
-/** Router state for history management */
-export interface RouterState {
-  /** Current URL pathname */
-  pathname: string;
-
-  /** Extracted route parameters */
-  params: RouteParams;
-
-  /** Scroll position to restore */
-  scrollY?: number;
-}
-
-/** Navigation options */
-export interface NavigateOptions {
-  /** Replace current history entry instead of pushing */
-  replace?: boolean;
-
-  /** State to store in history */
-  state?: RouterState;
-
-  /** Hash to scroll to after navigation */
-  hash?: string;
-}
-
-/** Router event types */
-export type RouterEventType = 'navigate' | 'error' | 'load';
-
-/** Router event payload */
-export interface RouterEvent {
-  type: RouterEventType;
-  pathname: string;
-  params: RouteParams;
-  error?: Error;
-}
-
-/** Router event listener */
-export type RouterEventListener = (event: RouterEvent) => void;

package/src/type/widget.type.ts

@@ -1,65 +0,0 @@
-/**
- * Widget System - Type Definitions
- *
- * Widgets are data-fetching components that work across three contexts:
- * 1. /md/ (LLMs) - Returns markdown with JSON data
- * 2. SSR/HTML - Pre-fetched data embedded in custom element
- * 3. SPA/Browser - Custom element fetches and hydrates
- */
-
-/**
- * Parsed widget block from markdown.
- * Represents a fenced code block with widget syntax.
- */
-export interface ParsedWidgetBlock {
-  /** Full matched string including fences */
-  fullMatch: string;
-
-  /** Widget name extracted from widget:{name} */
-  widgetName: string;
-
-  /** Parsed JSON params, or null if empty/invalid */
-  params: Record<string, unknown> | null;
-
-  /** Parse error message if params JSON was invalid */
-  parseError?: string;
-
-  /** Start index in original markdown */
-  startIndex: number;
-
-  /** End index in original markdown */
-  endIndex: number;
-}
-
-/** Custom element tag name for widgets: `widget-{name}` */
-export type WidgetTagName = `widget-${string}`;
-
-/** SPA rendering mode. */
-export type SpaMode = 'none' | 'leaf' | 'root' | 'only';
-
-/**
- * Widget manifest entry for code generation.
- */
-export interface WidgetManifestEntry {
-  /** Widget name in kebab-case */
-  name: string;
-
-  /** Path to widget module file */
-  modulePath: string;
-
-  /** Custom element tag name (widget-{name}) */
-  tagName: WidgetTagName;
-
-  /** Discovered/declared companion file paths (html, md, css) */
-  files?: { html?: string; md?: string; css?: string };
-}
-
-/**
- * Generated widgets manifest structure.
- */
-export interface WidgetsManifest {
-  widgets: WidgetManifestEntry[];
-
-  /** Pre-bundled module loaders keyed by module path (for SPA bundles) */
-  moduleLoaders?: Record<string, () => Promise<unknown>>;
-}

package/src/util/logger.util.ts

@@ -1,83 +0,0 @@
-/**
- * Logger Utility
- *
- * Provides structured logging for emroute internals.
- * Enable via localStorage: localStorage.setItem('emroute:debug', 'true')
- */
-
-const STORAGE_KEY = 'emroute:debug';
-const PREFIX = '[emroute]';
-
-function isEnabled(): boolean {
-  if (typeof globalThis.localStorage === 'undefined') return false;
-  return globalThis.localStorage.getItem(STORAGE_KEY) === 'true';
-}
-
-export const logger = {
-  /** Enable debug logging (persists in localStorage) */
-  enable(): void {
-    if (typeof globalThis.localStorage !== 'undefined') {
-      globalThis.localStorage.setItem(STORAGE_KEY, 'true');
-      console.log(`${PREFIX} Debug logging enabled`);
-    }
-  },
-
-  /** Disable debug logging */
-  disable(): void {
-    if (typeof globalThis.localStorage !== 'undefined') {
-      globalThis.localStorage.removeItem(STORAGE_KEY);
-      console.log(`${PREFIX} Debug logging disabled`);
-    }
-  },
-
-  /** Log general information */
-  info(category: string, message: string, data?: unknown): void {
-    if (!isEnabled()) return;
-    const prefix = `${PREFIX} [${category}]`;
-    if (data !== undefined) {
-      console.log(prefix, message, data);
-    } else {
-      console.log(prefix, message);
-    }
-  },
-
-  /** Log navigation events */
-  nav(action: string, from: string, to: string, data?: Record<string, unknown>): void {
-    if (!isEnabled()) return;
-    console.log(`${PREFIX} [nav] ${action}:`, { from, to, ...(data ?? {}) });
-  },
-
-  /** Log rendering events */
-  render(component: string, route: string, mode?: string): void {
-    if (!isEnabled()) return;
-    const modeStr = mode ? ` [mode=${mode}]` : '';
-    console.log(`${PREFIX} [render]${modeStr} ${component} → ${route}`);
-  },
-
-  /** Log link interception */
-  link(action: 'intercept' | 'passthrough', href: string, reason?: string): void {
-    if (!isEnabled()) return;
-    const reasonStr = reason ? ` (${reason})` : '';
-    console.log(`${PREFIX} [link] ${action}: ${href}${reasonStr}`);
-  },
-
-  /** Log widget lifecycle */
-  widget(event: string, name: string, data?: unknown): void {
-    if (!isEnabled()) return;
-    console.log(`${PREFIX} [widget] ${event}: ${name}`, data ?? '');
-  },
-
-  /** Log warnings (always shown, not gated by debug flag) */
-  warn(message: string): void {
-    console.warn(`${PREFIX}`, message);
-  },
-
-  /** Log SSR adoption */
-  ssr(action: string, route: string): void {
-    if (!isEnabled()) return;
-    console.log(`${PREFIX} [ssr] ${action}: ${route}`);
-  },
-};
-
-// Expose globally for console access
-(globalThis as Record<string, unknown>).__emroute_logger = logger;

package/src/widget/widget.registry.ts

@@ -1,51 +0,0 @@
-/**
- * Widget Registry
- *
- * Canonical registry where all widgets live. Used by all renderers:
- * - SSR HTML: resolves widgets by name, calls getData() + renderHTML()
- * - SSR Markdown: resolves widgets by name, calls getData() + renderMarkdown()
- * - SPA: registers custom elements for each widget
- *
- * Pages are NOT in this registry — they live in the routes manifest.
- */
-
-import type { WidgetComponent } from '../component/widget.component.ts';
-import type { WidgetManifestEntry, WidgetsManifest } from '../type/widget.type.ts';
-
-export class WidgetRegistry {
-  private widgets = new Map<string, WidgetComponent>();
-
-  /** Register a widget by its name. */
-  add(widget: WidgetComponent): void {
-    this.widgets.set(widget.name, widget);
-  }
-
-  /** Look up a widget by name. */
-  get(name: string): WidgetComponent | undefined {
-    return this.widgets.get(name);
-  }
-
-  /** Iterate all registered widgets. */
-  [Symbol.iterator](): IterableIterator<WidgetComponent> {
-    return this.widgets.values();
-  }
-
-  /** Emit a WidgetsManifest from registered widgets. */
-  toManifest(): WidgetsManifest {
-    const widgets: WidgetManifestEntry[] = [];
-    const moduleLoaders: Record<string, () => Promise<unknown>> = {};
-
-    for (const [name, widget] of this.widgets) {
-      const entry: WidgetManifestEntry = {
-        name,
-        modulePath: name,
-        tagName: `widget-${name}`,
-        files: widget.files,
-      };
-      widgets.push(entry);
-      moduleLoaders[name] = () => Promise.resolve({ default: widget.constructor });
-    }
-
-    return { widgets, moduleLoaders };
-  }
-}