@mokup/server 1.0.4 → 1.1.1

package/dist/index.cjs

@@ -2,7 +2,7 @@
 
 const runtime = require('@mokup/runtime');
 const fetch = require('./shared/server.BdTl0qJd.cjs');
-const node_process = require('node:process');
+const process = require('node:process');
 const hono = require('@mokup/shared/hono');
 const pathe = require('@mokup/shared/pathe');
 const node_fs = require('node:fs');
@@ -13,6 +13,10 @@ const esbuild = require('@mokup/shared/esbuild');
 const jsoncParser = require('@mokup/shared/jsonc-parser');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const process__default = /*#__PURE__*/_interopDefaultCompat(process);
+
 function createConnectMiddleware(options) {
   const runtime$1 = runtime.createRuntime(fetch.toRuntimeOptions(options));
   const onNotFound = options.onNotFound ?? "next";
@@ -89,6 +93,7 @@ const supportedExtensions = /* @__PURE__ */ new Set([
   ".mjs",
   ".cjs"
 ]);
+const configExtensions = [".ts", ".js", ".mjs", ".cjs"];
 
 function normalizePrefix(prefix) {
   if (!prefix) {
@@ -358,7 +363,7 @@ function isAncestor(parent, child) {
 }
 function resolveGroupRoot(dirs, serverRoot) {
   if (!dirs || dirs.length === 0) {
-    return serverRoot ?? node_process.cwd();
+    return serverRoot ?? process.cwd();
   }
   if (serverRoot) {
     const normalizedRoot = normalizePath(serverRoot);
@@ -382,7 +387,7 @@ function resolveGroupRoot(dirs, serverRoot) {
     }
   }
   if (!common || common === "/") {
-    return serverRoot ?? node_process.cwd();
+    return serverRoot ?? process.cwd();
   }
   return common;
 }
@@ -394,12 +399,23 @@ const disabledReasonSet = /* @__PURE__ */ new Set([
   "include",
   "unknown"
 ]);
+const ignoredReasonSet = /* @__PURE__ */ new Set([
+  "unsupported",
+  "invalid-route",
+  "unknown"
+]);
 function normalizeDisabledReason(reason) {
   if (reason && disabledReasonSet.has(reason)) {
     return reason;
   }
   return "unknown";
 }
+function normalizeIgnoredReason(reason) {
+  if (reason && ignoredReasonSet.has(reason)) {
+    return reason;
+  }
+  return "unknown";
+}
 function formatRouteFile(file, root) {
   if (!root) {
     return toPosixPath(file);
@@ -462,14 +478,44 @@ function toPlaygroundRoute(route, root, groups) {
 }
 function toPlaygroundDisabledRoute(route, root, groups) {
   const matchedGroup = resolveRouteGroup(route.file, groups);
-  return {
+  const disabled = {
     file: formatRouteFile(route.file, root),
-    reason: normalizeDisabledReason(route.reason),
-    method: route.method,
-    url: route.url,
-    groupKey: matchedGroup?.key,
-    group: matchedGroup?.label
+    reason: normalizeDisabledReason(route.reason)
   };
+  if (typeof route.method !== "undefined") {
+    disabled.method = route.method;
+  }
+  if (typeof route.url !== "undefined") {
+    disabled.url = route.url;
+  }
+  if (matchedGroup) {
+    disabled.groupKey = matchedGroup.key;
+    disabled.group = matchedGroup.label;
+  }
+  return disabled;
+}
+function toPlaygroundIgnoredRoute(route, root, groups) {
+  const matchedGroup = resolveRouteGroup(route.file, groups);
+  const ignored = {
+    file: formatRouteFile(route.file, root),
+    reason: normalizeIgnoredReason(route.reason)
+  };
+  if (matchedGroup) {
+    ignored.groupKey = matchedGroup.key;
+    ignored.group = matchedGroup.label;
+  }
+  return ignored;
+}
+function toPlaygroundConfigFile(entry, root, groups) {
+  const matchedGroup = resolveRouteGroup(entry.file, groups);
+  const configFile = {
+    file: formatRouteFile(entry.file, root)
+  };
+  if (matchedGroup) {
+    configFile.groupKey = matchedGroup.key;
+    configFile.group = matchedGroup.label;
+  }
+  return configFile;
 }
 function registerPlaygroundRoutes(params) {
   if (!params.config.enabled) {
@@ -509,7 +555,12 @@ function registerPlaygroundRoutes(params) {
       count: params.routes.length,
       groups: groups.map((group) => ({ key: group.key, label: group.label })),
       routes: params.routes.map((route) => toPlaygroundRoute(route, baseRoot, groups)),
-      disabled: (params.disabledRoutes ?? []).map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups))
+      disabled: (params.disabledRoutes ?? []).map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups)),
+      ignored: (params.ignoredRoutes ?? []).map((route) => toPlaygroundIgnoredRoute(route, baseRoot, groups)),
+      configs: (params.configFiles ?? []).map((entry) => toPlaygroundConfigFile(entry, baseRoot, groups)),
+      disabledConfigs: (params.disabledConfigFiles ?? []).map(
+        (entry) => toPlaygroundConfigFile(entry, baseRoot, groups)
+      )
     });
   });
   params.app.get(`${playgroundPath}/*`, async (c) => {
@@ -655,8 +706,78 @@ function sortRoutes(routes) {
   });
 }
 
-const configExtensions = [".ts", ".js", ".mjs", ".cjs"];
-async function loadModule$1(file) {
+let registerPromise = null;
+let hasLoggedFailure = false;
+async function ensureTsxRegister(logger) {
+  if (registerPromise) {
+    return registerPromise;
+  }
+  registerPromise = (async () => {
+    try {
+      const mod = await import('tsx/esm/api');
+      const setSourceMapsEnabled = process__default.setSourceMapsEnabled;
+      if (typeof setSourceMapsEnabled === "function") {
+        setSourceMapsEnabled(true);
+      }
+      if (typeof mod.register === "function") {
+        mod.register();
+      }
+      return true;
+    } catch (error) {
+      if (!hasLoggedFailure && logger) {
+        logger.warn(
+          "Failed to register tsx loader; falling back to bundled TS loader.",
+          error
+        );
+        hasLoggedFailure = true;
+      }
+      return false;
+    }
+  })();
+  return registerPromise;
+}
+
+function isUnknownFileExtensionError$1(error) {
+  if (!error || typeof error !== "object") {
+    return false;
+  }
+  const code = error.code;
+  if (code === "ERR_UNKNOWN_FILE_EXTENSION") {
+    return true;
+  }
+  const message = error.message;
+  return typeof message === "string" && message.includes("Unknown file extension");
+}
+async function loadTsModule$1(file, logger) {
+  const cacheBust = Date.now();
+  const fileUrl = `${node_url.pathToFileURL(file).href}?t=${cacheBust}`;
+  const registered = await ensureTsxRegister(logger);
+  if (registered) {
+    try {
+      return await import(fileUrl);
+    } catch (error) {
+      if (!isUnknownFileExtensionError$1(error)) {
+        throw error;
+      }
+    }
+  }
+  const result = await esbuild.build({
+    entryPoints: [file],
+    bundle: true,
+    format: "esm",
+    platform: "node",
+    sourcemap: "inline",
+    target: "es2020",
+    write: false
+  });
+  const output = result.outputFiles[0];
+  const code = output?.text ?? "";
+  const dataUrl = `data:text/javascript;base64,${node_buffer.Buffer.from(code).toString(
+    "base64"
+  )}`;
+  return import(`${dataUrl}#${cacheBust}`);
+}
+async function loadModule$1(file, logger) {
   const ext = configExtensions.find((extension) => file.endsWith(extension));
   if (ext === ".cjs") {
     const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
@@ -667,21 +788,7 @@ async function loadModule$1(file) {
     return import(`${node_url.pathToFileURL(file).href}?t=${Date.now()}`);
   }
   if (ext === ".ts") {
-    const result = await esbuild.build({
-      entryPoints: [file],
-      bundle: true,
-      format: "esm",
-      platform: "node",
-      sourcemap: "inline",
-      target: "es2020",
-      write: false
-    });
-    const output = result.outputFiles[0];
-    const code = output?.text ?? "";
-    const dataUrl = `data:text/javascript;base64,${node_buffer.Buffer.from(code).toString(
-      "base64"
-    )}`;
-    return import(`${dataUrl}#${Date.now()}`);
+    return loadTsModule$1(file, logger);
   }
   return null;
 }
@@ -705,8 +812,8 @@ async function findConfigFile(dir, cache) {
   cache.set(dir, null);
   return null;
 }
-async function loadConfig(file) {
-  const mod = await loadModule$1(file);
+async function loadConfig(file, logger) {
+  const mod = await loadModule$1(file, logger);
   if (!mod) {
     return null;
   }
@@ -757,7 +864,7 @@ async function resolveDirectoryConfig(params) {
     }
     let config = configCache.get(configPath);
     if (config === void 0) {
-      config = await loadConfig(configPath);
+      config = await loadConfig(configPath, logger);
       configCache.set(configPath, config);
     }
     if (!config) {
@@ -831,14 +938,65 @@ function isSupportedFile(file) {
   if (file.endsWith(".d.ts")) {
     return false;
   }
-  if (pathe.basename(file).startsWith("index.config.")) {
+  if (isConfigFile(file)) {
     return false;
   }
   const ext = pathe.extname(file).toLowerCase();
   return supportedExtensions.has(ext);
 }
+function isConfigFile(file) {
+  if (file.endsWith(".d.ts")) {
+    return false;
+  }
+  const base = pathe.basename(file);
+  if (!base.startsWith("index.config.")) {
+    return false;
+  }
+  const ext = pathe.extname(file).toLowerCase();
+  return configExtensions.includes(ext);
+}
 
-async function loadModule(file) {
+function isUnknownFileExtensionError(error) {
+  if (!error || typeof error !== "object") {
+    return false;
+  }
+  const code = error.code;
+  if (code === "ERR_UNKNOWN_FILE_EXTENSION") {
+    return true;
+  }
+  const message = error.message;
+  return typeof message === "string" && message.includes("Unknown file extension");
+}
+async function loadTsModule(file, logger) {
+  const cacheBust = Date.now();
+  const fileUrl = `${node_url.pathToFileURL(file).href}?t=${cacheBust}`;
+  const registered = await ensureTsxRegister(logger);
+  if (registered) {
+    try {
+      return await import(fileUrl);
+    } catch (error) {
+      if (!isUnknownFileExtensionError(error)) {
+        throw error;
+      }
+    }
+  }
+  const result = await esbuild.build({
+    entryPoints: [file],
+    bundle: true,
+    format: "esm",
+    platform: "node",
+    sourcemap: "inline",
+    target: "es2020",
+    write: false
+  });
+  const output = result.outputFiles[0];
+  const code = output?.text ?? "";
+  const dataUrl = `data:text/javascript;base64,${node_buffer.Buffer.from(code).toString(
+    "base64"
+  )}`;
+  return import(`${dataUrl}#${cacheBust}`);
+}
+async function loadModule(file, logger) {
   const ext = pathe.extname(file).toLowerCase();
   if (ext === ".cjs") {
     const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
@@ -849,21 +1007,7 @@ async function loadModule(file) {
     return import(`${node_url.pathToFileURL(file).href}?t=${Date.now()}`);
   }
   if (ext === ".ts") {
-    const result = await esbuild.build({
-      entryPoints: [file],
-      bundle: true,
-      format: "esm",
-      platform: "node",
-      sourcemap: "inline",
-      target: "es2020",
-      write: false
-    });
-    const output = result.outputFiles[0];
-    const code = output?.text ?? "";
-    const dataUrl = `data:text/javascript;base64,${node_buffer.Buffer.from(code).toString(
-      "base64"
-    )}`;
-    return import(`${dataUrl}#${Date.now()}`);
+    return loadTsModule(file, logger);
   }
   return null;
 }
@@ -898,7 +1042,7 @@ async function loadRules(file, logger) {
       }
     ];
   }
-  const mod = await loadModule(file);
+  const mod = await loadModule(file, logger);
   const value = mod?.default ?? mod;
   if (!value) {
     return [];
@@ -945,6 +1089,14 @@ function resolveSkipRoute(params) {
     url: resolved.template
   };
 }
+function buildSkipInfo(file, reason, resolved) {
+  const info = { file, reason };
+  if (resolved) {
+    info.method = resolved.method;
+    info.url = resolved.url;
+  }
+  return info;
+}
 async function scanRoutes(params) {
   const routes = [];
   const seen = /* @__PURE__ */ new Set();
@@ -953,7 +1105,22 @@ async function scanRoutes(params) {
   const configCache = /* @__PURE__ */ new Map();
   const fileCache = /* @__PURE__ */ new Map();
   const shouldCollectSkip = typeof params.onSkip === "function";
+  const shouldCollectIgnore = typeof params.onIgnore === "function";
+  const shouldCollectConfig = typeof params.onConfig === "function";
   for (const fileInfo of files) {
+    if (isConfigFile(fileInfo.file)) {
+      if (shouldCollectConfig) {
+        const config2 = await resolveDirectoryConfig({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          logger: params.logger,
+          configCache,
+          fileCache
+        });
+        params.onConfig?.({ file: fileInfo.file, enabled: config2.enabled !== false });
+      }
+      continue;
+    }
     const config = await resolveDirectoryConfig({
       file: fileInfo.file,
       rootDir: fileInfo.rootDir,
@@ -968,12 +1135,7 @@ async function scanRoutes(params) {
           rootDir: fileInfo.rootDir,
           prefix: params.prefix
         });
-        params.onSkip?.({
-          file: fileInfo.file,
-          reason: "disabled-dir",
-          method: resolved?.method,
-          url: resolved?.url
-        });
+        params.onSkip?.(buildSkipInfo(fileInfo.file, "disabled-dir", resolved));
       }
       continue;
     }
@@ -985,16 +1147,14 @@ async function scanRoutes(params) {
           rootDir: fileInfo.rootDir,
           prefix: params.prefix
         });
-        params.onSkip?.({
-          file: fileInfo.file,
-          reason: "ignore-prefix",
-          method: resolved?.method,
-          url: resolved?.url
-        });
+        params.onSkip?.(buildSkipInfo(fileInfo.file, "ignore-prefix", resolved));
       }
       continue;
     }
     if (!isSupportedFile(fileInfo.file)) {
+      if (shouldCollectIgnore) {
+        params.onIgnore?.({ file: fileInfo.file, reason: "unsupported" });
+      }
       continue;
     }
     const effectiveInclude = typeof config.include !== "undefined" ? config.include : params.include;
@@ -1007,17 +1167,15 @@ async function scanRoutes(params) {
           prefix: params.prefix
         });
         const reason = effectiveExclude && matchesFilter(fileInfo.file, void 0, effectiveExclude) ? "exclude" : "include";
-        params.onSkip?.({
-          file: fileInfo.file,
-          reason,
-          method: resolved?.method,
-          url: resolved?.url
-        });
+        params.onSkip?.(buildSkipInfo(fileInfo.file, reason, resolved));
       }
       continue;
     }
     const derived = deriveRouteFromFile(fileInfo.file, fileInfo.rootDir, params.logger);
     if (!derived) {
+      if (shouldCollectIgnore) {
+        params.onIgnore?.({ file: fileInfo.file, reason: "invalid-route" });
+      }
       continue;
     }
     const rules = await loadRules(fileInfo.file, params.logger);
@@ -1033,12 +1191,7 @@ async function scanRoutes(params) {
             prefix: params.prefix,
             derived
           });
-          params.onSkip?.({
-            file: fileInfo.file,
-            reason: "disabled",
-            method: resolved2?.method,
-            url: resolved2?.url
-          });
+          params.onSkip?.(buildSkipInfo(fileInfo.file, "disabled", resolved2));
         }
         continue;
       }
