@mandujs/core 0.22.0 → 0.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/core",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Mandu Framework Core - Spec, Generator, Guard, Runtime",
   "type": "module",
   "main": "./src/index.ts",
@@ -28,9 +28,16 @@
     "./id": "./src/id/index.ts",
     "./observability": "./src/observability/index.ts",
     "./perf": "./src/perf/index.ts",
+    "./perf/hmr-markers": "./src/perf/hmr-markers.ts",
     "./scheduler": "./src/scheduler/index.ts",
     "./storage/s3": "./src/storage/s3/index.ts",
     "./bundler/prerender": "./src/bundler/prerender.ts",
+    "./bundler/safe-build": "./src/bundler/safe-build.ts",
+    "./bundler/hmr-types": "./src/bundler/hmr-types.ts",
+    "./bundler/scenario-matrix": "./src/bundler/scenario-matrix.ts",
+    "./bundler/vendor-cache-types": "./src/bundler/vendor-cache-types.ts",
+    "./bundler/manifest-schema": "./src/bundler/manifest-schema.ts",
+    "./runtime/fast-refresh-types": "./src/runtime/fast-refresh-types.ts",
     "./*": "./src/*"
   },
   "files": [

package/src/config/mandu.ts

@@ -1,110 +1,172 @@
-import path from "path";
-import { readJsonFile } from "../utils/bun";
-import type { ManduAdapter } from "../runtime/adapter";
-import type { ManduPlugin, ManduHooks } from "../plugins/hooks";
-
-export type GuardRuleSeverity = "error" | "warn" | "warning" | "off";
-
-export interface ManduConfig {
-  adapter?: ManduAdapter;
-  server?: {
-    port?: number;
-    hostname?: string;
-    cors?:
-      | boolean
-      | {
-          origin?: string | string[];
-          methods?: string[];
-          credentials?: boolean;
-        };
-    streaming?: boolean;
-    rateLimit?:
-      | boolean
-      | {
-          windowMs?: number;
-          max?: number;
-          message?: string;
-          statusCode?: number;
-          headers?: boolean;
-        };
-  };
-  guard?: {
-    preset?: "mandu" | "fsd" | "clean" | "hexagonal" | "atomic" | "cqrs";
-    srcDir?: string;
-    exclude?: string[];
-    realtime?: boolean;
-    rules?: Record<string, GuardRuleSeverity>;
-    contractRequired?: GuardRuleSeverity;
-  };
-  build?: {
-    outDir?: string;
-    minify?: boolean;
-    sourcemap?: boolean;
-    splitting?: boolean;
-  };
-  dev?: {
-    hmr?: boolean;
-    watchDirs?: string[];
-    /** Observability SQLite 영구 저장 (기본: true) */
-    observability?: boolean;
-  };
-  fsRoutes?: {
-    routesDir?: string;
-    extensions?: string[];
-    exclude?: string[];
-    islandSuffix?: string;
-  };
-  seo?: {
-    enabled?: boolean;
-    defaultTitle?: string;
-    titleTemplate?: string;
-  };
-  plugins?: ManduPlugin[];
-  hooks?: Partial<ManduHooks>;
-}
-
-export const CONFIG_FILES = [
-  "mandu.config.ts",
-  "mandu.config.js",
-  "mandu.config.json",
-  path.join(".mandu", "guard.json"),
-];
-
-export function coerceConfig(raw: unknown, source: string): ManduConfig {
-  if (!raw || typeof raw !== "object") return {};
-
-  // .mandu/guard.json can be guard-only
-  if (source.endsWith("guard.json") && !("guard" in (raw as Record<string, unknown>))) {
-    return { guard: raw as ManduConfig["guard"] };
-  }
-
-  return raw as ManduConfig;
-}
-
-export async function loadManduConfig(rootDir: string): Promise<ManduConfig> {
-  for (const fileName of CONFIG_FILES) {
-    const filePath = path.join(rootDir, fileName);
-    if (!(await Bun.file(filePath).exists())) {
-      continue;
-    }
-
-    if (fileName.endsWith(".json")) {
-      try {
-        const parsed = await readJsonFile(filePath);
-        return coerceConfig(parsed, fileName);
-      } catch {
-        return {};
-      }
-    }
-
-    try {
-      const module = await import(filePath);
-      const raw = module?.default ?? module;
-      return coerceConfig(raw, fileName);
-    } catch {
-      return {};
-    }
-  }
-
-  return {};
-}
+import path from "path";
+import { readJsonFile } from "../utils/bun";
+import type { ManduAdapter } from "../runtime/adapter";
+import type { ManduPlugin, ManduHooks } from "../plugins/hooks";
+
+export type GuardRuleSeverity = "error" | "warn" | "warning" | "off";
+
+/**
+ * Test block configuration (Phase 12.1 — testing ecosystem).
+ *
+ * Shapes the CLI `mandu test` command's discovery, fixture, and reporter
+ * behaviour. All fields are optional; omitting the block yields sensible
+ * defaults that match Next.js / SvelteKit user expectations:
+ *
+ *   - unit    → `**\/*.test.ts` / `**\/*.test.tsx`, 30s timeout
+ *   - integration → `tests/integration/**\/*.test.ts`, in-memory fixtures
+ *   - e2e     → reserved for Phase 12.2 (ATE integration)
+ *   - coverage → reserved for Phase 12.3 (bun + playwright merge)
+ */
+export interface TestUnitConfig {
+  /** Glob patterns for unit test files. Default: `["**\/*.test.ts", "**\/*.test.tsx"]`. */
+  include?: string[];
+  /** Glob patterns to exclude (applied after `include`). Default: `["node_modules/**", ".mandu/**", "dist/**"]`. */
+  exclude?: string[];
+  /** Per-test timeout in milliseconds. Default: `30_000` (30s). */
+  timeout?: number;
+}
+
+export interface TestIntegrationConfig {
+  /** Glob patterns for integration test files. Default: `["tests/integration/**\/*.test.ts"]`. */
+  include?: string[];
+  /** Glob patterns to exclude. Default: same as unit defaults. */
+  exclude?: string[];
+  /**
+   * Database URL for fixtures. Default: `"sqlite::memory:"` (in-memory SQLite).
+   * Accepts any Bun.sql-compatible URL — see `@mandujs/core/db` for the schema matrix.
+   */
+  dbUrl?: string;
+  /**
+   * Session storage strategy for `createTestSession`.
+   * - `"memory"` (default): CookieSessionStorage with ephemeral secret
+   * - `"sqlite"`: bun:sqlite-backed (Phase 2.5 storage, requires Phase 4)
+   */
+  sessionStore?: "memory" | "sqlite";
+  /** Per-test timeout. Default: `60_000` (60s — integration work is slower). */
+  timeout?: number;
+}
+
+export interface TestE2EConfig {
+  /** Reserved for Phase 12.2. Currently a typed placeholder. */
+  reserved?: true;
+}
+
+export interface TestCoverageConfig {
+  /** Minimum line coverage percentage (0-100). Reserved for Phase 12.3. */
+  lines?: number;
+  /** Minimum branch coverage percentage (0-100). Reserved for Phase 12.3. */
+  branches?: number;
+}
+
+export interface TestConfig {
+  unit?: TestUnitConfig;
+  integration?: TestIntegrationConfig;
+  e2e?: TestE2EConfig;
+  coverage?: TestCoverageConfig;
+}
+
+export interface ManduConfig {
+  adapter?: ManduAdapter;
+  server?: {
+    port?: number;
+    hostname?: string;
+    cors?:
+      | boolean
+      | {
+          origin?: string | string[];
+          methods?: string[];
+          credentials?: boolean;
+        };
+    streaming?: boolean;
+    rateLimit?:
+      | boolean
+      | {
+          windowMs?: number;
+          max?: number;
+          message?: string;
+          statusCode?: number;
+          headers?: boolean;
+        };
+  };
+  guard?: {
+    preset?: "mandu" | "fsd" | "clean" | "hexagonal" | "atomic" | "cqrs";
+    srcDir?: string;
+    exclude?: string[];
+    realtime?: boolean;
+    rules?: Record<string, GuardRuleSeverity>;
+    contractRequired?: GuardRuleSeverity;
+  };
+  build?: {
+    outDir?: string;
+    minify?: boolean;
+    sourcemap?: boolean;
+    splitting?: boolean;
+  };
+  dev?: {
+    hmr?: boolean;
+    watchDirs?: string[];
+    /** Observability SQLite 영구 저장 (기본: true) */
+    observability?: boolean;
+  };
+  fsRoutes?: {
+    routesDir?: string;
+    extensions?: string[];
+    exclude?: string[];
+    islandSuffix?: string;
+  };
+  seo?: {
+    enabled?: boolean;
+    defaultTitle?: string;
+    titleTemplate?: string;
+  };
+  /** Phase 12.1 — `mandu test` configuration block. */
+  test?: TestConfig;
+  plugins?: ManduPlugin[];
+  hooks?: Partial<ManduHooks>;
+}
+
+export const CONFIG_FILES = [
+  "mandu.config.ts",
+  "mandu.config.js",
+  "mandu.config.json",
+  path.join(".mandu", "guard.json"),
+];
+
+export function coerceConfig(raw: unknown, source: string): ManduConfig {
+  if (!raw || typeof raw !== "object") return {};
+
+  // .mandu/guard.json can be guard-only
+  if (source.endsWith("guard.json") && !("guard" in (raw as Record<string, unknown>))) {
+    return { guard: raw as ManduConfig["guard"] };
+  }
+
+  return raw as ManduConfig;
+}
+
+export async function loadManduConfig(rootDir: string): Promise<ManduConfig> {
+  for (const fileName of CONFIG_FILES) {
+    const filePath = path.join(rootDir, fileName);
+    if (!(await Bun.file(filePath).exists())) {
+      continue;
+    }
+
+    if (fileName.endsWith(".json")) {
+      try {
+        const parsed = await readJsonFile(filePath);
+        return coerceConfig(parsed, fileName);
+      } catch {
+        return {};
+      }
+    }
+
+    try {
+      const module = await import(filePath);
+      const raw = module?.default ?? module;
+      return coerceConfig(raw, fileName);
+    } catch {
+      return {};
+    }
+  }
+
+  return {};
+}