mokup 1.0.4 → 2.0.1

package/dist/index.d.cts

@@ -2,8 +2,10 @@ import { Context, MiddlewareHandler } from '@mokup/shared/hono';
 export { Context, MiddlewareHandler } from '@mokup/shared/hono';
 
 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 RouteRule {
     handler: RouteResponse;
     enabled?: boolean;
@@ -20,6 +22,10 @@ interface ServiceWorkerOptions {
     fallback?: boolean;
     basePath?: string | string[];
 }
+type PlaygroundOptionsInput = boolean | {
+    path?: string;
+    enabled?: boolean;
+} | undefined;
 interface RouteDirectoryConfig {
     headers?: Record<string, string>;
     status?: number;
@@ -40,11 +46,11 @@ interface VitePluginOptions {
     log?: boolean;
     mode?: RuntimeMode;
     sw?: ServiceWorkerOptions;
-    playground?: boolean | {
-        path?: string;
-        enabled?: boolean;
-    };
 }
-type VitePluginOptionsInput = VitePluginOptions | VitePluginOptions[];
+interface MokupPluginOptions {
+    entries?: VitePluginOptions | VitePluginOptions[];
+    playground?: PlaygroundOptionsInput;
+}
+type VitePluginOptionsInput = MokupPluginOptions;
 
-export type { HttpMethod, RequestHandler, RouteDirectoryConfig, RouteResponse, RouteRule, RuntimeMode, ServiceWorkerOptions, VitePluginOptions, VitePluginOptionsInput };
+export type { HttpMethod, MokupPluginOptions, PlaygroundOptionsInput, RequestHandler, RouteDirectoryConfig, RouteResponse, RouteRule, RuntimeMode, ServiceWorkerOptions, VitePluginOptions, VitePluginOptionsInput };

package/dist/index.d.mts

@@ -2,8 +2,10 @@ import { Context, MiddlewareHandler } from '@mokup/shared/hono';
 export { Context, MiddlewareHandler } from '@mokup/shared/hono';
 
 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 RouteRule {
     handler: RouteResponse;
     enabled?: boolean;
@@ -20,6 +22,10 @@ interface ServiceWorkerOptions {
     fallback?: boolean;
     basePath?: string | string[];
 }
+type PlaygroundOptionsInput = boolean | {
+    path?: string;
+    enabled?: boolean;
+} | undefined;
 interface RouteDirectoryConfig {
     headers?: Record<string, string>;
     status?: number;
@@ -40,11 +46,11 @@ interface VitePluginOptions {
     log?: boolean;
     mode?: RuntimeMode;
     sw?: ServiceWorkerOptions;
-    playground?: boolean | {
-        path?: string;
-        enabled?: boolean;
-    };
 }
-type VitePluginOptionsInput = VitePluginOptions | VitePluginOptions[];
+interface MokupPluginOptions {
+    entries?: VitePluginOptions | VitePluginOptions[];
+    playground?: PlaygroundOptionsInput;
+}
+type VitePluginOptionsInput = MokupPluginOptions;
 
-export type { HttpMethod, RequestHandler, RouteDirectoryConfig, RouteResponse, RouteRule, RuntimeMode, ServiceWorkerOptions, VitePluginOptions, VitePluginOptionsInput };
+export type { HttpMethod, MokupPluginOptions, PlaygroundOptionsInput, RequestHandler, RouteDirectoryConfig, RouteResponse, RouteRule, RuntimeMode, ServiceWorkerOptions, VitePluginOptions, VitePluginOptionsInput };

package/dist/index.d.ts

@@ -2,8 +2,10 @@ import { Context, MiddlewareHandler } from '@mokup/shared/hono';
 export { Context, MiddlewareHandler } from '@mokup/shared/hono';
 
 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 RouteRule {
     handler: RouteResponse;
     enabled?: boolean;
@@ -20,6 +22,10 @@ interface ServiceWorkerOptions {
     fallback?: boolean;
     basePath?: string | string[];
 }
+type PlaygroundOptionsInput = boolean | {
+    path?: string;
+    enabled?: boolean;
+} | undefined;
 interface RouteDirectoryConfig {
     headers?: Record<string, string>;
     status?: number;
@@ -40,11 +46,11 @@ interface VitePluginOptions {
     log?: boolean;
     mode?: RuntimeMode;
     sw?: ServiceWorkerOptions;
-    playground?: boolean | {
-        path?: string;
-        enabled?: boolean;
-    };
 }
-type VitePluginOptionsInput = VitePluginOptions | VitePluginOptions[];
+interface MokupPluginOptions {
+    entries?: VitePluginOptions | VitePluginOptions[];
+    playground?: PlaygroundOptionsInput;
+}
+type VitePluginOptionsInput = MokupPluginOptions;
 
-export type { HttpMethod, RequestHandler, RouteDirectoryConfig, RouteResponse, RouteRule, RuntimeMode, ServiceWorkerOptions, VitePluginOptions, VitePluginOptionsInput };
+export type { HttpMethod, MokupPluginOptions, PlaygroundOptionsInput, RequestHandler, RouteDirectoryConfig, RouteResponse, RouteRule, RuntimeMode, ServiceWorkerOptions, VitePluginOptions, VitePluginOptionsInput };

package/dist/shared/{mokup.C7VW7pSP.cjs → mokup.B-yfMz5B.cjs}

@@ -52,6 +52,7 @@ const supportedExtensions = /* @__PURE__ */ new Set([
   ".mjs",
   ".cjs"
 ]);
+const configExtensions = [".ts", ".js", ".mjs", ".cjs"];
 
 function normalizeMethod(method) {
   if (!method) {
@@ -350,7 +351,7 @@ function createMiddleware(getApp, logger) {
   };
 }
 
-const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/mokup.C7VW7pSP.cjs', document.baseURI).href)));
+const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/mokup.B-yfMz5B.cjs', document.baseURI).href)));
 const mimeTypes = {
   ".html": "text/html; charset=utf-8",
   ".css": "text/css; charset=utf-8",
@@ -516,12 +517,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);
@@ -584,14 +596,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 createPlaygroundMiddleware(params) {
   const distDir = resolvePlaygroundDist();
@@ -641,13 +683,19 @@ function createPlaygroundMiddleware(params) {
       const groups = resolveGroups(dirs, baseRoot);
       const routes = params.getRoutes();
       const disabledRoutes = params.getDisabledRoutes?.() ?? [];
+      const ignoredRoutes = params.getIgnoredRoutes?.() ?? [];
+      const configFiles = params.getConfigFiles?.() ?? [];
+      const disabledConfigFiles = params.getDisabledConfigFiles?.() ?? [];
       sendJson(res, {
         basePath: matchedPath,
         root: baseRoot,
         count: routes.length,
         groups: groups.map((group) => ({ key: group.key, label: group.label })),
         routes: routes.map((route) => toPlaygroundRoute(route, baseRoot, groups)),
-        disabled: disabledRoutes.map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups))
+        disabled: disabledRoutes.map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups)),
+        ignored: ignoredRoutes.map((route) => toPlaygroundIgnoredRoute(route, baseRoot, groups)),
+        configs: configFiles.map((entry) => toPlaygroundConfigFile(entry, baseRoot, groups)),
+        disabledConfigs: disabledConfigFiles.map((entry) => toPlaygroundConfigFile(entry, baseRoot, groups))
       });
       return;
     }
@@ -791,11 +839,10 @@ function sortRoutes(routes) {
   });
 }
 
-const configExtensions = [".ts", ".js", ".mjs", ".cjs"];
 async function loadModule$1(file) {
   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('shared/mokup.C7VW7pSP.cjs', document.baseURI).href)));
