@emkodev/emroute 1.8.0 → 1.8.2-beta.2

package/dist/src/overlay/overlay.type.d.ts

@@ -7,14 +7,29 @@
  * programmatic triggers, and complex workflows. dismissAll() is
  * DOM-aware and closes both programmatic and declarative overlays.
  */
+export interface ToastHandle {
+    id: number;
+    dismiss(): void;
+    update(opts: {
+        message?: string;
+        type?: string;
+        timeout?: number;
+    }): void;
+}
+export type ToastType = 'success' | 'error' | 'warning' | 'info';
+export interface ToastFunction {
+    (options: ToastOptions): ToastHandle;
+    success(message: string, timeout?: number): ToastHandle;
+    error(message: string, timeout?: number): ToastHandle;
+    warning(message: string, timeout?: number): ToastHandle;
+    info(message: string, timeout?: number): ToastHandle;
+}
 export interface OverlayService {
     modal<T = undefined>(options: ModalOptions<T>): Promise<T | undefined>;
     closeModal<T>(value?: T): void;
     popover(options: PopoverOptions): void;
     closePopover(): void;
-    toast(options: ToastOptions): {
-        dismiss(): void;
-    };
+    toast: ToastFunction;
     /** Close all open overlays — programmatic and declarative — and toasts. */
     dismissAll(): void;
 }
@@ -27,7 +42,16 @@ export interface PopoverOptions {
     render(el: HTMLDivElement): void;
 }
 export interface ToastOptions {
-    render(el: HTMLDivElement): void;
+    /** Custom render function — escape hatch for full control. */
+    render?(el: HTMLDivElement): void;
+    /** Text content (alternative to render). */
+    message?: string;
+    /** Toast type — sets `data-toast-type` attribute. */
+    type?: ToastType;
+    /** Confirm button label. Shows button, makes toast manual, returns PromiseLike<boolean>. */
+    confirm?: string;
+    /** Reject button label. */
+    reject?: string;
     /** Auto-dismiss timeout in ms. Default 0 (manual dismiss only). Set to a positive ms value for auto-dismiss via CSS animation. */
     timeout?: number;
 }

package/dist/src/renderer/spa/emroute.app.d.ts

@@ -7,6 +7,7 @@
  */
 import { Emroute } from '../../../core/server/emroute.server.ts';
 import type { NavigateOptions } from '../../../core/type/route.type.ts';
