@mokup/server 1.0.2 → 1.0.4

package/dist/index.cjs

@@ -141,6 +141,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));
 }
@@ -233,7 +247,7 @@ function createRouteHandler(route) {
     return normalizeHandlerValue(c, value);
   };
 }
-function createFinalizeMiddleware(route) {
+function createFinalizeMiddleware(route, onResponse) {
   return async (c, next) => {
     const response = await next();
     const resolved = resolveResponse(response, c.res);
@@ -242,6 +256,15 @@ function createFinalizeMiddleware(route) {
     }
     const overridden = applyRouteOverrides(resolved, route);
     c.res = overridden;
+    if (onResponse) {
+      try {
+        const result = onResponse(route, overridden);
+        if (result instanceof Promise) {
+          result.catch(() => void 0);
+        }
+      } catch {
+      }
+    }
     return overridden;
   };
 }
@@ -251,14 +274,14 @@ function wrapMiddleware(handler) {
     return resolveResponse(response, c.res);
   };
 }
-function createHonoApp(routes) {
+function createHonoApp(routes, options = {}) {
   const app = new hono.Hono({ router: new hono.PatternRouter(), strict: false });
   for (const route of routes) {
     const middlewares = route.middlewares?.map((entry) => wrapMiddleware(entry.handle)) ?? [];
     app.on(
       route.method,
       toHonoPath(route),
-      createFinalizeMiddleware(route),
+      createFinalizeMiddleware(route, options.onResponse),
       ...middlewares,
       createRouteHandler(route)
     );
@@ -363,6 +386,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);
@@ -423,6 +460,17 @@ function toPlaygroundRoute(route, root, groups) {
     group: matchedGroup?.label
   };
 }
+function toPlaygroundDisabledRoute(route, root, groups) {
+  const matchedGroup = resolveRouteGroup(route.file, groups);
+  return {
+    file: formatRouteFile(route.file, root),
+    reason: normalizeDisabledReason(route.reason),
+    method: route.method,
+    url: route.url,
+    groupKey: matchedGroup?.key,
+    group: matchedGroup?.label
+  };
+}
 function registerPlaygroundRoutes(params) {
   if (!params.config.enabled) {
     return;
@@ -440,7 +488,16 @@ function registerPlaygroundRoutes(params) {
       return new Response("Playground is not available.", { status: 500 });
     }
   };
-  params.app.get(playgroundPath, (c) => c.redirect(`${playgroundPath}/`));
+  params.app.get(playgroundPath, (c) => {
+    try {
+      const pathname = new URL(c.req.raw.url, "http://localhost").pathname;
+      if (pathname.endsWith("/")) {
+        return serveIndex();
+      }
+    } catch {
+    }
+    return c.redirect(`${playgroundPath}/`);
+  });
   params.app.get(`${playgroundPath}/`, () => serveIndex());
   params.app.get(`${playgroundPath}/index.html`, () => serveIndex());
   params.app.get(`${playgroundPath}/routes`, (c) => {
@@ -451,7 +508,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) => {
@@ -718,6 +776,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);
@@ -849,19 +916,44 @@ 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
+  };
+}
 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,
@@ -870,6 +962,58 @@ 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?.({
+          file: fileInfo.file,
+          reason: "disabled-dir",
+          method: resolved?.method,
+          url: resolved?.url
+        });
+      }
+      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?.({
+          file: fileInfo.file,
+          reason: "ignore-prefix",
+          method: resolved?.method,
+          url: resolved?.url
+        });
+      }
+      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?.({
+          file: fileInfo.file,
+          reason,
+          method: resolved?.method,
+          url: resolved?.url
+        });
+      }
       continue;
     }
     const derived = deriveRouteFromFile(fileInfo.file, fileInfo.rootDir, params.logger);