@@ -1121,7 +1274,7 @@ function resolveRoot(list) {
   if (deno?.cwd) {
     return deno.cwd();
   }
-  return node_process.cwd();
+  return process.cwd();
 }
 function resolveAllDirs(list, root) {
   const dirs = [];
@@ -1143,6 +1296,9 @@ function buildApp(params) {
     app,
     routes: params.routes,
     disabledRoutes: params.disabledRoutes,
+    ignoredRoutes: params.ignoredRoutes,
+    configFiles: params.configFiles,
+    disabledConfigFiles: params.disabledConfigFiles,
     dirs: params.dirs,
     logger: params.logger,
     config: params.playground,
@@ -1152,7 +1308,8 @@ function buildApp(params) {
     app.get(`${params.playground.path}/ws`, params.wsHandler);
   }
   if (params.routes.length > 0) {
-    const mockApp = createHonoApp(params.routes, { onResponse: params.onResponse });
+    const mockAppOptions = params.onResponse ? { onResponse: params.onResponse } : {};
+    const mockApp = createHonoApp(params.routes, mockAppOptions);
     app.route("/", mockApp);
   }
   return app;
@@ -1307,26 +1464,36 @@ async function createFetchServer(options = {}) {
   }
   let routes = [];
   let disabledRoutes = [];
+  let ignoredRoutes = [];
+  let configFiles = [];
+  let disabledConfigFiles = [];
   let app = buildApp({
     routes,
     disabledRoutes,
+    ignoredRoutes,
+    configFiles,
+    disabledConfigFiles,
     dirs,
     playground: playgroundConfig,
     root,
     logger,
     onResponse: handleRouteResponse,
-    wsHandler
+    ...wsHandler ? { wsHandler } : {}
   });
   const refreshRoutes = async () => {
     try {
       const collected = [];
       const collectedDisabled = [];
+      const collectedIgnored = [];
+      const collectedConfigs = [];
       for (const entry of optionList) {
         const scanParams = {
           dirs: resolveDirs(entry.dir, root),
           prefix: entry.prefix ?? "",
           logger,
-          onSkip: (info) => collectedDisabled.push(info)
+          onSkip: (info) => collectedDisabled.push(info),
+          onIgnore: (info) => collectedIgnored.push(info),
+          onConfig: (info) => collectedConfigs.push(info)
         };
         if (entry.include) {
           scanParams.include = entry.include;
@@ -1343,15 +1510,23 @@ async function createFetchServer(options = {}) {
       const resolvedRoutes = sortRoutes(collected);
       routes = resolvedRoutes;
       disabledRoutes = collectedDisabled;
+      ignoredRoutes = collectedIgnored;
+      const configMap = new Map(collectedConfigs.map((entry) => [entry.file, entry]));
+      const resolvedConfigs = Array.from(configMap.values());
+      configFiles = resolvedConfigs.filter((entry) => entry.enabled);
+      disabledConfigFiles = resolvedConfigs.filter((entry) => !entry.enabled);
       app = buildApp({
         routes,
         disabledRoutes,
+        ignoredRoutes,
+        configFiles,
+        disabledConfigFiles,
         dirs,
         playground: playgroundConfig,
         root,
         logger,
         onResponse: handleRouteResponse,
-        wsHandler
+        ...wsHandler ? { wsHandler } : {}
       });
       logger.info(`Loaded ${routes.length} mock routes.`);
     } catch (error) {
@@ -1377,7 +1552,7 @@ async function createFetchServer(options = {}) {
     fetch,
     refresh: refreshRoutes,
     getRoutes: () => routes,
-    injectWebSocket
+    ...injectWebSocket ? { injectWebSocket } : {}
   };
   if (watcher) {
     server.close = async () => {

package/dist/index.d.cts

@@ -41,8 +41,10 @@ declare function createFastifyPlugin(options: ServerOptions): (instance: Fastify
 declare function createFetchHandler(options: ServerOptions): FetchHandler;
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
-type RequestHandler = (context: Context) => Response | Promise<Response> | unknown;
-type RouteResponse = unknown | RequestHandler;
+type RouteStaticResponse = string | number | boolean | bigint | symbol | null | undefined | object;
+type RouteHandlerResult = RouteStaticResponse | Response;
+type RequestHandler = (context: Context) => RouteHandlerResult | Promise<RouteHandlerResult>;
+type RouteResponse = RouteStaticResponse | RequestHandler;
 interface ResolvedMiddleware {
     handle: MiddlewareHandler;
     source: string;

package/dist/index.d.mts

@@ -41,8 +41,10 @@ declare function createFastifyPlugin(options: ServerOptions): (instance: Fastify
 declare function createFetchHandler(options: ServerOptions): FetchHandler;
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
-type RequestHandler = (context: Context) => Response | Promise<Response> | unknown;
-type RouteResponse = unknown | RequestHandler;
+type RouteStaticResponse = string | number | boolean | bigint | symbol | null | undefined | object;
+type RouteHandlerResult = RouteStaticResponse | Response;
+type RequestHandler = (context: Context) => RouteHandlerResult | Promise<RouteHandlerResult>;
+type RouteResponse = RouteStaticResponse | RequestHandler;
 interface ResolvedMiddleware {
     handle: MiddlewareHandler;
     source: string;

package/dist/index.d.ts

@@ -41,8 +41,10 @@ declare function createFastifyPlugin(options: ServerOptions): (instance: Fastify
 declare function createFetchHandler(options: ServerOptions): FetchHandler;
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
-type RequestHandler = (context: Context) => Response | Promise<Response> | unknown;
-type RouteResponse = unknown | RequestHandler;
+type RouteStaticResponse = string | number | boolean | bigint | symbol | null | undefined | object;
+type RouteHandlerResult = RouteStaticResponse | Response;
+type RequestHandler = (context: Context) => RouteHandlerResult | Promise<RouteHandlerResult>;
+type RouteResponse = RouteStaticResponse | RequestHandler;
 interface ResolvedMiddleware {
     handle: MiddlewareHandler;
     source: string;

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { createRuntime, compareRouteScore, parseRouteTemplate } from '@mokup/runtime';
 import { t as toRuntimeOptions, a as toRuntimeRequestFromNode, b as applyRuntimeResultToNode, d as toBinaryBody, c as createFetchHandler } from './shared/server.Dje1y79O.mjs';
-import { cwd } from 'node:process';
+import process, { cwd } from 'node:process';
 import { Hono, PatternRouter } from '@mokup/shared/hono';
 import { resolve, isAbsolute, relative, join, normalize, extname, dirname, basename } from '@mokup/shared/pathe';
 import { promises } from 'node:fs';
@@ -86,6 +86,7 @@ const supportedExtensions = /* @__PURE__ */ new Set([
   ".mjs",
   ".cjs"
 ]);
+const configExtensions = [".ts", ".js", ".mjs", ".cjs"];
 
 function normalizePrefix(prefix) {
   if (!prefix) {
@@ -391,12 +392,23 @@ const disabledReasonSet = /* @__PURE__ */ new Set([
   "include",
   "unknown"
 ]);
+const ignoredReasonSet = /* @__PURE__ */ new Set([
+  "unsupported",
+  "invalid-route",
+  "unknown"
+]);
 function normalizeDisabledReason(reason) {
   if (reason && disabledReasonSet.has(reason)) {
     return reason;
   }
   return "unknown";
 }
+function normalizeIgnoredReason(reason) {
+  if (reason && ignoredReasonSet.has(reason)) {
+    return reason;
+  }
+  return "unknown";
+}
 function formatRouteFile(file, root) {
   if (!root) {
     return toPosixPath(file);
@@ -459,14 +471,44 @@ function toPlaygroundRoute(route, root, groups) {
 }
 function toPlaygroundDisabledRoute(route, root, groups) {
   const matchedGroup = resolveRouteGroup(route.file, groups);
-  return {
+  const disabled = {
     file: formatRouteFile(route.file, root),
-    reason: normalizeDisabledReason(route.reason),
-    method: route.method,
-    url: route.url,
-    groupKey: matchedGroup?.key,
-    group: matchedGroup?.label
+    reason: normalizeDisabledReason(route.reason)
+  };
+  if (typeof route.method !== "undefined") {
+    disabled.method = route.method;
+  }
+  if (typeof route.url !== "undefined") {
+    disabled.url = route.url;
+  }
+  if (matchedGroup) {
+    disabled.groupKey = matchedGroup.key;
+    disabled.group = matchedGroup.label;
+  }
+  return disabled;
+}
+function toPlaygroundIgnoredRoute(route, root, groups) {
+  const matchedGroup = resolveRouteGroup(route.file, groups);
+  const ignored = {
+    file: formatRouteFile(route.file, root),
+    reason: normalizeIgnoredReason(route.reason)
+  };
+  if (matchedGroup) {
+    ignored.groupKey = matchedGroup.key;
+    ignored.group = matchedGroup.label;
+  }
+  return ignored;
+}
+function toPlaygroundConfigFile(entry, root, groups) {
+  const matchedGroup = resolveRouteGroup(entry.file, groups);
+  const configFile = {
+    file: formatRouteFile(entry.file, root)
   };
+  if (matchedGroup) {
+    configFile.groupKey = matchedGroup.key;
+    configFile.group = matchedGroup.label;
+  }
+  return configFile;
 }
 function registerPlaygroundRoutes(params) {
   if (!params.config.enabled) {
@@ -506,7 +548,12 @@ function registerPlaygroundRoutes(params) {
       count: params.routes.length,
       groups: groups.map((group) => ({ key: group.key, label: group.label })),
       routes: params.routes.map((route) => toPlaygroundRoute(route, baseRoot, groups)),
-      disabled: (params.disabledRoutes ?? []).map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups))
+      disabled: (params.disabledRoutes ?? []).map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups)),
+      ignored: (params.ignoredRoutes ?? []).map((route) => toPlaygroundIgnoredRoute(route, baseRoot, groups)),
+      configs: (params.configFiles ?? []).map((entry) => toPlaygroundConfigFile(entry, baseRoot, groups)),
+      disabledConfigs: (params.disabledConfigFiles ?? []).map(
+        (entry) => toPlaygroundConfigFile(entry, baseRoot, groups)
+      )
     });
   });
   params.app.get(`${playgroundPath}/*`, async (c) => {
@@ -652,8 +699,78 @@ function sortRoutes(routes) {
   });
 }
 
-const configExtensions = [".ts", ".js", ".mjs", ".cjs"];
-async function loadModule$1(file) {
+let registerPromise = null;
+let hasLoggedFailure = false;
+async function ensureTsxRegister(logger) {
+  if (registerPromise) {
+    return registerPromise;
+  }
+  registerPromise = (async () => {
+    try {
+      const mod = await import('tsx/esm/api');
+      const setSourceMapsEnabled = process.setSourceMapsEnabled;
+      if (typeof setSourceMapsEnabled === "function") {
+        setSourceMapsEnabled(true);
+      }
+      if (typeof mod.register === "function") {
+        mod.register();
+      }
+      return true;
+    } catch (error) {
+      if (!hasLoggedFailure && logger) {
+        logger.warn(
+          "Failed to register tsx loader; falling back to bundled TS loader.",
+          error
+        );
+        hasLoggedFailure = true;
+      }
+      return false;
+    }
+  })();
+  return registerPromise;
+}
+
+function isUnknownFileExtensionError$1(error) {
+  if (!error || typeof error !== "object") {
+    return false;
+  }
+  const code = error.code;
+  if (code === "ERR_UNKNOWN_FILE_EXTENSION") {
+    return true;
+  }
+  const message = error.message;
+  return typeof message === "string" && message.includes("Unknown file extension");
+}
+async function loadTsModule$1(file, logger) {
+  const cacheBust = Date.now();
+  const fileUrl = `${pathToFileURL(file).href}?t=${cacheBust}`;
+  const registered = await ensureTsxRegister(logger);
+  if (registered) {
+    try {
+      return await import(fileUrl);
+    } catch (error) {
+      if (!isUnknownFileExtensionError$1(error)) {
+        throw error;
+      }
+    }
+  }
+  const result = await build({
+    entryPoints: [file],
+    bundle: true,
+    format: "esm",
+    platform: "node",
+    sourcemap: "inline",
+    target: "es2020",
+    write: false
+  });
+  const output = result.outputFiles[0];
+  const code = output?.text ?? "";
+  const dataUrl = `data:text/javascript;base64,${Buffer.from(code).toString(
+    "base64"
+  )}`;
+  return import(`${dataUrl}#${cacheBust}`);
+}
+async function loadModule$1(file, logger) {
   const ext = configExtensions.find((extension) => file.endsWith(extension));
   if (ext === ".cjs") {
     const require = createRequire(import.meta.url);
@@ -664,21 +781,7 @@ async function loadModule$1(file) {
     return import(`${pathToFileURL(file).href}?t=${Date.now()}`);
   }
   if (ext === ".ts") {
-    const result = await build({
-      entryPoints: [file],
-      bundle: true,
-      format: "esm",
-      platform: "node",
-      sourcemap: "inline",
-      target: "es2020",
-      write: false
-    });
-    const output = result.outputFiles[0];
-    const code = output?.text ?? "";
-    const dataUrl = `data:text/javascript;base64,${Buffer.from(code).toString(
-      "base64"
-    )}`;
-    return import(`${dataUrl}#${Date.now()}`);
+    return loadTsModule$1(file, logger);
   }
   return null;
 }
@@ -702,8 +805,8 @@ async function findConfigFile(dir, cache) {
   cache.set(dir, null);
   return null;
 }
-async function loadConfig(file) {
-  const mod = await loadModule$1(file);
+async function loadConfig(file, logger) {
+  const mod = await loadModule$1(file, logger);
   if (!mod) {
     return null;
   }
@@ -754,7 +857,7 @@ async function resolveDirectoryConfig(params) {
     }
     let config = configCache.get(configPath);
     if (config === void 0) {
-      config = await loadConfig(configPath);
+      config = await loadConfig(configPath, logger);
       configCache.set(configPath, config);
     }
     if (!config) {
@@ -828,14 +931,65 @@ function isSupportedFile(file) {
   if (file.endsWith(".d.ts")) {
     return false;
   }
-  if (basename(file).startsWith("index.config.")) {
+  if (isConfigFile(file)) {
     return false;
   }
   const ext = extname(file).toLowerCase();
   return supportedExtensions.has(ext);
 }
+function isConfigFile(file) {
+  if (file.endsWith(".d.ts")) {
+    return false;
+  }
+  const base = basename(file);
+  if (!base.startsWith("index.config.")) {
+    return false;
+  }
+  const ext = extname(file).toLowerCase();
+  return configExtensions.includes(ext);
+}
 
-async function loadModule(file) {
+function isUnknownFileExtensionError(error) {
+  if (!error || typeof error !== "object") {
+    return false;
+  }
+  const code = error.code;
+  if (code === "ERR_UNKNOWN_FILE_EXTENSION") {
+    return true;
+  }
+  const message = error.message;
+  return typeof message === "string" && message.includes("Unknown file extension");
+}
+async function loadTsModule(file, logger) {
+  const cacheBust = Date.now();
+  const fileUrl = `${pathToFileURL(file).href}?t=${cacheBust}`;
+  const registered = await ensureTsxRegister(logger);
+  if (registered) {
+    try {
+      return await import(fileUrl);
+    } catch (error) {
+      if (!isUnknownFileExtensionError(error)) {
+        throw error;
+      }
+    }
+  }
+  const result = await build({
+    entryPoints: [file],
+    bundle: true,
+    format: "esm",
+    platform: "node",
+    sourcemap: "inline",
+    target: "es2020",
+    write: false
+  });
+  const output = result.outputFiles[0];
+  const code = output?.text ?? "";
+  const dataUrl = `data:text/javascript;base64,${Buffer.from(code).toString(
+    "base64"
+  )}`;
+  return import(`${dataUrl}#${cacheBust}`);
+}
+async function loadModule(file, logger) {
   const ext = extname(file).toLowerCase();
   if (ext === ".cjs") {
     const require = createRequire(import.meta.url);
@@ -846,21 +1000,7 @@ async function loadModule(file) {
     return import(`${pathToFileURL(file).href}?t=${Date.now()}`);
   }
   if (ext === ".ts") {
-    const result = await build({
-      entryPoints: [file],
-      bundle: true,
-      format: "esm",
-      platform: "node",
-      sourcemap: "inline",
-      target: "es2020",
-      write: false
-    });
-    const output = result.outputFiles[0];
-    const code = output?.text ?? "";
-    const dataUrl = `data:text/javascript;base64,${Buffer.from(code).toString(
-      "base64"
-    )}`;
-    return import(`${dataUrl}#${Date.now()}`);
+    return loadTsModule(file, logger);
   }
   return null;
 }
@@ -895,7 +1035,7 @@ async function loadRules(file, logger) {
       }
     ];
   }
-  const mod = await loadModule(file);
+  const mod = await loadModule(file, logger);
   const value = mod?.default ?? mod;
   if (!value) {
     return [];
@@ -942,6 +1082,14 @@ function resolveSkipRoute(params) {
     url: resolved.template
   };
 }
+function buildSkipInfo(file, reason, resolved) {
+  const info = { file, reason };
+  if (resolved) {
+    info.method = resolved.method;
+    info.url = resolved.url;
+  }
+  return info;
+}
 async function scanRoutes(params) {
   const routes = [];
   const seen = /* @__PURE__ */ new Set();
@@ -950,7 +1098,22 @@ async function scanRoutes(params) {
   const configCache = /* @__PURE__ */ new Map();
   const fileCache = /* @__PURE__ */ new Map();
   const shouldCollectSkip = typeof params.onSkip === "function";
+  const shouldCollectIgnore = typeof params.onIgnore === "function";
+  const shouldCollectConfig = typeof params.onConfig === "function";
   for (const fileInfo of files) {
+    if (isConfigFile(fileInfo.file)) {
+      if (shouldCollectConfig) {
+        const config2 = await resolveDirectoryConfig({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          logger: params.logger,
+          configCache,
+          fileCache
+        });
+        params.onConfig?.({ file: fileInfo.file, enabled: config2.enabled !== false });
+      }
+      continue;
+    }
     const config = await resolveDirectoryConfig({
       file: fileInfo.file,
       rootDir: fileInfo.rootDir,
@@ -965,12 +1128,7 @@ async function scanRoutes(params) {
           rootDir: fileInfo.rootDir,
           prefix: params.prefix
         });
-        params.onSkip?.({
-          file: fileInfo.file,
-          reason: "disabled-dir",
-          method: resolved?.method,
-          url: resolved?.url
-        });
+        params.onSkip?.(buildSkipInfo(fileInfo.file, "disabled-dir", resolved));
       }
       continue;
     }
@@ -982,16 +1140,14 @@ async function scanRoutes(params) {
           rootDir: fileInfo.rootDir,
           prefix: params.prefix
         });
-        params.onSkip?.({
-          file: fileInfo.file,
-          reason: "ignore-prefix",
-          method: resolved?.method,
-          url: resolved?.url
-        });
+        params.onSkip?.(buildSkipInfo(fileInfo.file, "ignore-prefix", resolved));
       }
       continue;
     }
     if (!isSupportedFile(fileInfo.file)) {
+      if (shouldCollectIgnore) {
+        params.onIgnore?.({ file: fileInfo.file, reason: "unsupported" });
+      }
       continue;
     }
     const effectiveInclude = typeof config.include !== "undefined" ? config.include : params.include;
@@ -1004,17 +1160,15 @@ async function scanRoutes(params) {
           prefix: params.prefix
         });
         const reason = effectiveExclude && matchesFilter(fileInfo.file, void 0, effectiveExclude) ? "exclude" : "include";
-        params.onSkip?.({
-          file: fileInfo.file,
-          reason,
-          method: resolved?.method,
-          url: resolved?.url
-        });
+        params.onSkip?.(buildSkipInfo(fileInfo.file, reason, resolved));
       }
       continue;
     }
     const derived = deriveRouteFromFile(fileInfo.file, fileInfo.rootDir, params.logger);
     if (!derived) {
+      if (shouldCollectIgnore) {
+        params.onIgnore?.({ file: fileInfo.file, reason: "invalid-route" });
+      }
       continue;
     }
     const rules = await loadRules(fileInfo.file, params.logger);
@@ -1030,12 +1184,7 @@ async function scanRoutes(params) {
             prefix: params.prefix,
             derived
           });
-          params.onSkip?.({
-            file: fileInfo.file,
-            reason: "disabled",
-            method: resolved2?.method,
-            url: resolved2?.url
-          });
+          params.onSkip?.(buildSkipInfo(fileInfo.file, "disabled", resolved2));
         }
         continue;
       }
@@ -1140,6 +1289,9 @@ function buildApp(params) {
     app,
     routes: params.routes,
     disabledRoutes: params.disabledRoutes,
+    ignoredRoutes: params.ignoredRoutes,
+    configFiles: params.configFiles,
+    disabledConfigFiles: params.disabledConfigFiles,
     dirs: params.dirs,
     logger: params.logger,
     config: params.playground,
@@ -1149,7 +1301,8 @@ function buildApp(params) {
     app.get(`${params.playground.path}/ws`, params.wsHandler);
   }
   if (params.routes.length > 0) {
-    const mockApp = createHonoApp(params.routes, { onResponse: params.onResponse });
+    const mockAppOptions = params.onResponse ? { onResponse: params.onResponse } : {};
+    const mockApp = createHonoApp(params.routes, mockAppOptions);
     app.route("/", mockApp);
   }
   return app;
@@ -1304,26 +1457,36 @@ async function createFetchServer(options = {}) {
   }
   let routes = [];
   let disabledRoutes = [];
+  let ignoredRoutes = [];
+  let configFiles = [];
+  let disabledConfigFiles = [];
   let app = buildApp({
     routes,
     disabledRoutes,
+    ignoredRoutes,
+    configFiles,
+    disabledConfigFiles,
     dirs,
     playground: playgroundConfig,
     root,
     logger,
     onResponse: handleRouteResponse,
-    wsHandler
+    ...wsHandler ? { wsHandler } : {}
   });
   const refreshRoutes = async () => {
     try {
       const collected = [];
       const collectedDisabled = [];
+      const collectedIgnored = [];
+      const collectedConfigs = [];
       for (const entry of optionList) {
         const scanParams = {
           dirs: resolveDirs(entry.dir, root),
           prefix: entry.prefix ?? "",
           logger,
-          onSkip: (info) => collectedDisabled.push(info)
+          onSkip: (info) => collectedDisabled.push(info),
+          onIgnore: (info) => collectedIgnored.push(info),
+          onConfig: (info) => collectedConfigs.push(info)
         };
         if (entry.include) {
           scanParams.include = entry.include;
@@ -1340,15 +1503,23 @@ async function createFetchServer(options = {}) {
       const resolvedRoutes = sortRoutes(collected);
       routes = resolvedRoutes;
       disabledRoutes = collectedDisabled;
+      ignoredRoutes = collectedIgnored;
+      const configMap = new Map(collectedConfigs.map((entry) => [entry.file, entry]));
+      const resolvedConfigs = Array.from(configMap.values());
+      configFiles = resolvedConfigs.filter((entry) => entry.enabled);
+      disabledConfigFiles = resolvedConfigs.filter((entry) => !entry.enabled);
       app = buildApp({
         routes,
         disabledRoutes,
+        ignoredRoutes,
+        configFiles,
+        disabledConfigFiles,
         dirs,
         playground: playgroundConfig,
         root,
         logger,
         onResponse: handleRouteResponse,
-        wsHandler
+        ...wsHandler ? { wsHandler } : {}
       });
       logger.info(`Loaded ${routes.length} mock routes.`);
     } catch (error) {
@@ -1374,7 +1545,7 @@ async function createFetchServer(options = {}) {
     fetch,
     refresh: refreshRoutes,
     getRoutes: () => routes,
-    injectWebSocket
+    ...injectWebSocket ? { injectWebSocket } : {}
   };
   if (watcher) {
     server.close = async () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mokup/server",
   "type": "module",
-  "version": "1.0.4",
+  "version": "1.1.1",
   "description": "Server adapters for @mokup/runtime.",
   "license": "MIT",
   "homepage": "https://mokup.icebreaker.top",
@@ -39,8 +39,9 @@
   "dependencies": {
     "@hono/node-server": "^1.19.9",
     "@hono/node-ws": "^1.1.1",
-    "@mokup/playground": "0.0.8",
-    "@mokup/runtime": "1.0.0",
+    "tsx": "^4.21.0",
+    "@mokup/playground": "0.0.10",
+    "@mokup/runtime": "1.0.1",
     "@mokup/shared": "1.0.0"
   },
   "devDependencies": {