@mokup/cli 1.0.1 → 1.0.3

package/dist/index.cjs

@@ -195,6 +195,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, log);
     if (normalized.length > 0) {
       merged.middlewares.push(...normalized);
@@ -271,6 +280,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 isSupportedFile(file) {
   if (file.endsWith(".d.ts")) {
     return false;
@@ -592,13 +615,8 @@ async function buildManifest(options = {}) {
   const handlerModuleMap = /* @__PURE__ */ new Map();
   const configCache = /* @__PURE__ */ new Map();
   const configFileCache = /* @__PURE__ */ new Map();
+  const globalIgnorePrefix = normalizeIgnorePrefix(options.ignorePrefix);
   for (const fileInfo of files) {
-    if (!isSupportedFile(fileInfo.file)) {
-      continue;
-    }
-    if (!matchesFilter(fileInfo.file, options.include, options.exclude)) {
-      continue;
-    }
     const configParams = {
       file: fileInfo.file,
       rootDir: fileInfo.rootDir,
@@ -612,6 +630,18 @@ async function buildManifest(options = {}) {
     if (config.enabled === false) {
       continue;
     }
+    const effectiveIgnorePrefix = typeof config.ignorePrefix !== "undefined" ? normalizeIgnorePrefix(config.ignorePrefix, []) : globalIgnorePrefix;
+    if (hasIgnoredPrefix(fileInfo.file, fileInfo.rootDir, effectiveIgnorePrefix)) {
+      continue;
+    }
+    if (!isSupportedFile(fileInfo.file)) {
+      continue;
+    }
+    const effectiveInclude = typeof config.include !== "undefined" ? config.include : options.include;
+    const effectiveExclude = typeof config.exclude !== "undefined" ? config.exclude : options.exclude;
+    if (!matchesFilter(fileInfo.file, effectiveInclude, effectiveExclude)) {
+      continue;
+    }
     const derived = deriveRouteFromFile(fileInfo.file, fileInfo.rootDir, options.log);
     if (!derived) {
       continue;
@@ -621,6 +651,9 @@ async function buildManifest(options = {}) {
       if (!rule || typeof rule !== "object") {
         continue;
       }
+      if (rule.enabled === false) {
+        continue;
+      }
       const ruleValue = rule;
       const unsupportedKeys = ["response", "url", "method"].filter(
         (key2) => key2 in ruleValue
@@ -761,6 +794,9 @@ function toBuildOptions(options) {
   if (options.exclude && options.exclude.length > 0) {
     buildOptions.exclude = options.exclude;
   }
+  if (options.ignorePrefix && options.ignorePrefix.length > 0) {
+    buildOptions.ignorePrefix = options.ignorePrefix;
+  }
   return buildOptions;
 }
 function toServeOptions(options) {
@@ -780,6 +816,9 @@ function toServeOptions(options) {
   if (options.exclude && options.exclude.length > 0) {
     serveOptions.exclude = options.exclude;
   }
+  if (options.ignorePrefix && options.ignorePrefix.length > 0) {
+    serveOptions.ignorePrefix = options.ignorePrefix;
+  }
   if (options.host) {
     serveOptions.host = options.host;
   }
@@ -798,11 +837,11 @@ function toServeOptions(options) {
 function createCli() {
   const program = new commander.Command();
   program.name("mokup").description("Mock utilities for file-based routes.").showHelpAfterError();
-  program.command("build").description("Generate .mokup build output").option("-d, --dir <dir>", "Mock directory (repeatable)", collectValues).option("-o, --out <dir>", "Output directory (default: .mokup)").option("--prefix <prefix>", "URL prefix").option("--include <pattern>", "Include regex (repeatable)", collectRegex).option("--exclude <pattern>", "Exclude regex (repeatable)", collectRegex).option("--no-handlers", "Skip function handler output").action(async (options) => {
+  program.command("build").description("Generate .mokup build output").option("-d, --dir <dir>", "Mock directory (repeatable)", collectValues).option("-o, --out <dir>", "Output directory (default: .mokup)").option("--prefix <prefix>", "URL prefix").option("--include <pattern>", "Include regex (repeatable)", collectRegex).option("--exclude <pattern>", "Exclude regex (repeatable)", collectRegex).option("--ignore-prefix <prefix>", "Ignore path segment prefix (repeatable)", collectValues).option("--no-handlers", "Skip function handler output").action(async (options) => {
     const buildOptions = toBuildOptions(options);
     await buildManifest(buildOptions);
   });
-  program.command("serve").description("Start a Node.js mock server").option("-d, --dir <dir>", "Mock directory (repeatable)", collectValues).option("--prefix <prefix>", "URL prefix").option("--include <pattern>", "Include regex (repeatable)", collectRegex).option("--exclude <pattern>", "Exclude regex (repeatable)", collectRegex).option("--host <host>", "Hostname (default: localhost)").option("--port <port>", "Port (default: 8080)").option("--no-watch", "Disable file watching").option("--no-playground", "Disable Playground").option("--no-log", "Disable logging").action(async (options) => {
+  program.command("serve").description("Start a Node.js mock server").option("-d, --dir <dir>", "Mock directory (repeatable)", collectValues).option("--prefix <prefix>", "URL prefix").option("--include <pattern>", "Include regex (repeatable)", collectRegex).option("--exclude <pattern>", "Exclude regex (repeatable)", collectRegex).option("--ignore-prefix <prefix>", "Ignore path segment prefix (repeatable)", collectValues).option("--host <host>", "Hostname (default: localhost)").option("--port <port>", "Port (default: 8080)").option("--no-watch", "Disable file watching").option("--no-playground", "Disable Playground").option("--no-log", "Disable logging").action(async (options) => {
     const serveOptions = toServeOptions(options);
     const host = serveOptions.host ?? "localhost";
     const port = serveOptions.port ?? 8080;

package/dist/index.d.cts

@@ -7,6 +7,7 @@ interface BuildOptions {
     prefix?: string;
     include?: RegExp | RegExp[];
     exclude?: RegExp | RegExp[];
+    ignorePrefix?: string | string[];
     handlers?: boolean;
     root?: string;
     log?: (message: string) => void;

package/dist/index.d.mts

@@ -7,6 +7,7 @@ interface BuildOptions {
     prefix?: string;
     include?: RegExp | RegExp[];
     exclude?: RegExp | RegExp[];
+    ignorePrefix?: string | string[];
     handlers?: boolean;
     root?: string;
     log?: (message: string) => void;

package/dist/index.d.ts

@@ -7,6 +7,7 @@ interface BuildOptions {
     prefix?: string;
     include?: RegExp | RegExp[];
     exclude?: RegExp | RegExp[];
+    ignorePrefix?: string | string[];
     handlers?: boolean;
     root?: string;
     log?: (message: string) => void;

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { promises } from 'node:fs';
 import process, { cwd } from 'node:process';
-import { join, normalize, dirname, resolve, isAbsolute, basename, extname, relative } from '@mokup/shared/pathe';
+import { join, normalize, dirname, resolve, isAbsolute, relative, basename, extname } from '@mokup/shared/pathe';
 import { Buffer } from 'node:buffer';
 import { createRequire } from 'node:module';
 import { pathToFileURL } from 'node:url';
@@ -188,6 +188,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, log);
     if (normalized.length > 0) {
       merged.middlewares.push(...normalized);
@@ -264,6 +273,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 isSupportedFile(file) {
   if (file.endsWith(".d.ts")) {
     return false;
@@ -585,13 +608,8 @@ async function buildManifest(options = {}) {
   const handlerModuleMap = /* @__PURE__ */ new Map();
   const configCache = /* @__PURE__ */ new Map();
   const configFileCache = /* @__PURE__ */ new Map();
+  const globalIgnorePrefix = normalizeIgnorePrefix(options.ignorePrefix);
   for (const fileInfo of files) {
-    if (!isSupportedFile(fileInfo.file)) {
-      continue;
-    }
-    if (!matchesFilter(fileInfo.file, options.include, options.exclude)) {
-      continue;
-    }
     const configParams = {
       file: fileInfo.file,
       rootDir: fileInfo.rootDir,
@@ -605,6 +623,18 @@ async function buildManifest(options = {}) {
     if (config.enabled === false) {
       continue;
     }
+    const effectiveIgnorePrefix = typeof config.ignorePrefix !== "undefined" ? normalizeIgnorePrefix(config.ignorePrefix, []) : globalIgnorePrefix;
+    if (hasIgnoredPrefix(fileInfo.file, fileInfo.rootDir, effectiveIgnorePrefix)) {
+      continue;
+    }
+    if (!isSupportedFile(fileInfo.file)) {
+      continue;
+    }
+    const effectiveInclude = typeof config.include !== "undefined" ? config.include : options.include;
+    const effectiveExclude = typeof config.exclude !== "undefined" ? config.exclude : options.exclude;
+    if (!matchesFilter(fileInfo.file, effectiveInclude, effectiveExclude)) {
+      continue;
+    }
     const derived = deriveRouteFromFile(fileInfo.file, fileInfo.rootDir, options.log);
     if (!derived) {
       continue;
@@ -614,6 +644,9 @@ async function buildManifest(options = {}) {
       if (!rule || typeof rule !== "object") {
         continue;
       }
+      if (rule.enabled === false) {
+        continue;
+      }
       const ruleValue = rule;
       const unsupportedKeys = ["response", "url", "method"].filter(
         (key2) => key2 in ruleValue
@@ -754,6 +787,9 @@ function toBuildOptions(options) {
   if (options.exclude && options.exclude.length > 0) {
     buildOptions.exclude = options.exclude;
   }
+  if (options.ignorePrefix && options.ignorePrefix.length > 0) {
+    buildOptions.ignorePrefix = options.ignorePrefix;
+  }
   return buildOptions;
 }
 function toServeOptions(options) {
@@ -773,6 +809,9 @@ function toServeOptions(options) {
   if (options.exclude && options.exclude.length > 0) {
     serveOptions.exclude = options.exclude;
   }
+  if (options.ignorePrefix && options.ignorePrefix.length > 0) {
+    serveOptions.ignorePrefix = options.ignorePrefix;
+  }
   if (options.host) {
     serveOptions.host = options.host;
   }
@@ -791,11 +830,11 @@ function toServeOptions(options) {
 function createCli() {
   const program = new Command();
   program.name("mokup").description("Mock utilities for file-based routes.").showHelpAfterError();
-  program.command("build").description("Generate .mokup build output").option("-d, --dir <dir>", "Mock directory (repeatable)", collectValues).option("-o, --out <dir>", "Output directory (default: .mokup)").option("--prefix <prefix>", "URL prefix").option("--include <pattern>", "Include regex (repeatable)", collectRegex).option("--exclude <pattern>", "Exclude regex (repeatable)", collectRegex).option("--no-handlers", "Skip function handler output").action(async (options) => {
+  program.command("build").description("Generate .mokup build output").option("-d, --dir <dir>", "Mock directory (repeatable)", collectValues).option("-o, --out <dir>", "Output directory (default: .mokup)").option("--prefix <prefix>", "URL prefix").option("--include <pattern>", "Include regex (repeatable)", collectRegex).option("--exclude <pattern>", "Exclude regex (repeatable)", collectRegex).option("--ignore-prefix <prefix>", "Ignore path segment prefix (repeatable)", collectValues).option("--no-handlers", "Skip function handler output").action(async (options) => {
     const buildOptions = toBuildOptions(options);
     await buildManifest(buildOptions);
   });
-  program.command("serve").description("Start a Node.js mock server").option("-d, --dir <dir>", "Mock directory (repeatable)", collectValues).option("--prefix <prefix>", "URL prefix").option("--include <pattern>", "Include regex (repeatable)", collectRegex).option("--exclude <pattern>", "Exclude regex (repeatable)", collectRegex).option("--host <host>", "Hostname (default: localhost)").option("--port <port>", "Port (default: 8080)").option("--no-watch", "Disable file watching").option("--no-playground", "Disable Playground").option("--no-log", "Disable logging").action(async (options) => {
+  program.command("serve").description("Start a Node.js mock server").option("-d, --dir <dir>", "Mock directory (repeatable)", collectValues).option("--prefix <prefix>", "URL prefix").option("--include <pattern>", "Include regex (repeatable)", collectRegex).option("--exclude <pattern>", "Exclude regex (repeatable)", collectRegex).option("--ignore-prefix <prefix>", "Ignore path segment prefix (repeatable)", collectValues).option("--host <host>", "Hostname (default: localhost)").option("--port <port>", "Port (default: 8080)").option("--no-watch", "Disable file watching").option("--no-playground", "Disable Playground").option("--no-log", "Disable logging").action(async (options) => {
     const serveOptions = toServeOptions(options);
     const host = serveOptions.host ?? "localhost";
     const port = serveOptions.port ?? 8080;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mokup/cli",
   "type": "module",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "CLI for building mokup manifests and handlers.",
   "license": "MIT",
   "homepage": "https://mokup.icebreaker.top",
@@ -29,11 +29,11 @@
   "dependencies": {
     "commander": "^14.0.0",
     "@mokup/runtime": "1.0.0",
-    "@mokup/server": "1.0.3",
+    "@mokup/server": "1.1.0",
     "@mokup/shared": "1.0.0"
   },
   "devDependencies": {
-    "@types/node": "^25.0.9",
+    "@types/node": "^25.0.10",
     "typescript": "^5.9.3",
     "unbuild": "^3.6.1"
   },