mokup 1.0.4 → 2.0.1

package/dist/vite.cjs

@@ -1,10 +1,11 @@
 'use strict';
 
 const node_fs = require('node:fs');
+const node_path = require('node:path');
 const process = require('node:process');
 const node_url = require('node:url');
 const chokidar = require('@mokup/shared/chokidar');
-const sw = require('./shared/mokup.C7VW7pSP.cjs');
+const sw = require('./shared/mokup.B-yfMz5B.cjs');
 require('node:buffer');
 require('@mokup/shared/hono');
 require('node:module');
@@ -18,7 +19,7 @@ function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'defau
 
 const chokidar__default = /*#__PURE__*/_interopDefaultCompat(chokidar);
 
-function buildRouteSignature(routes, disabledRoutes) {
+function buildRouteSignature(routes, disabledRoutes, ignoredRoutes, configFiles, disabledConfigFiles) {
   return routes.map(
     (route) => [
       route.method,
@@ -37,22 +38,57 @@ function buildRouteSignature(routes, disabledRoutes) {
         route.url ?? ""
       ].join("|")
     )
+  ).concat(
+    ignoredRoutes.map(
+      (route) => [
+        route.reason,
+        route.file
+      ].join("|")
+    )
+  ).concat(
+    configFiles.map((route) => route.file)
+  ).concat(
+    disabledConfigFiles.map((route) => route.file)
   ).join("\n");
 }
 function isViteDevServer(server) {
   return !!server && "ws" in server;
 }
-function normalizeOptions(options) {
-  const list = Array.isArray(options) ? options : [options];
-  return list.length > 0 ? list : [{}];
+const legacyEntryKeys = [
+  "dir",
+  "prefix",
+  "include",
+  "exclude",
+  "ignorePrefix",
+  "watch",
+  "log",
+  "mode",
+  "sw"
+];
+function isLegacyEntryOptions(value) {
+  return legacyEntryKeys.some((key) => key in value);
 }
-function resolvePlaygroundInput(list) {
-  for (const entry of list) {
-    if (typeof entry.playground !== "undefined") {
-      return entry.playground;
-    }
+function normalizeMokupOptions(options) {
+  if (!options) {
+    return {};
+  }
+  if (Array.isArray(options)) {
+    throw new TypeError("[mokup] Invalid config: use mokup({ entries: [...] }) instead of mokup([...]).");
+  }
+  if (typeof options !== "object") {
+    return {};
+  }
+  if (isLegacyEntryOptions(options)) {
+    throw new Error(
+      "[mokup] Invalid config: use mokup({ entries: { ... } }) instead of mokup({ dir, prefix, ... })."
+    );
   }
-  return void 0;
+  return options;
+}
+function normalizeOptions(options) {
+  const entries = options.entries;
+  const list = Array.isArray(entries) ? entries : entries ? [entries] : [{}];
+  return list.length > 0 ? list : [{}];
 }
 function normalizeBase(base) {
   if (!base) {
@@ -115,6 +151,24 @@ function addMiddlewareFirst(server, middleware) {
   }
   server.middlewares.use(middleware);
 }
+function normalizeWatcherFile(file, rootDir) {
+  if (!file) {
+    return file;
+  }
+  if (node_path.isAbsolute(file)) {
+    return file;
+  }
+  return node_path.resolve(rootDir, file);
+}
+function normalizeRawWatcherPath(rawPath) {
+  if (typeof rawPath === "string") {
+    return rawPath;
+  }
+  if (rawPath && typeof rawPath.toString === "function") {
+    return rawPath.toString();
+  }
+  return "";
+}
 function createMokupPlugin(options = {}) {
   let root = process.cwd();
   let base = "/";
@@ -124,14 +178,18 @@ function createMokupPlugin(options = {}) {
   let serverRoutes = [];
   let swRoutes = [];
   let disabledRoutes = [];
+  let ignoredRoutes = [];
+  let configFiles = [];
+  let disabledConfigFiles = [];
   let app = null;
   let previewWatcher = null;
   let currentServer = null;
   let lastSignature = null;
-  const optionList = normalizeOptions(options);
+  const normalizedOptions = normalizeMokupOptions(options);
+  const optionList = normalizeOptions(normalizedOptions);
   const logEnabled = optionList.every((entry) => entry.log !== false);
   const watchEnabled = optionList.every((entry) => entry.watch !== false);
-  const playgroundConfig = sw.resolvePlaygroundOptions(resolvePlaygroundInput(optionList));
+  const playgroundConfig = sw.resolvePlaygroundOptions(normalizedOptions.playground);
   const logger = sw.createLogger(logEnabled);
   const hasSwEntries = optionList.some((entry) => entry.mode === "sw");
   const swConfig = sw.resolveSwConfig(optionList, logger);
@@ -220,6 +278,9 @@ function createMokupPlugin(options = {}) {
   const playgroundMiddleware = sw.createPlaygroundMiddleware({
     getRoutes: () => routes,
     getDisabledRoutes: () => disabledRoutes,
+    getIgnoredRoutes: () => ignoredRoutes,
+    getConfigFiles: () => configFiles,
+    getDisabledConfigFiles: () => disabledConfigFiles,
     config: playgroundConfig,
     logger,
     getServer: () => currentServer,
@@ -231,13 +292,17 @@ function createMokupPlugin(options = {}) {
     const collectedServer = [];
     const collectedSw = [];
     const collectedDisabled = [];
+    const collectedIgnored = [];
+    const collectedConfigs = [];
     for (const entry of optionList) {
       const dirs = sw.resolveDirs(entry.dir, root);
       const scanParams = {
         dirs,
         prefix: entry.prefix ?? "",
         logger,
-        onSkip: (info) => collectedDisabled.push(info)
+        onSkip: (info) => collectedDisabled.push(info),
+        onIgnore: (info) => collectedIgnored.push(info),
+        onConfig: (info) => collectedConfigs.push(info)
       };
       if (entry.include) {
         scanParams.include = entry.include;
@@ -266,8 +331,19 @@ function createMokupPlugin(options = {}) {
     serverRoutes = sw.sortRoutes(collectedServer);
     swRoutes = sw.sortRoutes(collectedSw);
     disabledRoutes = collectedDisabled;
+    ignoredRoutes = collectedIgnored;
+    const configMap = new Map(collectedConfigs.map((entry) => [entry.file, entry]));
+    const resolvedConfigs = Array.from(configMap.values());
+    configFiles = resolvedConfigs.filter((entry) => entry.enabled);
+    disabledConfigFiles = resolvedConfigs.filter((entry) => !entry.enabled);
     app = serverRoutes.length > 0 ? sw.createHonoApp(serverRoutes) : null;
-    const signature = buildRouteSignature(routes, disabledRoutes);
+    const signature = buildRouteSignature(
+      routes,
+      disabledRoutes,
+      ignoredRoutes,
+      configFiles,
+      disabledConfigFiles
+    );
     if (isViteDevServer(server) && server.ws) {
       if (lastSignature && signature !== lastSignature) {
         server.ws.send({
@@ -425,18 +501,26 @@ function createMokupPlugin(options = {}) {
       const dirs = resolveAllDirs();
       server.watcher.add(dirs);
       const scheduleRefresh = sw.createDebouncer(80, () => refreshRoutes(server));
-      server.watcher.on("add", (file) => {
-        if (sw.isInDirs(file, dirs)) {
+      const handleWatchedFile = (file) => {
+        const resolvedFile = normalizeWatcherFile(file, server.config.root ?? root);
+        if (sw.isInDirs(resolvedFile, dirs)) {
           scheduleRefresh();
         }
-      });
-      server.watcher.on("change", (file) => {
-        if (sw.isInDirs(file, dirs)) {
-          scheduleRefresh();
+      };
+      server.watcher.on("add", handleWatchedFile);
+      server.watcher.on("change", handleWatchedFile);
+      server.watcher.on("unlink", handleWatchedFile);
+      server.watcher.on("raw", (eventName, rawPath, details) => {
+        if (eventName !== "rename") {
+          return;
         }
-      });
-      server.watcher.on("unlink", (file) => {
-        if (sw.isInDirs(file, dirs)) {
+        const candidate = normalizeRawWatcherPath(rawPath);
+        if (!candidate) {
+          return;
+        }
+        const baseDir = typeof details === "object" && details && "watchedPath" in details ? details.watchedPath ?? (server.config.root ?? root) : server.config.root ?? root;
+        const resolvedFile = normalizeWatcherFile(candidate, baseDir);
+        if (sw.isInDirs(resolvedFile, dirs)) {
           scheduleRefresh();
         }
       });
@@ -481,9 +565,29 @@ function createMokupPlugin(options = {}) {
       const watcher = chokidar__default.watch(dirs, { ignoreInitial: true });
       previewWatcher = watcher;
       const scheduleRefresh = sw.createDebouncer(80, () => refreshRoutes(server));
-      watcher.on("add", scheduleRefresh);
-      watcher.on("change", scheduleRefresh);
-      watcher.on("unlink", scheduleRefresh);
+      const handleWatchedFile = (file) => {
+        const resolvedFile = normalizeWatcherFile(file, server.config.root ?? root);
+        if (sw.isInDirs(resolvedFile, dirs)) {
+          scheduleRefresh();
+        }
+      };
+      watcher.on("add", handleWatchedFile);
+      watcher.on("change", handleWatchedFile);
+      watcher.on("unlink", handleWatchedFile);
+      watcher.on("raw", (eventName, rawPath, details) => {
+        if (eventName !== "rename") {
+          return;
+        }
+        const candidate = normalizeRawWatcherPath(rawPath);
+        if (!candidate) {
+          return;
+        }
+        const baseDir = typeof details === "object" && details && "watchedPath" in details ? details.watchedPath ?? (server.config.root ?? root) : server.config.root ?? root;
+        const resolvedFile = normalizeWatcherFile(candidate, baseDir);
+        if (sw.isInDirs(resolvedFile, dirs)) {
+          scheduleRefresh();
+        }
+      });
       server.httpServer?.once("close", () => {
         previewWatcher?.close();
         previewWatcher = null;

package/dist/vite.d.cts

@@ -1,10 +1,10 @@
 import { Plugin } from 'vite';
-import { VitePluginOptionsInput } from './index.cjs';
-export { HttpMethod, RequestHandler, RouteDirectoryConfig, RouteResponse, RouteRule, RuntimeMode, ServiceWorkerOptions, VitePluginOptions } from './index.cjs';
+import { MokupPluginOptions } from './index.cjs';
+export { HttpMethod, PlaygroundOptionsInput, RequestHandler, RouteDirectoryConfig, RouteResponse, RouteRule, RuntimeMode, ServiceWorkerOptions, VitePluginOptions, VitePluginOptionsInput } from './index.cjs';
 export { Context, MiddlewareHandler } from '@mokup/shared/hono';
 
-declare function createMokupPlugin(options?: VitePluginOptionsInput): Plugin;
+declare function createMokupPlugin(options?: MokupPluginOptions): Plugin;
 
 // @ts-ignore
 export = createMokupPlugin;
-export { VitePluginOptionsInput };
+export { MokupPluginOptions };

package/dist/vite.d.mts

@@ -1,8 +1,8 @@
 import { Plugin } from 'vite';
-import { VitePluginOptionsInput } from './index.mjs';
-export { HttpMethod, RequestHandler, RouteDirectoryConfig, RouteResponse, RouteRule, RuntimeMode, ServiceWorkerOptions, VitePluginOptions } from './index.mjs';
+import { MokupPluginOptions } from './index.mjs';
+export { HttpMethod, PlaygroundOptionsInput, RequestHandler, RouteDirectoryConfig, RouteResponse, RouteRule, RuntimeMode, ServiceWorkerOptions, VitePluginOptions, VitePluginOptionsInput } from './index.mjs';
 export { Context, MiddlewareHandler } from '@mokup/shared/hono';
 
-declare function createMokupPlugin(options?: VitePluginOptionsInput): Plugin;
+declare function createMokupPlugin(options?: MokupPluginOptions): Plugin;
 
-export { VitePluginOptionsInput, createMokupPlugin as default };
+export { MokupPluginOptions, createMokupPlugin as default };

package/dist/vite.d.ts

@@ -1,10 +1,10 @@
 import { Plugin } from 'vite';
-import { VitePluginOptionsInput } from './index.js';
-export { HttpMethod, RequestHandler, RouteDirectoryConfig, RouteResponse, RouteRule, RuntimeMode, ServiceWorkerOptions, VitePluginOptions } from './index.js';
+import { MokupPluginOptions } from './index.js';
+export { HttpMethod, PlaygroundOptionsInput, RequestHandler, RouteDirectoryConfig, RouteResponse, RouteRule, RuntimeMode, ServiceWorkerOptions, VitePluginOptions, VitePluginOptionsInput } from './index.js';
 export { Context, MiddlewareHandler } from '@mokup/shared/hono';
 
-declare function createMokupPlugin(options?: VitePluginOptionsInput): Plugin;
+declare function createMokupPlugin(options?: MokupPluginOptions): Plugin;
 
 // @ts-ignore
 export = createMokupPlugin;
-export { VitePluginOptionsInput };
+export { MokupPluginOptions };

package/dist/vite.mjs

@@ -1,8 +1,9 @@
 import { existsSync } from 'node:fs';
+import { isAbsolute, resolve } from 'node:path';
 import { cwd } from 'node:process';
 import { fileURLToPath } from 'node:url';
 import chokidar from '@mokup/shared/chokidar';
-import { r as resolvePlaygroundOptions, a as resolveSwConfig, b as resolveSwUnregisterConfig, c as createPlaygroundMiddleware, d as buildSwScript, e as createLogger, f as createMiddleware, g as createDebouncer, i as isInDirs, h as resolveDirs, s as scanRoutes, j as sortRoutes, k as createHonoApp } from './shared/mokup.Da2mv7KS.mjs';
+import { r as resolvePlaygroundOptions, a as resolveSwConfig, b as resolveSwUnregisterConfig, c as createPlaygroundMiddleware, d as buildSwScript, e as createLogger, f as createMiddleware, i as isInDirs, g as createDebouncer, h as resolveDirs, s as scanRoutes, j as sortRoutes, k as createHonoApp } from './shared/mokup.jeVwRMia.mjs';
 import 'node:buffer';
 import '@mokup/shared/hono';
 import 'node:module';
@@ -11,7 +12,7 @@ import '@mokup/shared/esbuild';
 import '@mokup/shared/jsonc-parser';
 import '@mokup/runtime';
 
-function buildRouteSignature(routes, disabledRoutes) {
+function buildRouteSignature(routes, disabledRoutes, ignoredRoutes, configFiles, disabledConfigFiles) {
   return routes.map(
     (route) => [
       route.method,
@@ -30,22 +31,57 @@ function buildRouteSignature(routes, disabledRoutes) {
         route.url ?? ""
       ].join("|")
     )
+  ).concat(
+    ignoredRoutes.map(
+      (route) => [
+        route.reason,
+        route.file
+      ].join("|")
+    )
+  ).concat(
+    configFiles.map((route) => route.file)
+  ).concat(
+    disabledConfigFiles.map((route) => route.file)
   ).join("\n");
 }
 function isViteDevServer(server) {
   return !!server && "ws" in server;
 }
-function normalizeOptions(options) {
-  const list = Array.isArray(options) ? options : [options];
-  return list.length > 0 ? list : [{}];
+const legacyEntryKeys = [
+  "dir",
+  "prefix",
+  "include",
+  "exclude",
+  "ignorePrefix",
+  "watch",
+  "log",
+  "mode",
+  "sw"
+];
+function isLegacyEntryOptions(value) {
+  return legacyEntryKeys.some((key) => key in value);
 }
-function resolvePlaygroundInput(list) {
-  for (const entry of list) {
-    if (typeof entry.playground !== "undefined") {
-      return entry.playground;
-    }
+function normalizeMokupOptions(options) {
+  if (!options) {
+    return {};
+  }
+  if (Array.isArray(options)) {
+    throw new TypeError("[mokup] Invalid config: use mokup({ entries: [...] }) instead of mokup([...]).");
+  }
+  if (typeof options !== "object") {
+    return {};
+  }
+  if (isLegacyEntryOptions(options)) {
+    throw new Error(
+      "[mokup] Invalid config: use mokup({ entries: { ... } }) instead of mokup({ dir, prefix, ... })."
+    );
   }
-  return void 0;
+  return options;
+}
+function normalizeOptions(options) {
+  const entries = options.entries;
+  const list = Array.isArray(entries) ? entries : entries ? [entries] : [{}];
+  return list.length > 0 ? list : [{}];
 }
 function normalizeBase(base) {
   if (!base) {
@@ -108,6 +144,24 @@ function addMiddlewareFirst(server, middleware) {
   }
   server.middlewares.use(middleware);
 }
+function normalizeWatcherFile(file, rootDir) {
+  if (!file) {
+    return file;
+  }
+  if (isAbsolute(file)) {
+    return file;
+  }
+  return resolve(rootDir, file);
+}
+function normalizeRawWatcherPath(rawPath) {
+  if (typeof rawPath === "string") {
+    return rawPath;
+  }
+  if (rawPath && typeof rawPath.toString === "function") {
+    return rawPath.toString();
+  }
+  return "";
+}
 function createMokupPlugin(options = {}) {
   let root = cwd();
   let base = "/";
@@ -117,14 +171,18 @@ function createMokupPlugin(options = {}) {
   let serverRoutes = [];
   let swRoutes = [];
   let disabledRoutes = [];
+  let ignoredRoutes = [];
+  let configFiles = [];
+  let disabledConfigFiles = [];
   let app = null;
   let previewWatcher = null;
   let currentServer = null;
   let lastSignature = null;
-  const optionList = normalizeOptions(options);
+  const normalizedOptions = normalizeMokupOptions(options);
+  const optionList = normalizeOptions(normalizedOptions);
   const logEnabled = optionList.every((entry) => entry.log !== false);
   const watchEnabled = optionList.every((entry) => entry.watch !== false);
-  const playgroundConfig = resolvePlaygroundOptions(resolvePlaygroundInput(optionList));
+  const playgroundConfig = resolvePlaygroundOptions(normalizedOptions.playground);
   const logger = createLogger(logEnabled);
   const hasSwEntries = optionList.some((entry) => entry.mode === "sw");
   const swConfig = resolveSwConfig(optionList, logger);
@@ -213,6 +271,9 @@ function createMokupPlugin(options = {}) {
   const playgroundMiddleware = createPlaygroundMiddleware({
     getRoutes: () => routes,
     getDisabledRoutes: () => disabledRoutes,
+    getIgnoredRoutes: () => ignoredRoutes,
+    getConfigFiles: () => configFiles,
+    getDisabledConfigFiles: () => disabledConfigFiles,
     config: playgroundConfig,
     logger,
     getServer: () => currentServer,
@@ -224,13 +285,17 @@ function createMokupPlugin(options = {}) {
     const collectedServer = [];
     const collectedSw = [];
     const collectedDisabled = [];
+    const collectedIgnored = [];
+    const collectedConfigs = [];
     for (const entry of optionList) {
       const dirs = resolveDirs(entry.dir, root);
       const scanParams = {
         dirs,
         prefix: entry.prefix ?? "",
         logger,
-        onSkip: (info) => collectedDisabled.push(info)
+        onSkip: (info) => collectedDisabled.push(info),
+        onIgnore: (info) => collectedIgnored.push(info),
+        onConfig: (info) => collectedConfigs.push(info)
       };
       if (entry.include) {
         scanParams.include = entry.include;
@@ -259,8 +324,19 @@ function createMokupPlugin(options = {}) {
     serverRoutes = sortRoutes(collectedServer);
     swRoutes = sortRoutes(collectedSw);
     disabledRoutes = collectedDisabled;
+    ignoredRoutes = collectedIgnored;
+    const configMap = new Map(collectedConfigs.map((entry) => [entry.file, entry]));
+    const resolvedConfigs = Array.from(configMap.values());
+    configFiles = resolvedConfigs.filter((entry) => entry.enabled);
+    disabledConfigFiles = resolvedConfigs.filter((entry) => !entry.enabled);
     app = serverRoutes.length > 0 ? createHonoApp(serverRoutes) : null;
-    const signature = buildRouteSignature(routes, disabledRoutes);
+    const signature = buildRouteSignature(
+      routes,
+      disabledRoutes,
+      ignoredRoutes,
+      configFiles,
+      disabledConfigFiles
+    );
     if (isViteDevServer(server) && server.ws) {
       if (lastSignature && signature !== lastSignature) {
         server.ws.send({
@@ -418,18 +494,26 @@ function createMokupPlugin(options = {}) {
       const dirs = resolveAllDirs();
       server.watcher.add(dirs);
       const scheduleRefresh = createDebouncer(80, () => refreshRoutes(server));
-      server.watcher.on("add", (file) => {
-        if (isInDirs(file, dirs)) {
+      const handleWatchedFile = (file) => {
+        const resolvedFile = normalizeWatcherFile(file, server.config.root ?? root);
+        if (isInDirs(resolvedFile, dirs)) {
           scheduleRefresh();
         }
-      });
-      server.watcher.on("change", (file) => {
-        if (isInDirs(file, dirs)) {
-          scheduleRefresh();
+      };
+      server.watcher.on("add", handleWatchedFile);
+      server.watcher.on("change", handleWatchedFile);
+      server.watcher.on("unlink", handleWatchedFile);
+      server.watcher.on("raw", (eventName, rawPath, details) => {
+        if (eventName !== "rename") {
+          return;
         }
-      });
-      server.watcher.on("unlink", (file) => {
-        if (isInDirs(file, dirs)) {
+        const candidate = normalizeRawWatcherPath(rawPath);
+        if (!candidate) {
+          return;
+        }
+        const baseDir = typeof details === "object" && details && "watchedPath" in details ? details.watchedPath ?? (server.config.root ?? root) : server.config.root ?? root;
+        const resolvedFile = normalizeWatcherFile(candidate, baseDir);
+        if (isInDirs(resolvedFile, dirs)) {
           scheduleRefresh();
         }
       });
@@ -474,9 +558,29 @@ function createMokupPlugin(options = {}) {
       const watcher = chokidar.watch(dirs, { ignoreInitial: true });
       previewWatcher = watcher;
       const scheduleRefresh = createDebouncer(80, () => refreshRoutes(server));
-      watcher.on("add", scheduleRefresh);
-      watcher.on("change", scheduleRefresh);
-      watcher.on("unlink", scheduleRefresh);
+      const handleWatchedFile = (file) => {
+        const resolvedFile = normalizeWatcherFile(file, server.config.root ?? root);
+        if (isInDirs(resolvedFile, dirs)) {
+          scheduleRefresh();
+        }
+      };
+      watcher.on("add", handleWatchedFile);
+      watcher.on("change", handleWatchedFile);
+      watcher.on("unlink", handleWatchedFile);
+      watcher.on("raw", (eventName, rawPath, details) => {
+        if (eventName !== "rename") {
+          return;
+        }
+        const candidate = normalizeRawWatcherPath(rawPath);
+        if (!candidate) {
+          return;
+        }
+        const baseDir = typeof details === "object" && details && "watchedPath" in details ? details.watchedPath ?? (server.config.root ?? root) : server.config.root ?? root;
+        const resolvedFile = normalizeWatcherFile(candidate, baseDir);
+        if (isInDirs(resolvedFile, dirs)) {
+          scheduleRefresh();
+        }
+      });
       server.httpServer?.once("close", () => {
         previewWatcher?.close();
         previewWatcher = null;

package/dist/webpack.cjs

@@ -7,7 +7,7 @@ const process = require('node:process');
 const chokidar = require('@mokup/shared/chokidar');
 const esbuild = require('@mokup/shared/esbuild');
 const pathe = require('@mokup/shared/pathe');
-const sw = require('./shared/mokup.C7VW7pSP.cjs');
+const sw = require('./shared/mokup.B-yfMz5B.cjs');
 require('node:buffer');
 require('@mokup/shared/hono');
 require('node:fs');
@@ -22,17 +22,41 @@ const chokidar__default = /*#__PURE__*/_interopDefaultCompat(chokidar);
 
 const pluginName = "mokup:webpack";
 const lifecycleBaseName = "mokup-sw-lifecycle.js";
-function normalizeOptions(options) {
-  const list = Array.isArray(options) ? options : [options];
-  return list.length > 0 ? list : [{}];
+const legacyEntryKeys = [
+  "dir",
+  "prefix",
+  "include",
+  "exclude",
+  "ignorePrefix",
+  "watch",
+  "log",
+  "mode",
+  "sw"
+];
+function isLegacyEntryOptions(value) {
+  return legacyEntryKeys.some((key) => key in value);
 }
-function resolvePlaygroundInput(list) {
-  for (const entry of list) {
-    if (typeof entry.playground !== "undefined") {
-      return entry.playground;
-    }
+function normalizeMokupOptions(options) {
+  if (!options) {
+    return {};
+  }
+  if (Array.isArray(options)) {
+    throw new TypeError("[mokup] Invalid config: use mokup({ entries: [...] }) instead of mokup([...]).");
+  }
+  if (typeof options !== "object") {
+    return {};
   }
-  return void 0;
+  if (isLegacyEntryOptions(options)) {
+    throw new Error(
+      "[mokup] Invalid config: use mokup({ entries: { ... } }) instead of mokup({ dir, prefix, ... })."
+    );
+  }
+  return options;
+}
+function normalizeOptions(options) {
+  const entries = options.entries;
+  const list = Array.isArray(entries) ? entries : entries ? [entries] : [{}];
+  return list.length > 0 ? list : [{}];
 }
 function normalizeBase(base) {
   if (!base) {
@@ -165,10 +189,11 @@ function resolveHtmlWebpackPlugin() {
   }
 }
 function createMokupWebpackPlugin(options = {}) {
-  const optionList = normalizeOptions(options);
+  const normalizedOptions = normalizeMokupOptions(options);
+  const optionList = normalizeOptions(normalizedOptions);
   const logEnabled = optionList.every((entry) => entry.log !== false);
   const watchEnabled = optionList.every((entry) => entry.watch !== false);
-  const playgroundConfig = sw.resolvePlaygroundOptions(resolvePlaygroundInput(optionList));
+  const playgroundConfig = sw.resolvePlaygroundOptions(normalizedOptions.playground);
   const logger = sw.createLogger(logEnabled);
   const hasSwEntries = optionList.some((entry) => entry.mode === "sw");
   const swConfig = sw.resolveSwConfig(optionList, logger);
@@ -180,6 +205,9 @@ function createMokupWebpackPlugin(options = {}) {
   let serverRoutes = [];
   let swRoutes = [];
   let disabledRoutes = [];
+  let ignoredRoutes = [];
+  let configFiles = [];
+  let disabledConfigFiles = [];
   let app = null;
   let watcher = null;
   let watchingCompiler = null;
@@ -208,13 +236,17 @@ function createMokupWebpackPlugin(options = {}) {
     const collectedServer = [];
     const collectedSw = [];
     const collectedDisabled = [];
+    const collectedIgnored = [];
+    const collectedConfigs = [];
     for (const entry of optionList) {
       const dirs = sw.resolveDirs(entry.dir, root);
       const scanParams = {
         dirs,
         prefix: entry.prefix ?? "",
         logger,
-        onSkip: (info) => collectedDisabled.push(info)
+        onSkip: (info) => collectedDisabled.push(info),
+        onIgnore: (info) => collectedIgnored.push(info),
+        onConfig: (info) => collectedConfigs.push(info)
       };
       if (entry.include) {
         scanParams.include = entry.include;
@@ -240,6 +272,11 @@ function createMokupWebpackPlugin(options = {}) {
     serverRoutes = sw.sortRoutes(collectedServer);
     swRoutes = sw.sortRoutes(collectedSw);
     disabledRoutes = collectedDisabled;
+    ignoredRoutes = collectedIgnored;
+    const configMap = new Map(collectedConfigs.map((entry) => [entry.file, entry]));
+    const resolvedConfigs = Array.from(configMap.values());
+    configFiles = resolvedConfigs.filter((entry) => entry.enabled);
+    disabledConfigFiles = resolvedConfigs.filter((entry) => !entry.enabled);
     app = serverRoutes.length > 0 ? sw.createHonoApp(serverRoutes) : null;
   };
   const rebuildBundles = async () => {
@@ -289,6 +326,9 @@ function createMokupWebpackPlugin(options = {}) {
   const playgroundMiddleware = sw.createPlaygroundMiddleware({
     getRoutes: () => routes,
     getDisabledRoutes: () => disabledRoutes,
+    getIgnoredRoutes: () => ignoredRoutes,
+    getConfigFiles: () => configFiles,
+    getDisabledConfigFiles: () => disabledConfigFiles,
     config: playgroundConfig,
     logger,
     getDirs: () => resolveAllDirs(),