@@ -881,6 +1025,23 @@ 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?.({
+            file: fileInfo.file,
+            reason: "disabled",
+            method: resolved2?.method,
+            url: resolved2?.url
+          });
+        }
+        continue;
+      }
       const ruleValue = rule;
       const unsupportedKeys = ["response", "url", "method"].filter(
         (key2) => key2 in ruleValue
@@ -981,13 +1142,17 @@ function buildApp(params) {
   registerPlaygroundRoutes({
     app,
     routes: params.routes,
+    disabledRoutes: params.disabledRoutes,
     dirs: params.dirs,
     logger: params.logger,
     config: params.playground,
     root: params.root
   });
+  if (params.wsHandler && params.playground.enabled) {
+    app.get(`${params.playground.path}/ws`, params.wsHandler);
+  }
   if (params.routes.length > 0) {
-    const mockApp = createHonoApp(params.routes);
+    const mockApp = createHonoApp(params.routes, { onResponse: params.onResponse });
     app.route("/", mockApp);
   }
   return app;
@@ -1074,22 +1239,94 @@ async function createFetchServer(options = {}) {
   const logger = createLogger(logEnabled);
   const playgroundConfig = resolvePlaygroundOptions(resolvePlaygroundInput(optionList));
   const dirs = resolveAllDirs(optionList, root);
+  const routeCounts = {};
+  const wsClients = /* @__PURE__ */ new Set();
+  let totalCount = 0;
+  let wsHandler;
+  let injectWebSocket;
+  function getRouteKey(route) {
+    return `${route.method} ${route.template}`;
+  }
+  function buildSnapshot() {
+    return {
+      type: "snapshot",
+      total: totalCount,
+      perRoute: { ...routeCounts }
+    };
+  }
+  function broadcast(payload) {
+    if (wsClients.size === 0) {
+      return;
+    }
+    const message = JSON.stringify(payload);
+    for (const client of wsClients) {
+      try {
+        client.send(message);
+      } catch {
+        wsClients.delete(client);
+      }
+    }
+  }
+  function registerWsClient(client) {
+    wsClients.add(client);
+    try {
+      client.send(JSON.stringify(buildSnapshot()));
+    } catch {
+      wsClients.delete(client);
+    }
+  }
+  function handleRouteResponse(route) {
+    const routeKey = getRouteKey(route);
+    routeCounts[routeKey] = (routeCounts[routeKey] ?? 0) + 1;
+    totalCount += 1;
+    broadcast({ type: "increment", routeKey, total: totalCount });
+  }
+  async function setupPlaygroundWebSocket(app2) {
+    if (!playgroundConfig.enabled) {
+      return;
+    }
+    try {
+      const mod = await import('@hono/node-ws');
+      const { createNodeWebSocket } = mod;
+      const { upgradeWebSocket, injectWebSocket: inject } = createNodeWebSocket({ app: app2 });
+      wsHandler = upgradeWebSocket(() => ({
+        onOpen: (_event, ws) => {
+          registerWsClient(ws);
+        },
+        onClose: (_event, ws) => {
+          wsClients.delete(ws);
+        },
+        onMessage: () => {
+        }
+      }));
+      injectWebSocket = (server2) => {
+        inject(server2);
+      };
+    } catch {
+    }
+  }
   let routes = [];
+  let disabledRoutes = [];
   let app = buildApp({
     routes,
+    disabledRoutes,
     dirs,
     playground: playgroundConfig,
     root,
-    logger
+    logger,
+    onResponse: handleRouteResponse,
+    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;
@@ -1097,17 +1334,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
+        logger,
+        onResponse: handleRouteResponse,
+        wsHandler
       });
       logger.info(`Loaded ${routes.length} mock routes.`);
     } catch (error) {
@@ -1115,6 +1359,10 @@ async function createFetchServer(options = {}) {
     }
   };
   await refreshRoutes();
+  await setupPlaygroundWebSocket(app);
+  if (wsHandler && playgroundConfig.enabled) {
+    app.get(`${playgroundConfig.path}/ws`, wsHandler);
+  }
   const scheduleRefresh = createDebouncer(80, () => {
     void refreshRoutes();
   });
@@ -1128,7 +1376,8 @@ async function createFetchServer(options = {}) {
   const server = {
     fetch,
     refresh: refreshRoutes,
-    getRoutes: () => routes
+    getRoutes: () => routes,
+    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 | {
@@ -86,8 +87,12 @@ interface FetchServer {
     fetch: (request: Request) => Promise<Response>;
     refresh: () => Promise<void>;
     getRoutes: () => RouteTable;
+    injectWebSocket?: (server: NodeWebSocketServer) => void;
     close?: () => Promise<void>;
 }
+interface NodeWebSocketServer {
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+}
 declare function createFetchServer(options?: FetchServerOptionsInput): Promise<FetchServer>;
 
 interface HonoContextLike {

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 | {
@@ -86,8 +87,12 @@ interface FetchServer {
     fetch: (request: Request) => Promise<Response>;
     refresh: () => Promise<void>;
     getRoutes: () => RouteTable;
+    injectWebSocket?: (server: NodeWebSocketServer) => void;
     close?: () => Promise<void>;
 }
+interface NodeWebSocketServer {
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+}
 declare function createFetchServer(options?: FetchServerOptionsInput): Promise<FetchServer>;
 
 interface HonoContextLike {

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 | {
@@ -86,8 +87,12 @@ interface FetchServer {
     fetch: (request: Request) => Promise<Response>;
     refresh: () => Promise<void>;
     getRoutes: () => RouteTable;
+    injectWebSocket?: (server: NodeWebSocketServer) => void;
     close?: () => Promise<void>;
 }
+interface NodeWebSocketServer {
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+}
 declare function createFetchServer(options?: FetchServerOptionsInput): Promise<FetchServer>;
 
 interface HonoContextLike {

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, c as toBinaryBody, d as createFetchHandler } from './shared/server.HVB7OYyI.mjs';
+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 { 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));
 }
@@ -230,7 +244,7 @@ function createRouteHandler(route) {
     return normalizeHandlerValue(c, value);
   };
 }
-function createFinalizeMiddleware(route) {
+function createFinalizeMiddleware(route, onResponse) {
   return async (c, next) => {
     const response = await next();
     const resolved = resolveResponse(response, c.res);
@@ -239,6 +253,15 @@ function createFinalizeMiddleware(route) {
     }
     const overridden = applyRouteOverrides(resolved, route);
     c.res = overridden;
+    if (onResponse) {
+      try {
+        const result = onResponse(route, overridden);
+        if (result instanceof Promise) {
+          result.catch(() => void 0);
+        }
+      } catch {
+      }
+    }
     return overridden;
   };
 }
@@ -248,14 +271,14 @@ function wrapMiddleware(handler) {
     return resolveResponse(response, c.res);
   };
 }
-function createHonoApp(routes) {
+function createHonoApp(routes, options = {}) {
   const app = new Hono({ router: new PatternRouter(), strict: false });
   for (const route of routes) {
     const middlewares = route.middlewares?.map((entry) => wrapMiddleware(entry.handle)) ?? [];
     app.on(
       route.method,
       toHonoPath(route),
-      createFinalizeMiddleware(route),
+      createFinalizeMiddleware(route, options.onResponse),
       ...middlewares,
       createRouteHandler(route)
     );
@@ -360,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);
@@ -420,6 +457,17 @@ function toPlaygroundRoute(route, root, groups) {
     group: matchedGroup?.label
   };
 }
+function toPlaygroundDisabledRoute(route, root, groups) {
+  const matchedGroup = resolveRouteGroup(route.file, groups);
+  return {
+    file: formatRouteFile(route.file, root),
+    reason: normalizeDisabledReason(route.reason),
+    method: route.method,
+    url: route.url,
+    groupKey: matchedGroup?.key,
+    group: matchedGroup?.label
+  };
+}
 function registerPlaygroundRoutes(params) {
   if (!params.config.enabled) {
     return;
@@ -437,7 +485,16 @@ function registerPlaygroundRoutes(params) {
       return new Response("Playground is not available.", { status: 500 });
     }
   };
-  params.app.get(playgroundPath, (c) => c.redirect(`${playgroundPath}/`));
+  params.app.get(playgroundPath, (c) => {
+    try {
+      const pathname = new URL(c.req.raw.url, "http://localhost").pathname;
+      if (pathname.endsWith("/")) {
+        return serveIndex();
+      }
+    } catch {
+    }
+    return c.redirect(`${playgroundPath}/`);
+  });
   params.app.get(`${playgroundPath}/`, () => serveIndex());
   params.app.get(`${playgroundPath}/index.html`, () => serveIndex());
   params.app.get(`${playgroundPath}/routes`, (c) => {
@@ -448,7 +505,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) => {
@@ -715,6 +773,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);
@@ -846,19 +913,44 @@ 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
+  };
+}
 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,
@@ -867,6 +959,58 @@ 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?.({
+          file: fileInfo.file,
+          reason: "disabled-dir",
+          method: resolved?.method,
+          url: resolved?.url
+        });
+      }
+      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?.({
+          file: fileInfo.file,
+          reason: "ignore-prefix",
+          method: resolved?.method,
+          url: resolved?.url
+        });
+      }
+      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?.({
+          file: fileInfo.file,
+          reason,
+          method: resolved?.method,
+          url: resolved?.url
+        });
+      }
       continue;
     }
     const derived = deriveRouteFromFile(fileInfo.file, fileInfo.rootDir, params.logger);
@@ -878,6 +1022,23 @@ 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?.({
+            file: fileInfo.file,
+            reason: "disabled",
+            method: resolved2?.method,
+            url: resolved2?.url
+          });
+        }
+        continue;
+      }
       const ruleValue = rule;
       const unsupportedKeys = ["response", "url", "method"].filter(
         (key2) => key2 in ruleValue
@@ -978,13 +1139,17 @@ function buildApp(params) {
   registerPlaygroundRoutes({
     app,
     routes: params.routes,
+    disabledRoutes: params.disabledRoutes,
     dirs: params.dirs,
     logger: params.logger,
     config: params.playground,
     root: params.root
   });
+  if (params.wsHandler && params.playground.enabled) {
+    app.get(`${params.playground.path}/ws`, params.wsHandler);
+  }
   if (params.routes.length > 0) {
-    const mockApp = createHonoApp(params.routes);
+    const mockApp = createHonoApp(params.routes, { onResponse: params.onResponse });
     app.route("/", mockApp);
   }
   return app;
@@ -1071,22 +1236,94 @@ async function createFetchServer(options = {}) {
   const logger = createLogger(logEnabled);
   const playgroundConfig = resolvePlaygroundOptions(resolvePlaygroundInput(optionList));
   const dirs = resolveAllDirs(optionList, root);
+  const routeCounts = {};
+  const wsClients = /* @__PURE__ */ new Set();
+  let totalCount = 0;
+  let wsHandler;
+  let injectWebSocket;
+  function getRouteKey(route) {
+    return `${route.method} ${route.template}`;
+  }
+  function buildSnapshot() {
+    return {
+      type: "snapshot",
+      total: totalCount,
+      perRoute: { ...routeCounts }
+    };
+  }
+  function broadcast(payload) {
+    if (wsClients.size === 0) {
+      return;
+    }
+    const message = JSON.stringify(payload);
+    for (const client of wsClients) {
+      try {
+        client.send(message);
+      } catch {
+        wsClients.delete(client);
+      }
+    }
+  }
+  function registerWsClient(client) {
+    wsClients.add(client);
+    try {
+      client.send(JSON.stringify(buildSnapshot()));
+    } catch {
+      wsClients.delete(client);
+    }
+  }
+  function handleRouteResponse(route) {
+    const routeKey = getRouteKey(route);
+    routeCounts[routeKey] = (routeCounts[routeKey] ?? 0) + 1;
+    totalCount += 1;
+    broadcast({ type: "increment", routeKey, total: totalCount });
+  }
+  async function setupPlaygroundWebSocket(app2) {
+    if (!playgroundConfig.enabled) {
+      return;
+    }
+    try {
+      const mod = await import('@hono/node-ws');
+      const { createNodeWebSocket } = mod;
+      const { upgradeWebSocket, injectWebSocket: inject } = createNodeWebSocket({ app: app2 });
+      wsHandler = upgradeWebSocket(() => ({
+        onOpen: (_event, ws) => {
+          registerWsClient(ws);
+        },
+        onClose: (_event, ws) => {
+          wsClients.delete(ws);
+        },
+        onMessage: () => {
+        }
+      }));
+      injectWebSocket = (server2) => {
+        inject(server2);
+      };
+    } catch {
+    }
+  }
   let routes = [];
+  let disabledRoutes = [];
   let app = buildApp({
     routes,
+    disabledRoutes,
     dirs,
     playground: playgroundConfig,
     root,
-    logger
+    logger,
+    onResponse: handleRouteResponse,
+    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;
@@ -1094,17 +1331,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
+        logger,
+        onResponse: handleRouteResponse,
+        wsHandler
       });
       logger.info(`Loaded ${routes.length} mock routes.`);
     } catch (error) {
@@ -1112,6 +1356,10 @@ async function createFetchServer(options = {}) {
     }
   };
   await refreshRoutes();
+  await setupPlaygroundWebSocket(app);
+  if (wsHandler && playgroundConfig.enabled) {
+    app.get(`${playgroundConfig.path}/ws`, wsHandler);
+  }
   const scheduleRefresh = createDebouncer(80, () => {
     void refreshRoutes();
   });
@@ -1125,7 +1373,8 @@ async function createFetchServer(options = {}) {
   const server = {
     fetch,
     refresh: refreshRoutes,
-    getRoutes: () => routes
+    getRoutes: () => routes,
+    injectWebSocket
   };
   if (watcher) {
     server.close = async () => {

package/dist/node.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+const nodeServer = require('@hono/node-server');
+
+
+
+exports.serve = nodeServer.serve;

package/dist/node.d.cts

@@ -0,0 +1 @@
+export { serve } from '@hono/node-server';

package/dist/node.d.mts

@@ -0,0 +1 @@
+export { serve } from '@hono/node-server';

package/dist/node.d.ts

@@ -0,0 +1 @@
+export { serve } from '@hono/node-server';

package/dist/node.mjs

@@ -0,0 +1 @@
+export { serve } from '@hono/node-server';

package/dist/shared/{server.HVB7OYyI.mjs → server.Dje1y79O.mjs}

@@ -255,4 +255,4 @@ function createFetchHandler(options) {
   };
 }
 
-export { toRuntimeRequestFromNode as a, applyRuntimeResultToNode as b, toBinaryBody as c, createFetchHandler as d, toRuntimeOptions as t };
+export { toRuntimeRequestFromNode as a, applyRuntimeResultToNode as b, createFetchHandler as c, toBinaryBody as d, toRuntimeOptions as t };

package/dist/worker.mjs

@@ -1,4 +1,4 @@
-import { d as createFetchHandler } from './shared/server.HVB7OYyI.mjs';
+import { c as createFetchHandler } from './shared/server.Dje1y79O.mjs';
 import '@mokup/runtime';
 
 function isManifest(value) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mokup/server",
   "type": "module",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Server adapters for @mokup/runtime.",
   "license": "MIT",
   "homepage": "https://mokup.icebreaker.top",
@@ -16,6 +16,11 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.mjs",
+      "require": "./dist/node.cjs"
+    },
     "./worker": {
       "types": "./dist/worker.d.ts",
       "import": "./dist/worker.mjs",
@@ -32,13 +37,14 @@
     "dist"
   ],
   "dependencies": {
-    "@mokup/playground": "0.0.6",
+    "@hono/node-server": "^1.19.9",
+    "@hono/node-ws": "^1.1.1",
+    "@mokup/playground": "0.0.8",
     "@mokup/runtime": "1.0.0",
     "@mokup/shared": "1.0.0"
   },
   "devDependencies": {
-    "@hono/node-server": "^1.19.9",
-    "@types/node": "^25.0.9",
+    "@types/node": "^25.0.10",
     "typescript": "^5.9.3",
     "unbuild": "^3.6.1"
   },