mokup 1.0.3 → 2.0.0

package/dist/index.d.cts

@@ -6,6 +6,7 @@ type RequestHandler = (context: Context) => Response | Promise<Response> | unkno
 type RouteResponse = unknown | RequestHandler;
 interface RouteRule {
     handler: RouteResponse;
+    enabled?: boolean;
     status?: number;
     headers?: Record<string, string>;
     delay?: number;
@@ -19,11 +20,18 @@ interface ServiceWorkerOptions {
     fallback?: boolean;
     basePath?: string | string[];
 }
+type PlaygroundOptionsInput = boolean | {
+    path?: string;
+    enabled?: boolean;
+} | undefined;
 interface RouteDirectoryConfig {
     headers?: Record<string, string>;
     status?: number;
     delay?: number;
     enabled?: boolean;
+    ignorePrefix?: string | string[];
+    include?: RegExp | RegExp[];
+    exclude?: RegExp | RegExp[];
     middleware?: MiddlewareHandler | MiddlewareHandler[];
 }
 interface VitePluginOptions {
@@ -31,15 +39,16 @@ interface VitePluginOptions {
     prefix?: string;
     include?: RegExp | RegExp[];
     exclude?: RegExp | RegExp[];
+    ignorePrefix?: string | string[];
     watch?: boolean;
     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

@@ -6,6 +6,7 @@ type RequestHandler = (context: Context) => Response | Promise<Response> | unkno
 type RouteResponse = unknown | RequestHandler;
 interface RouteRule {
     handler: RouteResponse;
+    enabled?: boolean;
     status?: number;
     headers?: Record<string, string>;
     delay?: number;
@@ -19,11 +20,18 @@ interface ServiceWorkerOptions {
     fallback?: boolean;
     basePath?: string | string[];
 }
+type PlaygroundOptionsInput = boolean | {
+    path?: string;
+    enabled?: boolean;
+} | undefined;
 interface RouteDirectoryConfig {
     headers?: Record<string, string>;
     status?: number;
     delay?: number;
     enabled?: boolean;
+    ignorePrefix?: string | string[];
+    include?: RegExp | RegExp[];
+    exclude?: RegExp | RegExp[];
     middleware?: MiddlewareHandler | MiddlewareHandler[];
 }
 interface VitePluginOptions {
@@ -31,15 +39,16 @@ interface VitePluginOptions {
     prefix?: string;
     include?: RegExp | RegExp[];
     exclude?: RegExp | RegExp[];
+    ignorePrefix?: string | string[];
     watch?: boolean;
     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

@@ -6,6 +6,7 @@ type RequestHandler = (context: Context) => Response | Promise<Response> | unkno
 type RouteResponse = unknown | RequestHandler;
 interface RouteRule {
     handler: RouteResponse;
+    enabled?: boolean;
     status?: number;
     headers?: Record<string, string>;
     delay?: number;
@@ -19,11 +20,18 @@ interface ServiceWorkerOptions {
     fallback?: boolean;
     basePath?: string | string[];
 }
+type PlaygroundOptionsInput = boolean | {
+    path?: string;
+    enabled?: boolean;
+} | undefined;
 interface RouteDirectoryConfig {
     headers?: Record<string, string>;
     status?: number;
     delay?: number;
     enabled?: boolean;
+    ignorePrefix?: string | string[];
+    include?: RegExp | RegExp[];
+    exclude?: RegExp | RegExp[];
     middleware?: MiddlewareHandler | MiddlewareHandler[];
 }
 interface VitePluginOptions {
@@ -31,15 +39,16 @@ interface VitePluginOptions {
     prefix?: string;
     include?: RegExp | RegExp[];
     exclude?: RegExp | RegExp[];
+    ignorePrefix?: string | string[];
     watch?: boolean;
     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.Cvbs0IQE.cjs → mokup.CvPjMpMJ.cjs}

@@ -114,6 +114,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));
 }
@@ -336,7 +350,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.Cvbs0IQE.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.CvPjMpMJ.cjs', document.baseURI).href)));
 const mimeTypes = {
   ".html": "text/html; charset=utf-8",
   ".css": "text/css; charset=utf-8",
@@ -494,6 +508,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);
@@ -554,6 +582,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 createPlaygroundMiddleware(params) {
   const distDir = resolvePlaygroundDist();
   const playgroundPath = params.config.path;
@@ -601,12 +647,14 @@ function createPlaygroundMiddleware(params) {
       const baseRoot = resolveGroupRoot(dirs, server?.config?.root);
       const groups = resolveGroups(dirs, baseRoot);
       const routes = params.getRoutes();
+      const disabledRoutes = params.getDisabledRoutes?.() ?? [];
       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))
+        routes: routes.map((route) => toPlaygroundRoute(route, baseRoot, groups)),
+        disabled: disabledRoutes.map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups))
       });
       return;
     }
@@ -754,7 +802,7 @@ 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.Cvbs0IQE.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.CvPjMpMJ.cjs', document.baseURI).href)));
     delete require$1.cache[file];
     return require$1(file);
   }
@@ -882,6 +930,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);
@@ -938,7 +995,7 @@ function isSupportedFile(file) {
 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.Cvbs0IQE.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.CvPjMpMJ.cjs', document.baseURI).href)));
     delete require$1.cache[file];
     return require$1(file);
   }
@@ -1024,19 +1081,52 @@ async function loadRules(file, server, 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 configParams = {
       file: fileInfo.file,
       rootDir: fileInfo.rootDir,
@@ -1049,6 +1139,43 @@ async function scanRoutes(params) {
     }
     const config = await resolveDirectoryConfig(configParams);
     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);
@@ -1060,6 +1187,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

package/dist/shared/{mokup.BJg257y9.mjs → mokup.U2S5CHgY.mjs}

@@ -3,7 +3,7 @@ import { Hono, PatternRouter } from '@mokup/shared/hono';
 import { promises } from 'node:fs';
 import { createRequire } from 'node:module';
 import { cwd } from 'node:process';
-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 { pathToFileURL } from 'node:url';
 import { build } from '@mokup/shared/esbuild';
 import { parse } from '@mokup/shared/jsonc-parser';
@@ -111,6 +111,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));
 }
@@ -491,6 +505,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);
@@ -551,6 +579,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 createPlaygroundMiddleware(params) {
   const distDir = resolvePlaygroundDist();
   const playgroundPath = params.config.path;
@@ -598,12 +644,14 @@ function createPlaygroundMiddleware(params) {
       const baseRoot = resolveGroupRoot(dirs, server?.config?.root);
       const groups = resolveGroups(dirs, baseRoot);
       const routes = params.getRoutes();
+      const disabledRoutes = params.getDisabledRoutes?.() ?? [];
       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))
+        routes: routes.map((route) => toPlaygroundRoute(route, baseRoot, groups)),
+        disabled: disabledRoutes.map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups))
       });
       return;
     }
@@ -879,6 +927,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);
@@ -1021,19 +1078,52 @@ async function loadRules(file, server, 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 configParams = {
       file: fileInfo.file,
       rootDir: fileInfo.rootDir,
@@ -1046,6 +1136,43 @@ async function scanRoutes(params) {
     }
     const config = await resolveDirectoryConfig(configParams);
     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);
@@ -1057,6 +1184,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