+    const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/mokup.B-yfMz5B.cjs', document.baseURI).href)));
     delete require$1.cache[file];
     return require$1(file);
   }
@@ -978,17 +1025,28 @@ 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) {
   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('shared/mokup.C7VW7pSP.cjs', document.baseURI).href)));
+    const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('shared/mokup.B-yfMz5B.cjs', document.baseURI).href)));
     delete require$1.cache[file];
     return require$1(file);
   }
@@ -1103,6 +1161,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();
@@ -1111,7 +1177,23 @@ 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,
+          server: params.server,
+          logger: params.logger,
+          configCache,
+          fileCache
+        });
+        params.onConfig?.({ file: fileInfo.file, enabled: config2.enabled !== false });
+      }
+      continue;
+    }
     const configParams = {
       file: fileInfo.file,
       rootDir: fileInfo.rootDir,
@@ -1130,12 +1212,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;
     }
@@ -1147,16 +1224,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;
@@ -1169,17 +1244,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.server, params.logger);
@@ -1195,12 +1268,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;
       }

package/dist/shared/{mokup.Da2mv7KS.mjs → mokup.jeVwRMia.mjs}

@@ -49,6 +49,7 @@ const supportedExtensions = /* @__PURE__ */ new Set([
   ".mjs",
   ".cjs"
 ]);
