@mokup/shared 1.1.1 → 1.1.2

package/dist/scan-utils.d.cts

@@ -0,0 +1,114 @@
+import './config-core.cjs';
+import './config-utils.cjs';
+import './define-config.cjs';
+import './jsonc-utils.cjs';
+import './load-rules.cjs';
+import './mock-files.cjs';
+import './module-loader.cjs';
+import './route-constants.cjs';
+import './route-utils.cjs';
+
+declare function normalizeMethod(method?: string | null): string | undefined;
+declare function normalizePrefix(prefix: string): string;
+declare function resolveDirs(dir: DirInput, root: string): string[];
+declare function normalizeIgnorePrefix(value: string | string[] | undefined, fallback?: string[]): string[];
+
+/**
+ * Directory input for mock scanning.
+ *
+ * @example
+ * import type { DirInput } from '@mokup/shared'
+ *
+ * const dir: DirInput = ['mock', 'fixtures']
+ */
+type DirInput = string | string[] | ((root: string) => string | string[]) | undefined;
+/**
+ * Shared entry options for mokup scanners and plugins.
+ *
+ * @example
+ * import type { MockEntryOptions } from '@mokup/shared'
+ *
+ * const entry: MockEntryOptions = {
+ *   dir: 'mock',
+ *   prefix: '/api',
+ *   watch: true,
+ * }
+ */
+interface MockEntryOptions {
+    /**
+     * Directory (or directories) to scan for mock routes.
+     *
+     * @default "mock" (resolved by Vite/webpack plugins)
+     */
+    dir?: DirInput;
+    /**
+     * Request path prefix to mount mock routes under.
+     *
+     * @default ""
+     */
+    prefix?: string;
+    /**
+     * Include filter for files to scan.
+     *
+     * @default undefined
+     */
+    include?: RegExp | RegExp[];
+    /**
+     * Exclude filter for files to scan.
+     *
+     * @default undefined
+     */
+    exclude?: RegExp | RegExp[];
+    /**
+     * Ignore file or folder prefixes when scanning.
+     *
+     * @default ["."]
+     */
+    ignorePrefix?: string | string[];
+    /**
+     * Enable file watching for live route updates.
+     *
+     * @default true
+     */
+    watch?: boolean;
+    /**
+     * Enable mokup logging.
+     *
+     * @default true
+     */
+    log?: boolean;
+}
+/**
+ * Playground configuration input.
+ *
+ * @example
+ * import type { PlaygroundOptionsInput } from '@mokup/shared'
+ *
+ * const playground: PlaygroundOptionsInput = {
+ *   path: '/__mokup',
+ *   enabled: true,
+ * }
+ */
+type PlaygroundOptionsInput = boolean | {
+    /**
+     * Base path for the playground UI.
+     *
+     * @default "/__mokup"
+     */
+    path?: string;
+    /**
+     * Emit playground assets during production builds.
+     *
+     * @default false
+     */
+    build?: boolean;
+    /**
+     * Enable or disable the playground routes.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+} | undefined;
+
+export { normalizeIgnorePrefix, normalizeMethod, normalizePrefix, resolveDirs };
+export type { DirInput as D, MockEntryOptions as M, PlaygroundOptionsInput as P };

package/dist/scan-utils.d.mts

@@ -0,0 +1,114 @@
+import './config-core.mjs';
+import './config-utils.mjs';
+import './define-config.mjs';
+import './jsonc-utils.mjs';
+import './load-rules.mjs';
+import './mock-files.mjs';
+import './module-loader.mjs';
+import './route-constants.mjs';
+import './route-utils.mjs';
+
+declare function normalizeMethod(method?: string | null): string | undefined;
+declare function normalizePrefix(prefix: string): string;
+declare function resolveDirs(dir: DirInput, root: string): string[];
+declare function normalizeIgnorePrefix(value: string | string[] | undefined, fallback?: string[]): string[];
+
+/**
+ * Directory input for mock scanning.
+ *
+ * @example
+ * import type { DirInput } from '@mokup/shared'
+ *
+ * const dir: DirInput = ['mock', 'fixtures']
+ */
+type DirInput = string | string[] | ((root: string) => string | string[]) | undefined;
+/**
+ * Shared entry options for mokup scanners and plugins.
+ *
+ * @example
+ * import type { MockEntryOptions } from '@mokup/shared'
+ *
+ * const entry: MockEntryOptions = {
+ *   dir: 'mock',
+ *   prefix: '/api',
+ *   watch: true,
+ * }
+ */
+interface MockEntryOptions {
+    /**
+     * Directory (or directories) to scan for mock routes.
+     *
+     * @default "mock" (resolved by Vite/webpack plugins)
+     */
+    dir?: DirInput;
+    /**
+     * Request path prefix to mount mock routes under.
+     *
+     * @default ""
+     */
+    prefix?: string;
+    /**
+     * Include filter for files to scan.
+     *
+     * @default undefined
+     */
+    include?: RegExp | RegExp[];
+    /**
+     * Exclude filter for files to scan.
+     *
+     * @default undefined
+     */
+    exclude?: RegExp | RegExp[];
+    /**
+     * Ignore file or folder prefixes when scanning.
+     *
+     * @default ["."]
+     */
+    ignorePrefix?: string | string[];
+    /**
+     * Enable file watching for live route updates.
+     *
+     * @default true
+     */
+    watch?: boolean;
+    /**
+     * Enable mokup logging.
+     *
+     * @default true
+     */
+    log?: boolean;
+}
+/**
+ * Playground configuration input.
+ *
+ * @example
+ * import type { PlaygroundOptionsInput } from '@mokup/shared'
+ *
+ * const playground: PlaygroundOptionsInput = {
+ *   path: '/__mokup',
+ *   enabled: true,
+ * }
+ */
+type PlaygroundOptionsInput = boolean | {
+    /**
+     * Base path for the playground UI.
+     *
+     * @default "/__mokup"
+     */
+    path?: string;
+    /**
+     * Emit playground assets during production builds.
+     *
+     * @default false
+     */
+    build?: boolean;
+    /**
+     * Enable or disable the playground routes.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+} | undefined;
+
+export { normalizeIgnorePrefix, normalizeMethod, normalizePrefix, resolveDirs };
+export type { DirInput as D, MockEntryOptions as M, PlaygroundOptionsInput as P };

package/dist/scan-utils.d.ts

@@ -0,0 +1,114 @@
+import './config-core.js';
+import './config-utils.js';
+import './define-config.js';
+import './jsonc-utils.js';
+import './load-rules.js';
+import './mock-files.js';
+import './module-loader.js';
+import './route-constants.js';
+import './route-utils.js';
+
+declare function normalizeMethod(method?: string | null): string | undefined;
+declare function normalizePrefix(prefix: string): string;
+declare function resolveDirs(dir: DirInput, root: string): string[];
+declare function normalizeIgnorePrefix(value: string | string[] | undefined, fallback?: string[]): string[];
+
+/**
+ * Directory input for mock scanning.
+ *
+ * @example
+ * import type { DirInput } from '@mokup/shared'
+ *
+ * const dir: DirInput = ['mock', 'fixtures']
+ */
+type DirInput = string | string[] | ((root: string) => string | string[]) | undefined;
+/**
+ * Shared entry options for mokup scanners and plugins.
+ *
+ * @example
+ * import type { MockEntryOptions } from '@mokup/shared'
+ *
+ * const entry: MockEntryOptions = {
+ *   dir: 'mock',
+ *   prefix: '/api',
+ *   watch: true,
+ * }
+ */
+interface MockEntryOptions {
+    /**
+     * Directory (or directories) to scan for mock routes.
+     *
+     * @default "mock" (resolved by Vite/webpack plugins)
+     */
+    dir?: DirInput;
+    /**
+     * Request path prefix to mount mock routes under.
+     *
+     * @default ""
+     */
+    prefix?: string;
+    /**
+     * Include filter for files to scan.
+     *
+     * @default undefined
+     */
+    include?: RegExp | RegExp[];
+    /**
+     * Exclude filter for files to scan.
+     *
+     * @default undefined
+     */
+    exclude?: RegExp | RegExp[];
+    /**
+     * Ignore file or folder prefixes when scanning.
+     *
+     * @default ["."]
+     */
+    ignorePrefix?: string | string[];
+    /**
+     * Enable file watching for live route updates.
+     *
+     * @default true
+     */
+    watch?: boolean;
+    /**
+     * Enable mokup logging.
+     *
+     * @default true
+     */
+    log?: boolean;
+}
+/**
+ * Playground configuration input.
+ *
+ * @example
+ * import type { PlaygroundOptionsInput } from '@mokup/shared'
+ *
+ * const playground: PlaygroundOptionsInput = {
+ *   path: '/__mokup',
+ *   enabled: true,
+ * }
+ */
+type PlaygroundOptionsInput = boolean | {
+    /**
+     * Base path for the playground UI.
+     *
+     * @default "/__mokup"
+     */
+    path?: string;
+    /**
+     * Emit playground assets during production builds.
+     *
+     * @default false
+     */
+    build?: boolean;
+    /**
+     * Enable or disable the playground routes.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+} | undefined;
+
+export { normalizeIgnorePrefix, normalizeMethod, normalizePrefix, resolveDirs };
+export type { DirInput as D, MockEntryOptions as M, PlaygroundOptionsInput as P };

package/dist/scan-utils.mjs

@@ -0,0 +1,34 @@
+import { resolve, isAbsolute } from 'pathe';
+import { methodSet } from './route-constants.mjs';
+
+function normalizeMethod(method) {
+  if (!method) {
+    return void 0;
+  }
+  const normalized = method.toUpperCase();
+  if (methodSet.has(normalized)) {
+    return normalized;
+  }
+  return void 0;
+}
+function normalizePrefix(prefix) {
+  if (!prefix) {
+    return "";
+  }
+  const normalized = prefix.startsWith("/") ? prefix : `/${prefix}`;
+  return normalized.endsWith("/") ? normalized.slice(0, -1) : normalized;
+}
+function resolveDirs(dir, root) {
+  const raw = typeof dir === "function" ? dir(root) : dir;
+  const resolved = Array.isArray(raw) ? raw : raw ? [raw] : ["mock"];
+  const normalized = resolved.map(
+    (entry) => isAbsolute(entry) ? entry : resolve(root, entry)
+  );
+  return Array.from(new Set(normalized));
+}
+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);
+}
+
+export { normalizeIgnorePrefix, normalizeMethod, normalizePrefix, resolveDirs };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mokup/shared",
   "type": "module",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Shared dependency exports for mokup.",
   "license": "MIT",
   "homepage": "https://mokup.icebreaker.top",
@@ -16,21 +16,51 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
-    "./esbuild": {
-      "types": "./dist/esbuild.d.ts",
-      "import": "./dist/esbuild.mjs",
-      "require": "./dist/esbuild.cjs"
-    },
     "./chokidar": {
       "types": "./dist/chokidar.d.ts",
       "import": "./dist/chokidar.mjs",
       "require": "./dist/chokidar.cjs"
     },
+    "./config-utils": {
+      "types": "./dist/config-utils.d.ts",
+      "import": "./dist/config-utils.mjs",
+      "require": "./dist/config-utils.cjs"
+    },
+    "./config-core": {
+      "types": "./dist/config-core.d.ts",
+      "import": "./dist/config-core.mjs",
+      "require": "./dist/config-core.cjs"
+    },
+    "./define-config": {
+      "types": "./dist/define-config.d.ts",
+      "import": "./dist/define-config.mjs",
+      "require": "./dist/define-config.cjs"
+    },
+    "./esbuild": {
+      "types": "./dist/esbuild.d.ts",
+      "import": "./dist/esbuild.mjs",
+      "require": "./dist/esbuild.cjs"
+    },
     "./hono": {
       "types": "./dist/hono.d.ts",
       "import": "./dist/hono.mjs",
       "require": "./dist/hono.cjs"
     },
+    "./jsonc-parser": {
+      "types": "./dist/jsonc-parser.d.ts",
+      "import": "./dist/jsonc-parser.mjs",
+      "require": "./dist/jsonc-parser.cjs"
+    },
+    "./jsonc-utils": {
+      "types": "./dist/jsonc-utils.d.ts",
+      "import": "./dist/jsonc-utils.mjs",
+      "require": "./dist/jsonc-utils.cjs"
+    },
+    "./load-rules": {
+      "types": "./dist/load-rules.d.ts",
+      "import": "./dist/load-rules.mjs",
+      "require": "./dist/load-rules.cjs"
+    },
     "./logger": {
       "types": "./dist/logger.d.ts",
       "browser": "./dist/logger.browser.mjs",
@@ -38,6 +68,16 @@
       "import": "./dist/logger.mjs",
       "require": "./dist/logger.cjs"
     },
+    "./mock-files": {
+      "types": "./dist/mock-files.d.ts",
+      "import": "./dist/mock-files.mjs",
+      "require": "./dist/mock-files.cjs"
+    },
+    "./module-loader": {
+      "types": "./dist/module-loader.d.ts",
+      "import": "./dist/module-loader.mjs",
+      "require": "./dist/module-loader.cjs"
+    },
     "./pathe": {
       "types": "./dist/pathe.d.ts",
       "import": "./dist/pathe.mjs",
@@ -53,15 +93,25 @@
       "import": "./dist/playground-grouping.mjs",
       "require": "./dist/playground-grouping.cjs"
     },
+    "./route-constants": {
+      "types": "./dist/route-constants.d.ts",
+      "import": "./dist/route-constants.mjs",
+      "require": "./dist/route-constants.cjs"
+    },
+    "./route-utils": {
+      "types": "./dist/route-utils.d.ts",
+      "import": "./dist/route-utils.mjs",
+      "require": "./dist/route-utils.cjs"
+    },
+    "./scan-utils": {
+      "types": "./dist/scan-utils.d.ts",
+      "import": "./dist/scan-utils.mjs",
+      "require": "./dist/scan-utils.cjs"
+    },
     "./timing": {
       "types": "./dist/timing.d.ts",
       "import": "./dist/timing.mjs",
       "require": "./dist/timing.cjs"
-    },
-    "./jsonc-parser": {
-      "types": "./dist/jsonc-parser.d.ts",
-      "import": "./dist/jsonc-parser.mjs",
-      "require": "./dist/jsonc-parser.cjs"
     }
   },
   "publishConfig": {
@@ -77,18 +127,16 @@
     "chokidar": "^5.0.0",
     "consola": "^3.4.2",
     "esbuild": "^0.27.2",
-    "hono": "^4.11.5",
+    "hono": "^4.11.7",
     "jsonc-parser": "^3.3.1",
-    "pathe": "^2.0.3"
-  },
-  "devDependencies": {
-    "typescript": "^5.9.3",
-    "unbuild": "^3.6.1"
+    "pathe": "^2.0.3",
+    "tsx": "^4.21.0"
   },
   "scripts": {
-    "build": "unbuild",
+    "build": "cross-env NODE_OPTIONS=--max-old-space-size=4096 unbuild",
     "dev": "unbuild --stub",
     "lint": "eslint .",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test:types": "tsd"
   }
 }