+import type { ContextProvider } from '../../../core/type/component.type.ts';
 import { type BasePath } from '../../../core/server/emroute.server.ts';
 /** Options for `createEmrouteApp`. */
 export interface EmrouteAppOptions {
@@ -36,6 +37,8 @@ export declare function createEmrouteApp(server: Emroute, options?: EmrouteAppOp
 export interface BootOptions extends EmrouteAppOptions {
     /** Override the server origin (defaults to `location.origin`). */
     origin?: string;
+    /** Context provider — enriches every ComponentContext (pages and widgets). */
+    extendContext?: ContextProvider;
 }
 /**
  * Boot the browser app from runtime manifests.

package/dist/src/renderer/spa/emroute.app.js

@@ -21,9 +21,17 @@ export class EmrouteApp {
     slot = null;
     abortController = null;
     constructor(server, options) {
-        const bp = options?.basePath ?? DEFAULT_BASE_PATH;
         this.server = server;
-        this.appBase = bp.app;
+        if (options?.basePath) {
+            this.appBase = options.basePath.app;
+        }
+        else if (typeof document !== 'undefined') {
+            const base = document.querySelector('base')?.getAttribute('href');
+            this.appBase = base ? base.replace(/\/$/, '') : DEFAULT_BASE_PATH.app;
+        }
+        else {
+            this.appBase = DEFAULT_BASE_PATH.app;
+        }
     }
     async initialize(slotSelector = 'router-slot') {
         this.slot = document.querySelector(slotSelector);
@@ -179,9 +187,11 @@ export async function bootEmrouteApp(options) {
         : [];
     // Build lazy module loaders for all route + widget + element modules
     const moduleLoaders = buildLazyLoaders(routeTree, widgetEntries, elementEntries, runtime);
-    // Register widgets eagerly (tag defined immediately, module loads on connectedCallback)
+    // Register widgets: lazy in registry (loaded on demand during render),
+    // lazy in DOM (module loads on connectedCallback for hydration).
     const widgets = new WidgetRegistry();
     for (const entry of widgetEntries) {
+        widgets.addLazy(entry.name, entry.modulePath);
         ComponentElement.registerLazy(entry.name, moduleLoaders[entry.modulePath]);
     }
     // Register custom elements — import all modules, define when loaded
@@ -198,6 +208,10 @@ export async function bootEmrouteApp(options) {
             });
         }
     }
+    // Wire context provider for both pages (Pipeline) and widgets (ComponentElement)
+    if (options?.extendContext) {
+        ComponentElement.setContextProvider(options.extendContext);
+    }
     // Create Emroute instance (same class as SSR)
     const mdRenderer = MarkdownElement.getConfiguredRenderer();
     const server = await Emroute.create({
@@ -205,6 +219,7 @@ export async function bootEmrouteApp(options) {
         widgets,
         moduleLoaders,
         ...(mdRenderer ? { markdownRenderer: mdRenderer } : {}),
+        ...(options?.extendContext ? { extendContext: options.extendContext } : {}),
     }, runtime);
     return createEmrouteApp(server, options);
 }

package/dist/src/renderer/spa/emroute.app.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emkodev/emroute",
-  "version": "1.8.0",
+  "version": "1.8.2-beta.2",
   "description": "File-based (but storage-agnostic) router with triple rendering (SPA, SSR HTML, SSR Markdown). Zero dependencies.",
   "license": "BSD-3-Clause",
   "author": "emko.dev",
@@ -99,7 +99,7 @@
     }
   },
   "devDependencies": {
-    "@emkodev/emkoma": "^0.1.0",
+    "@emkodev/emkoma": "^0.1.2",
     "@eslint/js": "^10.0.1",
     "@types/bun": "^1.3.9",
     "eslint": "^10.0.2",

package/runtime/abstract.runtime.ts

@@ -769,11 +769,17 @@ export abstract class Runtime {
 
       const files: { html?: string; md?: string; css?: string } = {};
       let hasFiles = false;
-      for (const ext of COMPANION_EXTENSIONS) {
-        const companionFile = `${name}.widget.${ext}`;
-        const companionPath = `${trailingDir}${name}/${companionFile}`;
-        if ((await this.query(companionPath)).status !== 404) {
-          files[ext] = `${prefix}${name}/${companionFile}`;
+      const companionResults = await Promise.all(
+        COMPANION_EXTENSIONS.map(async (ext) => {
+          const companionFile = `${name}.widget.${ext}`;
+          const companionPath = `${trailingDir}${name}/${companionFile}`;
+          const exists = (await this.query(companionPath)).status !== 404;
+          return { ext, exists, path: `${prefix}${name}/${companionFile}` };
+        }),
+      );
+      for (const { ext, exists, path } of companionResults) {
+        if (exists) {
+          files[ext] = path;
           hasFiles = true;
         }
       }

package/runtime/fetch.runtime.ts

@@ -59,7 +59,12 @@ export class FetchRuntime extends Runtime {
     const response = await fetch(url);
     const js = await response.text();
     const blob = new Blob([js], { type: 'application/javascript' });
-    return import(URL.createObjectURL(blob));
+    const objectUrl = URL.createObjectURL(blob);
+    try {
+      return await import(objectUrl);
+    } finally {
+      URL.revokeObjectURL(objectUrl);
+    }
   }
 
   private toUrl(resource: FetchParams[0]): string {

package/server/build.util.ts

@@ -60,17 +60,17 @@ const DEFAULT_BUNDLE_PATHS = { emroute: '/emroute.js', app: '/app.js' };
  * - Updated manifests — route tree and widget manifest reference .js paths
  * - emroute.js — pre-built from dist/ (copied into runtime)
  * - app.js — consumer entry point (transpiled from .ts, no bundler)
- * - index.html — shell with import map + script tags (if not already present)
+ * - importmap.json — merged import map (emroute externals + consumer entries)
  */
 export async function buildClientBundles(options: BuildOptions): Promise<void> {
   const { runtime, root, spa, entryPoint } = options;
-  if (spa === 'none') return;
-
   const paths = options.bundlePaths ?? DEFAULT_BUNDLE_PATHS;
 
   // Merge .ts modules → .js with inlined companions, update manifests
   await mergeModules(runtime);
 
+  if (spa === 'none') return;
+
   // Copy pre-built emroute.js from the package dist/
   const consumerRequire = createRequire(root + '/');
   const emrouteJsPath = resolvePrebuiltBundle(consumerRequire);
@@ -100,8 +100,8 @@ export async function buildClientBundles(options: BuildOptions): Promise<void> {
     } catch { /* no main.css on disk — fine */ }
   }
 
-  // Write shell (index.html) if not already present
-  await writeShell(runtime, paths);
+  // Write merged import map — server reads this when generating the shell
+  await writeImportMap(runtime, paths);
 }
 
 /**
@@ -122,15 +122,12 @@ function resolvePrebuiltBundle(require: NodeRequire): string {
   return resolve(process.cwd(), 'dist/emroute.js');
 }
 
-// ── Shell generation ──────────────────────────────────────────────────
+// ── Import map ───────────────────────────────────────────────────────
 
-async function writeShell(
+async function writeImportMap(
   runtime: Runtime,
   paths: { emroute: string; app: string },
 ): Promise<void> {
-  if ((await runtime.query('/index.html')).status !== 404) return;
-
-  // Base emroute imports
   const imports: Record<string, string> = {};
   for (const pkg of EMROUTE_EXTERNALS) {
     imports[pkg] = paths.emroute;
@@ -147,26 +144,9 @@ async function writeShell(
     }
   }
 
-  const importMap = JSON.stringify({ imports }, null, 2);
-
-  const html = `<!DOCTYPE html>
-<html>
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>emroute</title>
-  <style>@view-transition { navigation: auto; } router-slot { display: contents; }</style>
-</head>
-<body>
-  <router-slot></router-slot>
-  <script type="importmap">
-${importMap}
-  </script>
-  <script type="module" src="${paths.app}"></script>
-</body>
-</html>`;
-
-  await runtime.command('/index.html', { body: html });
+  await runtime.command('/importmap.json', {
+    body: JSON.stringify({ imports }, null, 2),
+  });
 }
 
 // ── Module merging ───────────────────────────────────────────────────

package/src/element/component.element.ts

@@ -39,7 +39,10 @@ export class ComponentElement<TParams, TData> extends HTMLElementBase {
   /** App-level context provider set once during router initialization. */
   private static extendContext: ContextProvider | undefined;
 
-  /** Register (or clear) the context provider that enriches every widget's ComponentContext. */
+  /**
+   * Register (or clear) the context provider that enriches every widget's ComponentContext.
+   * @deprecated Use `bootEmrouteApp({ extendContext })` instead — it wires both pages and widgets.
+   */
   static setContextProvider(provider: ContextProvider | undefined): void {
     ComponentElement.extendContext = provider;
   }

package/src/overlay/mod.ts

@@ -6,5 +6,5 @@
  * dismissAll() closes both programmatic and declarative overlays.
  */
 
-export type { ModalOptions, OverlayService, PopoverOptions, ToastOptions } from './overlay.type.ts';
+export type { ModalOptions, OverlayService, PopoverOptions, ToastHandle, ToastOptions } from './overlay.type.ts';
 export { createOverlayService } from './overlay.service.ts';

package/src/overlay/overlay.service.ts

@@ -11,7 +11,7 @@
  * via DOM queries.
  */
 
-import type { ModalOptions, OverlayService, PopoverOptions, ToastOptions } from './overlay.type.ts';
+import type { ModalOptions, OverlayService, PopoverOptions, ToastFunction, ToastHandle, ToastOptions } from './overlay.type.ts';
 import { overlayCSS } from './overlay.css.ts';
 
 const ANIMATION_SAFETY_TIMEOUT = 300;
@@ -35,6 +35,86 @@ function animateDismiss(el: HTMLElement, onDone: () => void): void {
   setTimeout(finish, ANIMATION_SAFETY_TIMEOUT);
 }
 
+/**
+ * Populate a toast element from a cloned template.
+ * Sets `[data-toast-message]` textContent, `data-toast-type` attribute,
+ * and unhides confirm/reject buttons when labels are provided.
+ */
+function fillTemplate(
+  el: HTMLElement,
+  options: ToastOptions,
+  onConfirm?: () => void,
+  onReject?: () => void,
+): void {
+  const msgEl = el.querySelector('[data-toast-message]');
+  if (msgEl && options.message) {
+    msgEl.textContent = options.message;
+  }
+
+  if (options.type) {
+    el.setAttribute('data-toast-type', options.type);
+  }
+
+  const confirmBtn = el.querySelector('[data-toast-confirm]') as HTMLElement | null;
+  if (confirmBtn) {
+    if (options.confirm) {
+      confirmBtn.textContent = options.confirm;
+      confirmBtn.hidden = false;
+      if (onConfirm) confirmBtn.addEventListener('click', onConfirm, { once: true });
+    } else {
+      confirmBtn.hidden = true;
+    }
+  }
+
+  const rejectBtn = el.querySelector('[data-toast-reject]') as HTMLElement | null;
+  if (rejectBtn) {
+    if (options.reject) {
+      rejectBtn.textContent = options.reject;
+      rejectBtn.hidden = false;
+      if (onReject) rejectBtn.addEventListener('click', onReject, { once: true });
+    } else {
+      rejectBtn.hidden = true;
+    }
+  }
+}
+
+/**
+ * Build toast inner content when no `<template id="overlay-toast">` exists.
+ * Creates a `<span>` with the message text, plus confirm/reject buttons
+ * if labels are provided.
+ */
+function buildFallback(
+  el: HTMLElement,
+  options: ToastOptions,
+  onConfirm?: () => void,
+  onReject?: () => void,
+): void {
+  if (options.type) {
+    el.setAttribute('data-toast-type', options.type);
+  }
+
+  const span = document.createElement('span');
+  span.setAttribute('data-toast-message', '');
+  span.textContent = options.message ?? '';
+  el.appendChild(span);
+
+  if (options.confirm) {
+    const btn = document.createElement('button');
+    btn.setAttribute('data-toast-confirm', '');
+    btn.textContent = options.confirm;
+    if (onConfirm) btn.addEventListener('click', onConfirm, { once: true });
+    el.appendChild(btn);
+  }
+
+  if (options.reject) {
+    const btn = document.createElement('button');
+    btn.setAttribute('data-toast-reject', '');
+    btn.textContent = options.reject;
+    if (onReject) btn.addEventListener('click', onReject, { once: true });
+    el.appendChild(btn);
+  }
+}
+
 export function createOverlayService(): OverlayService {
   let styleInjected = false;
 
@@ -167,7 +247,7 @@ export function createOverlayService(): OverlayService {
     }
   }
 
-  function toast(options: ToastOptions): { dismiss(): void } {
+  function toast(options: ToastOptions): ToastHandle {
     const container = ensureToastContainer();
 
     // Clean up dead toasts before adding a new one
@@ -176,26 +256,96 @@ export function createOverlayService(): OverlayService {
     const el = document.createElement('div');
     el.setAttribute('data-overlay-toast', '');
 
-    const timeout = options.timeout ?? 0;
+    const isConfirmation = !!(options.confirm || options.reject);
+    const timeout = isConfirmation ? 0 : (options.timeout ?? 0);
     if (timeout === 0) {
       el.setAttribute('data-toast-manual', '');
     } else {
       el.style.setProperty('--overlay-toast-duration', `${timeout}ms`);
     }
 
-    options.render(el);
+    // Confirmation promise plumbing
+    let confirmResolve: ((value: boolean) => void) | undefined;
+    let confirmPromise: Promise<boolean> | undefined;
+    if (isConfirmation) {
+      const resolvers = Promise.withResolvers<boolean>();
+      confirmResolve = resolvers.resolve;
+      confirmPromise = resolvers.promise;
+    }
+
+    const onConfirm = confirmResolve
+      ? () => { confirmResolve!(true); dismiss(); }
+      : undefined;
+    const onReject = confirmResolve
+      ? () => { confirmResolve!(false); dismiss(); }
+      : undefined;
+
+    // Render content
+    if (options.render) {
+      // Escape hatch: caller takes full control
+      options.render(el);
+    } else {
+      // Template-based or fallback
+      const template = document.querySelector<HTMLTemplateElement>('#overlay-toast');
+      if (template) {
+        const clone = template.content.cloneNode(true) as DocumentFragment;
+        el.appendChild(clone);
+        fillTemplate(el, options, onConfirm, onReject);
+      } else {
+        buildFallback(el, options, onConfirm, onReject);
+      }
+    }
+
     container.appendChild(el);
 
+    const id = performance.now();
     let dismissed = false;
-    const dismiss = () => {
+
+    function dismiss(): void {
       if (dismissed) return;
       dismissed = true;
       el.setAttribute('data-dismissing', '');
-    };
+    }
+
+    function update(opts: { message?: string; type?: string; timeout?: number }): void {
+      if (opts.message !== undefined) {
+        const msgEl = el.querySelector('[data-toast-message]');
+        if (msgEl) msgEl.textContent = opts.message;
+      }
+      if (opts.type !== undefined) {
+        el.setAttribute('data-toast-type', opts.type);
+      }
+      if (opts.timeout !== undefined) {
+        el.style.setProperty('--overlay-toast-duration', `${opts.timeout}ms`);
+        // Restart animation by removing and re-adding the manual flag
+        if (opts.timeout === 0) {
+          el.setAttribute('data-toast-manual', '');
+        } else {
+          el.removeAttribute('data-toast-manual');
+        }
+      }
+    }
+
+    const handle: ToastHandle = { id, dismiss, update };
 
-    return { dismiss };
+    // For confirmation toasts, return a handle that is also PromiseLike<boolean>
+    if (confirmPromise) {
+      (handle as ToastHandle & PromiseLike<boolean>).then = confirmPromise.then.bind(confirmPromise);
+    }
+
+    return handle;
   }
 
+  // Attach convenience methods
+  toast.success = (message: string, timeout?: number): ToastHandle =>
+    toast({ message, type: 'success', timeout: timeout ?? 5000 });
+  toast.error = (message: string, timeout?: number): ToastHandle =>
+    toast({ message, type: 'error', timeout: timeout ?? 5000 });
+  toast.warning = (message: string, timeout?: number): ToastHandle =>
+    toast({ message, type: 'warning', timeout: timeout ?? 5000 });
+  toast.info = (message: string, timeout?: number): ToastHandle =>
+    toast({ message, type: 'info', timeout: timeout ?? 5000 });
+
   // --- Popover ---
 
   function popover(options: PopoverOptions): void {
@@ -340,7 +490,7 @@ export function createOverlayService(): OverlayService {
   return {
     modal,
     closeModal,
-    toast,
+    toast: toast as ToastFunction,
     popover,
     closePopover,
     dismissAll,

package/src/overlay/overlay.type.ts

@@ -8,6 +8,22 @@
  * DOM-aware and closes both programmatic and declarative overlays.
  */
 
+export interface ToastHandle {
+  id: number;
+  dismiss(): void;
+  update(opts: { message?: string; type?: string; timeout?: number }): void;
+}
+
+export type ToastType = 'success' | 'error' | 'warning' | 'info';
+
+export interface ToastFunction {
+  (options: ToastOptions): ToastHandle;
+  success(message: string, timeout?: number): ToastHandle;
+  error(message: string, timeout?: number): ToastHandle;
+  warning(message: string, timeout?: number): ToastHandle;
+  info(message: string, timeout?: number): ToastHandle;
+}
+
 export interface OverlayService {
   modal<T = undefined>(options: ModalOptions<T>): Promise<T | undefined>;
   closeModal<T>(value?: T): void;
@@ -15,7 +31,7 @@ export interface OverlayService {
   popover(options: PopoverOptions): void;
   closePopover(): void;
 
-  toast(options: ToastOptions): { dismiss(): void };
+  toast: ToastFunction;
 
   /** Close all open overlays — programmatic and declarative — and toasts. */
   dismissAll(): void;
@@ -32,7 +48,16 @@ export interface PopoverOptions {
 }
 
 export interface ToastOptions {
-  render(el: HTMLDivElement): void;
+  /** Custom render function — escape hatch for full control. */
+  render?(el: HTMLDivElement): void;
+  /** Text content (alternative to render). */
+  message?: string;
+  /** Toast type — sets `data-toast-type` attribute. */
+  type?: ToastType;
+  /** Confirm button label. Shows button, makes toast manual, returns PromiseLike<boolean>. */
+  confirm?: string;
+  /** Reject button label. */
+  reject?: string;
   /** Auto-dismiss timeout in ms. Default 0 (manual dismiss only). Set to a positive ms value for auto-dismiss via CSS animation. */
   timeout?: number;
 }

package/src/renderer/spa/emroute.app.ts

@@ -15,6 +15,7 @@ import type { RouteNode } from '../../../core/type/route-tree.type.ts';
 import type { NavigateOptions } from '../../../core/type/route.type.ts';
 import type { WidgetManifestEntry } from '../../../core/type/widget.type.ts';
 import type { ElementManifestEntry } from '../../../core/type/element.type.ts';
+import type { ContextProvider } from '../../../core/type/component.type.ts';
 import { type BasePath, DEFAULT_BASE_PATH } from '../../../core/server/emroute.server.ts';
 import { assertSafeRedirect, escapeHtml } from '../../../core/util/html.util.ts';
 import { ComponentElement } from '../../element/component.element.ts';
@@ -34,9 +35,15 @@ export class EmrouteApp {
   private abortController: AbortController | null = null;
 
   constructor(server: Emroute, options?: EmrouteAppOptions) {
-    const bp = options?.basePath ?? DEFAULT_BASE_PATH;
     this.server = server;
-    this.appBase = bp.app;
+    if (options?.basePath) {
+      this.appBase = options.basePath.app;
+    } else if (typeof document !== 'undefined') {
+      const base = document.querySelector('base')?.getAttribute('href');
+      this.appBase = base ? base.replace(/\/$/, '') : DEFAULT_BASE_PATH.app;
+    } else {
+      this.appBase = DEFAULT_BASE_PATH.app;
+    }
   }
 
   async initialize(slotSelector = 'router-slot'): Promise<void> {
@@ -178,6 +185,8 @@ export async function createEmrouteApp(
 export interface BootOptions extends EmrouteAppOptions {
   /** Override the server origin (defaults to `location.origin`). */
   origin?: string;
+  /** Context provider — enriches every ComponentContext (pages and widgets). */
+  extendContext?: ContextProvider;
 }
 
 /**
@@ -216,9 +225,11 @@ export async function bootEmrouteApp(options?: BootOptions): Promise<EmrouteApp>
   // Build lazy module loaders for all route + widget + element modules
   const moduleLoaders = buildLazyLoaders(routeTree, widgetEntries, elementEntries, runtime);
 
-  // Register widgets eagerly (tag defined immediately, module loads on connectedCallback)
+  // Register widgets: lazy in registry (loaded on demand during render),
+  // lazy in DOM (module loads on connectedCallback for hydration).
   const widgets = new WidgetRegistry();
   for (const entry of widgetEntries) {
+    widgets.addLazy(entry.name, entry.modulePath);
     ComponentElement.registerLazy(entry.name, moduleLoaders[entry.modulePath]!);
   }
 
@@ -237,6 +248,11 @@ export async function bootEmrouteApp(options?: BootOptions): Promise<EmrouteApp>
     }
   }
 
+  // Wire context provider for both pages (Pipeline) and widgets (ComponentElement)
+  if (options?.extendContext) {
+    ComponentElement.setContextProvider(options.extendContext);
+  }
+
   // Create Emroute instance (same class as SSR)
   const mdRenderer = MarkdownElement.getConfiguredRenderer();
   const server = await Emroute.create({
@@ -244,6 +260,7 @@ export async function bootEmrouteApp(options?: BootOptions): Promise<EmrouteApp>
     widgets,
     moduleLoaders,
     ...(mdRenderer ? { markdownRenderer: mdRenderer } : {}),
+    ...(options?.extendContext ? { extendContext: options.extendContext } : {}),
   }, runtime);
 
   return createEmrouteApp(server, options);