+const configExtensions = [".ts", ".js", ".mjs", ".cjs"];
 
 function normalizeMethod(method) {
   if (!method) {
@@ -513,12 +514,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);
@@ -581,14 +593,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 createPlaygroundMiddleware(params) {
   const distDir = resolvePlaygroundDist();
@@ -638,13 +680,19 @@ function createPlaygroundMiddleware(params) {
       const groups = resolveGroups(dirs, baseRoot);
       const routes = params.getRoutes();
       const disabledRoutes = params.getDisabledRoutes?.() ?? [];
+      const ignoredRoutes = params.getIgnoredRoutes?.() ?? [];
+      const configFiles = params.getConfigFiles?.() ?? [];
+      const disabledConfigFiles = params.getDisabledConfigFiles?.() ?? [];
       sendJson(res, {
         basePath: matchedPath,
         root: baseRoot,
         count: routes.length,
         groups: groups.map((group) => ({ key: group.key, label: group.label })),
         routes: routes.map((route) => toPlaygroundRoute(route, baseRoot, groups)),
-        disabled: disabledRoutes.map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups))
+        disabled: disabledRoutes.map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups)),
+        ignored: ignoredRoutes.map((route) => toPlaygroundIgnoredRoute(route, baseRoot, groups)),
+        configs: configFiles.map((entry) => toPlaygroundConfigFile(entry, baseRoot, groups)),
+        disabledConfigs: disabledConfigFiles.map((entry) => toPlaygroundConfigFile(entry, baseRoot, groups))
       });
       return;
     }
@@ -788,7 +836,6 @@ function sortRoutes(routes) {
   });
 }
 
-const configExtensions = [".ts", ".js", ".mjs", ".cjs"];
 async function loadModule$1(file) {
   const ext = configExtensions.find((extension) => file.endsWith(extension));
   if (ext === ".cjs") {
@@ -975,12 +1022,23 @@ 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) {
   const ext = extname(file).toLowerCase();
@@ -1100,6 +1158,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();
@@ -1108,7 +1174,23 @@ 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,
+          server: params.server,
+          logger: params.logger,
+          configCache,
+          fileCache
+        });
+        params.onConfig?.({ file: fileInfo.file, enabled: config2.enabled !== false });
+      }
+      continue;
+    }
     const configParams = {
       file: fileInfo.file,
       rootDir: fileInfo.rootDir,
@@ -1127,12 +1209,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;
     }
@@ -1144,16 +1221,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;
@@ -1166,17 +1241,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.server, params.logger);
@@ -1192,12 +1265,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;
       }