@mokup/server 1.0.3 → 1.1.0

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";
@@ -141,6 +145,20 @@ function matchesFilter(file, include, exclude) {
   }
   return true;
 }
+function normalizeIgnorePrefix(value, fallback = ["."]) {
+  const list = typeof value === "undefined" ? fallback : Array.isArray(value) ? value : [value];
+  return list.filter((entry) => typeof entry === "string" && entry.length > 0);
+}
+function hasIgnoredPrefix(file, rootDir, prefixes) {
+  if (prefixes.length === 0) {
+    return false;
+  }
+  const relativePath = toPosix(pathe.relative(rootDir, file));
+  const segments = relativePath.split("/");
+  return segments.some(
+    (segment) => prefixes.some((prefix) => segment.startsWith(prefix))
+  );
+}
 function delay(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
@@ -344,7 +362,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);
@@ -368,10 +386,24 @@ function resolveGroupRoot(dirs, serverRoot) {
     }
   }
   if (!common || common === "/") {
-    return serverRoot ?? node_process.cwd();
+    return serverRoot ?? process.cwd();
   }
   return common;
 }
+const disabledReasonSet = /* @__PURE__ */ new Set([
+  "disabled",
+  "disabled-dir",
+  "exclude",
+  "ignore-prefix",
+  "include",
+  "unknown"
+]);
+function normalizeDisabledReason(reason) {
+  if (reason && disabledReasonSet.has(reason)) {
+    return reason;
+  }
+  return "unknown";
+}
 function formatRouteFile(file, root) {
   if (!root) {
     return toPosixPath(file);
@@ -432,6 +464,24 @@ function toPlaygroundRoute(route, root, groups) {
     group: matchedGroup?.label
   };
 }
+function toPlaygroundDisabledRoute(route, root, groups) {
+  const matchedGroup = resolveRouteGroup(route.file, groups);
+  const disabled = {
+    file: formatRouteFile(route.file, root),
+    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 registerPlaygroundRoutes(params) {
   if (!params.config.enabled) {
     return;
@@ -469,7 +519,8 @@ function registerPlaygroundRoutes(params) {
       root: baseRoot,
       count: params.routes.length,
       groups: groups.map((group) => ({ key: group.key, label: group.label })),
-      routes: params.routes.map((route) => toPlaygroundRoute(route, baseRoot, groups))
+      routes: params.routes.map((route) => toPlaygroundRoute(route, baseRoot, groups)),
+      disabled: (params.disabledRoutes ?? []).map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups))
     });
   });
   params.app.get(`${playgroundPath}/*`, async (c) => {
@@ -615,8 +666,79 @@ function sortRoutes(routes) {
   });
 }
 
+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;
+}
+
 const configExtensions = [".ts", ".js", ".mjs", ".cjs"];
-async function loadModule$1(file) {
+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)));
@@ -627,21 +749,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;
 }
@@ -665,8 +773,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;
   }
@@ -717,7 +825,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) {
@@ -736,6 +844,15 @@ async function resolveDirectoryConfig(params) {
     if (typeof config.enabled === "boolean") {
       merged.enabled = config.enabled;
     }
+    if (typeof config.ignorePrefix !== "undefined") {
+      merged.ignorePrefix = config.ignorePrefix;
+    }
+    if (typeof config.include !== "undefined") {
+      merged.include = config.include;
+    }
+    if (typeof config.exclude !== "undefined") {
+      merged.exclude = config.exclude;
+    }
     const normalized = normalizeMiddlewares(config.middleware, configPath, logger);
     if (normalized.length > 0) {
       merged.middlewares.push(...normalized);
@@ -789,7 +906,47 @@ function isSupportedFile(file) {
   return supportedExtensions.has(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)));
@@ -800,21 +957,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;
 }
@@ -849,7 +992,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 [];
@@ -867,19 +1010,52 @@ async function loadRules(file, logger) {
   return [value];
 }
 
+const silentLogger = {
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  }
+};
+function resolveSkipRoute(params) {
+  const derived = params.derived ?? deriveRouteFromFile(params.file, params.rootDir, silentLogger);
+  if (!derived?.method) {
+    return null;
+  }
+  const resolved = resolveRule({
+    rule: { handler: null },
+    derivedTemplate: derived.template,
+    derivedMethod: derived.method,
+    prefix: params.prefix,
+    file: params.file,
+    logger: silentLogger
+  });
+  if (!resolved) {
+    return null;
+  }
+  return {
+    method: resolved.method,
+    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();
   const files = await collectFiles(params.dirs);
+  const globalIgnorePrefix = normalizeIgnorePrefix(params.ignorePrefix);
   const configCache = /* @__PURE__ */ new Map();
   const fileCache = /* @__PURE__ */ new Map();
+  const shouldCollectSkip = typeof params.onSkip === "function";
   for (const fileInfo of files) {
-    if (!isSupportedFile(fileInfo.file)) {
-      continue;
-    }
-    if (!matchesFilter(fileInfo.file, params.include, params.exclude)) {
-      continue;
-    }
     const config = await resolveDirectoryConfig({
       file: fileInfo.file,
       rootDir: fileInfo.rootDir,
@@ -888,6 +1064,43 @@ async function scanRoutes(params) {
       fileCache
     });
     if (config.enabled === false) {
+      if (shouldCollectSkip && isSupportedFile(fileInfo.file)) {
+        const resolved = resolveSkipRoute({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          prefix: params.prefix
+        });
+        params.onSkip?.(buildSkipInfo(fileInfo.file, "disabled-dir", resolved));
+      }
+      continue;
+    }
+    const effectiveIgnorePrefix = typeof config.ignorePrefix !== "undefined" ? normalizeIgnorePrefix(config.ignorePrefix, []) : globalIgnorePrefix;
+    if (hasIgnoredPrefix(fileInfo.file, fileInfo.rootDir, effectiveIgnorePrefix)) {
+      if (shouldCollectSkip && isSupportedFile(fileInfo.file)) {
+        const resolved = resolveSkipRoute({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          prefix: params.prefix
+        });
+        params.onSkip?.(buildSkipInfo(fileInfo.file, "ignore-prefix", resolved));
+      }
+      continue;
+    }
+    if (!isSupportedFile(fileInfo.file)) {
+      continue;
+    }
+    const effectiveInclude = typeof config.include !== "undefined" ? config.include : params.include;
+    const effectiveExclude = typeof config.exclude !== "undefined" ? config.exclude : params.exclude;
+    if (!matchesFilter(fileInfo.file, effectiveInclude, effectiveExclude)) {
+      if (shouldCollectSkip) {
+        const resolved = resolveSkipRoute({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          prefix: params.prefix
+        });
+        const reason = effectiveExclude && matchesFilter(fileInfo.file, void 0, effectiveExclude) ? "exclude" : "include";
+        params.onSkip?.(buildSkipInfo(fileInfo.file, reason, resolved));
+      }
       continue;
     }
     const derived = deriveRouteFromFile(fileInfo.file, fileInfo.rootDir, params.logger);
@@ -899,6 +1112,18 @@ async function scanRoutes(params) {
       if (!rule || typeof rule !== "object") {
         continue;
       }
+      if (rule.enabled === false) {
+        if (shouldCollectSkip) {
+          const resolved2 = resolveSkipRoute({
+            file: fileInfo.file,
+            rootDir: fileInfo.rootDir,
+            prefix: params.prefix,
+            derived
+          });
+          params.onSkip?.(buildSkipInfo(fileInfo.file, "disabled", resolved2));
+        }
+        continue;
+      }
       const ruleValue = rule;
       const unsupportedKeys = ["response", "url", "method"].filter(
         (key2) => key2 in ruleValue
@@ -978,7 +1203,7 @@ function resolveRoot(list) {
   if (deno?.cwd) {
     return deno.cwd();
   }
-  return node_process.cwd();
+  return process.cwd();
 }
 function resolveAllDirs(list, root) {
   const dirs = [];
@@ -999,6 +1224,7 @@ function buildApp(params) {
   registerPlaygroundRoutes({
     app,
     routes: params.routes,
+    disabledRoutes: params.disabledRoutes,
     dirs: params.dirs,
     logger: params.logger,
     config: params.playground,
@@ -1008,7 +1234,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;
@@ -1162,23 +1389,27 @@ async function createFetchServer(options = {}) {
     }
   }
   let routes = [];
+  let disabledRoutes = [];
   let app = buildApp({
     routes,
+    disabledRoutes,
     dirs,
     playground: playgroundConfig,
     root,
     logger,
     onResponse: handleRouteResponse,
-    wsHandler
+    ...wsHandler ? { wsHandler } : {}
   });
   const refreshRoutes = async () => {
     try {
       const collected = [];
+      const collectedDisabled = [];
       for (const entry of optionList) {
         const scanParams = {
           dirs: resolveDirs(entry.dir, root),
           prefix: entry.prefix ?? "",
-          logger
+          logger,
+          onSkip: (info) => collectedDisabled.push(info)
         };
         if (entry.include) {
           scanParams.include = entry.include;
@@ -1186,19 +1417,24 @@ async function createFetchServer(options = {}) {
         if (entry.exclude) {
           scanParams.exclude = entry.exclude;
         }
+        if (typeof entry.ignorePrefix !== "undefined") {
+          scanParams.ignorePrefix = entry.ignorePrefix;
+        }
         const scanned = await scanRoutes(scanParams);
         collected.push(...scanned);
       }
       const resolvedRoutes = sortRoutes(collected);
       routes = resolvedRoutes;
+      disabledRoutes = collectedDisabled;
       app = buildApp({
         routes,
+        disabledRoutes,
         dirs,
         playground: playgroundConfig,
         root,
         logger,
         onResponse: handleRouteResponse,
-        wsHandler
+        ...wsHandler ? { wsHandler } : {}
       });
       logger.info(`Loaded ${routes.length} mock routes.`);
     } catch (error) {
@@ -1224,7 +1460,7 @@ async function createFetchServer(options = {}) {
     fetch,
     refresh: refreshRoutes,
     getRoutes: () => routes,
-    injectWebSocket
+    ...injectWebSocket ? { injectWebSocket } : {}
   };
   if (watcher) {
     server.close = async () => {

package/dist/index.d.cts

@@ -70,6 +70,7 @@ interface FetchServerOptions {
     prefix?: string;
     include?: RegExp | RegExp[];
     exclude?: RegExp | RegExp[];
+    ignorePrefix?: string | string[];
     watch?: boolean;
     log?: boolean;
     playground?: boolean | {

package/dist/index.d.mts

@@ -70,6 +70,7 @@ interface FetchServerOptions {
     prefix?: string;
     include?: RegExp | RegExp[];
     exclude?: RegExp | RegExp[];
+    ignorePrefix?: string | string[];
     watch?: boolean;
     log?: boolean;
     playground?: boolean | {

package/dist/index.d.ts

@@ -70,6 +70,7 @@ interface FetchServerOptions {
     prefix?: string;
     include?: RegExp | RegExp[];
     exclude?: RegExp | RegExp[];
+    ignorePrefix?: string | string[];
     watch?: boolean;
     log?: boolean;
     playground?: boolean | {

package/dist/index.mjs

@@ -1,8 +1,8 @@
 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, join, normalize, extname, dirname, relative, basename } from '@mokup/shared/pathe';
+import { resolve, isAbsolute, relative, join, normalize, extname, dirname, basename } from '@mokup/shared/pathe';
 import { promises } from 'node:fs';
 import { createRequire } from 'node:module';
 import { Buffer } from 'node:buffer';
@@ -138,6 +138,20 @@ function matchesFilter(file, include, exclude) {
   }
   return true;
 }
+function normalizeIgnorePrefix(value, fallback = ["."]) {
+  const list = typeof value === "undefined" ? fallback : Array.isArray(value) ? value : [value];
+  return list.filter((entry) => typeof entry === "string" && entry.length > 0);
+}
+function hasIgnoredPrefix(file, rootDir, prefixes) {
+  if (prefixes.length === 0) {
+    return false;
+  }
+  const relativePath = toPosix(relative(rootDir, file));
+  const segments = relativePath.split("/");
+  return segments.some(
+    (segment) => prefixes.some((prefix) => segment.startsWith(prefix))
+  );
+}
 function delay(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
@@ -369,6 +383,20 @@ function resolveGroupRoot(dirs, serverRoot) {
   }
   return common;
 }
+const disabledReasonSet = /* @__PURE__ */ new Set([
+  "disabled",
+  "disabled-dir",
+  "exclude",
+  "ignore-prefix",
+  "include",
+  "unknown"
+]);
+function normalizeDisabledReason(reason) {
+  if (reason && disabledReasonSet.has(reason)) {
+    return reason;
+  }
+  return "unknown";
+}
 function formatRouteFile(file, root) {
   if (!root) {
     return toPosixPath(file);
@@ -429,6 +457,24 @@ function toPlaygroundRoute(route, root, groups) {
     group: matchedGroup?.label
   };
 }
+function toPlaygroundDisabledRoute(route, root, groups) {
+  const matchedGroup = resolveRouteGroup(route.file, groups);
+  const disabled = {
+    file: formatRouteFile(route.file, root),
+    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 registerPlaygroundRoutes(params) {
   if (!params.config.enabled) {
     return;
@@ -466,7 +512,8 @@ function registerPlaygroundRoutes(params) {
       root: baseRoot,
       count: params.routes.length,
       groups: groups.map((group) => ({ key: group.key, label: group.label })),
-      routes: params.routes.map((route) => toPlaygroundRoute(route, baseRoot, groups))
+      routes: params.routes.map((route) => toPlaygroundRoute(route, baseRoot, groups)),
+      disabled: (params.disabledRoutes ?? []).map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups))
     });
   });
   params.app.get(`${playgroundPath}/*`, async (c) => {
@@ -612,8 +659,79 @@ function sortRoutes(routes) {
   });
 }
 
+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;
+}
+
 const configExtensions = [".ts", ".js", ".mjs", ".cjs"];
-async function loadModule$1(file) {
+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);
@@ -624,21 +742,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;
 }
@@ -662,8 +766,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;
   }
@@ -714,7 +818,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) {
@@ -733,6 +837,15 @@ async function resolveDirectoryConfig(params) {
     if (typeof config.enabled === "boolean") {
       merged.enabled = config.enabled;
     }
+    if (typeof config.ignorePrefix !== "undefined") {
+      merged.ignorePrefix = config.ignorePrefix;
+    }
+    if (typeof config.include !== "undefined") {
+      merged.include = config.include;
+    }
+    if (typeof config.exclude !== "undefined") {
+      merged.exclude = config.exclude;
+    }
     const normalized = normalizeMiddlewares(config.middleware, configPath, logger);
     if (normalized.length > 0) {
       merged.middlewares.push(...normalized);
@@ -786,7 +899,47 @@ function isSupportedFile(file) {
   return supportedExtensions.has(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);
@@ -797,21 +950,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;
 }
@@ -846,7 +985,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 [];
@@ -864,19 +1003,52 @@ async function loadRules(file, logger) {
   return [value];
 }
 
+const silentLogger = {
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  }
+};
+function resolveSkipRoute(params) {
+  const derived = params.derived ?? deriveRouteFromFile(params.file, params.rootDir, silentLogger);
+  if (!derived?.method) {
+    return null;
+  }
+  const resolved = resolveRule({
+    rule: { handler: null },
+    derivedTemplate: derived.template,
+    derivedMethod: derived.method,
+    prefix: params.prefix,
+    file: params.file,
+    logger: silentLogger
+  });
+  if (!resolved) {
+    return null;
+  }
+  return {
+    method: resolved.method,
+    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();
   const files = await collectFiles(params.dirs);
+  const globalIgnorePrefix = normalizeIgnorePrefix(params.ignorePrefix);
   const configCache = /* @__PURE__ */ new Map();
   const fileCache = /* @__PURE__ */ new Map();
+  const shouldCollectSkip = typeof params.onSkip === "function";
   for (const fileInfo of files) {
-    if (!isSupportedFile(fileInfo.file)) {
-      continue;
-    }
-    if (!matchesFilter(fileInfo.file, params.include, params.exclude)) {
-      continue;
-    }
     const config = await resolveDirectoryConfig({
       file: fileInfo.file,
       rootDir: fileInfo.rootDir,
@@ -885,6 +1057,43 @@ async function scanRoutes(params) {
       fileCache
     });
     if (config.enabled === false) {
+      if (shouldCollectSkip && isSupportedFile(fileInfo.file)) {
+        const resolved = resolveSkipRoute({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          prefix: params.prefix
+        });
+        params.onSkip?.(buildSkipInfo(fileInfo.file, "disabled-dir", resolved));
+      }
+      continue;
+    }
+    const effectiveIgnorePrefix = typeof config.ignorePrefix !== "undefined" ? normalizeIgnorePrefix(config.ignorePrefix, []) : globalIgnorePrefix;
+    if (hasIgnoredPrefix(fileInfo.file, fileInfo.rootDir, effectiveIgnorePrefix)) {
+      if (shouldCollectSkip && isSupportedFile(fileInfo.file)) {
+        const resolved = resolveSkipRoute({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          prefix: params.prefix
+        });
+        params.onSkip?.(buildSkipInfo(fileInfo.file, "ignore-prefix", resolved));
+      }
+      continue;
+    }
+    if (!isSupportedFile(fileInfo.file)) {
+      continue;
+    }
+    const effectiveInclude = typeof config.include !== "undefined" ? config.include : params.include;
+    const effectiveExclude = typeof config.exclude !== "undefined" ? config.exclude : params.exclude;
+    if (!matchesFilter(fileInfo.file, effectiveInclude, effectiveExclude)) {
+      if (shouldCollectSkip) {
+        const resolved = resolveSkipRoute({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          prefix: params.prefix
+        });
+        const reason = effectiveExclude && matchesFilter(fileInfo.file, void 0, effectiveExclude) ? "exclude" : "include";
+        params.onSkip?.(buildSkipInfo(fileInfo.file, reason, resolved));
+      }
       continue;
     }
     const derived = deriveRouteFromFile(fileInfo.file, fileInfo.rootDir, params.logger);
@@ -896,6 +1105,18 @@ async function scanRoutes(params) {
       if (!rule || typeof rule !== "object") {
         continue;
       }
+      if (rule.enabled === false) {
+        if (shouldCollectSkip) {
+          const resolved2 = resolveSkipRoute({
+            file: fileInfo.file,
+            rootDir: fileInfo.rootDir,
+            prefix: params.prefix,
+            derived
+          });
+          params.onSkip?.(buildSkipInfo(fileInfo.file, "disabled", resolved2));
+        }
+        continue;
+      }
       const ruleValue = rule;
       const unsupportedKeys = ["response", "url", "method"].filter(
         (key2) => key2 in ruleValue
@@ -996,6 +1217,7 @@ function buildApp(params) {
   registerPlaygroundRoutes({
     app,
     routes: params.routes,
+    disabledRoutes: params.disabledRoutes,
     dirs: params.dirs,
     logger: params.logger,
     config: params.playground,
@@ -1005,7 +1227,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;
@@ -1159,23 +1382,27 @@ async function createFetchServer(options = {}) {
     }
   }
   let routes = [];
+  let disabledRoutes = [];
   let app = buildApp({
     routes,
+    disabledRoutes,
     dirs,
     playground: playgroundConfig,
     root,
     logger,
     onResponse: handleRouteResponse,
-    wsHandler
+    ...wsHandler ? { wsHandler } : {}
   });
   const refreshRoutes = async () => {
     try {
       const collected = [];
+      const collectedDisabled = [];
       for (const entry of optionList) {
         const scanParams = {
           dirs: resolveDirs(entry.dir, root),
           prefix: entry.prefix ?? "",
-          logger
+          logger,
+          onSkip: (info) => collectedDisabled.push(info)
         };
         if (entry.include) {
           scanParams.include = entry.include;
@@ -1183,19 +1410,24 @@ async function createFetchServer(options = {}) {
         if (entry.exclude) {
           scanParams.exclude = entry.exclude;
         }
+        if (typeof entry.ignorePrefix !== "undefined") {
+          scanParams.ignorePrefix = entry.ignorePrefix;
+        }
         const scanned = await scanRoutes(scanParams);
         collected.push(...scanned);
       }
       const resolvedRoutes = sortRoutes(collected);
       routes = resolvedRoutes;
+      disabledRoutes = collectedDisabled;
       app = buildApp({
         routes,
+        disabledRoutes,
         dirs,
         playground: playgroundConfig,
         root,
         logger,
         onResponse: handleRouteResponse,
-        wsHandler
+        ...wsHandler ? { wsHandler } : {}
       });
       logger.info(`Loaded ${routes.length} mock routes.`);
     } catch (error) {
@@ -1221,7 +1453,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.3",
+  "version": "1.1.0",
   "description": "Server adapters for @mokup/runtime.",
   "license": "MIT",
   "homepage": "https://mokup.icebreaker.top",
@@ -39,12 +39,13 @@
   "dependencies": {
     "@hono/node-server": "^1.19.9",
     "@hono/node-ws": "^1.1.1",
+    "tsx": "^4.21.0",
+    "@mokup/playground": "0.0.9",
     "@mokup/runtime": "1.0.0",
-    "@mokup/playground": "0.0.7",
     "@mokup/shared": "1.0.0"
   },
   "devDependencies": {
-    "@types/node": "^25.0.9",
+    "@types/node": "^25.0.10",
     "typescript": "^5.9.3",
     "unbuild": "^3.6.1"
   },