@mandujs/core 0.9.41 → 0.9.42

package/src/client/window-state.ts

@@ -0,0 +1,101 @@
+/**
+ * 타입 안전 전역 상태 접근자
+ * window 객체 직접 접근 대신 이 모듈의 함수 사용
+ */
+import type { Root } from "react-dom/client";
+import type { RouterState } from "./router";
+
+// ============================================
+// 환경 체크
+// ============================================
+
+export function isBrowser(): boolean {
+  return typeof window !== "undefined";
+}
+
+// ============================================
+// Router State
+// ============================================
+
+export function getRouterState(): RouterState | undefined {
+  if (!isBrowser()) return undefined;
+  return window.__MANDU_ROUTER_STATE__;
+}
+
+export function setRouterState(state: RouterState): void {
+  if (!isBrowser()) return;
+  window.__MANDU_ROUTER_STATE__ = state;
+}
+
+export function getRouterListeners(): Set<(state: RouterState) => void> {
+  if (!isBrowser()) return new Set();
+
+  if (!window.__MANDU_ROUTER_LISTENERS__) {
+    window.__MANDU_ROUTER_LISTENERS__ = new Set();
+  }
+  return window.__MANDU_ROUTER_LISTENERS__;
+}
+
+// ============================================
+// Route & Data
+// ============================================
+
+export function getManduRoute():
+  | { id: string; pattern: string; params: Record<string, string> }
+  | undefined {
+  if (!isBrowser()) return undefined;
+  return window.__MANDU_ROUTE__;
+}
+
+export function getManduData():
+  | Record<string, { serverData: unknown; timestamp?: number }>
+  | undefined {
+  if (!isBrowser()) return undefined;
+  return window.__MANDU_DATA__;
+}
+
+export function getManduDataRaw(): string | undefined {
+  if (!isBrowser()) return undefined;
+  return window.__MANDU_DATA_RAW__;
+}
+
+/**
+ * 특정 라우트의 서버 데이터 조회 (타입 안전)
+ */
+export function getServerData<T>(routeId: string): T | undefined {
+  const data = getManduData();
+  return data?.[routeId]?.serverData as T | undefined;
+}
+
+/**
+ * 서버 데이터 설정
+ */
+export function setServerData(routeId: string, data: unknown): void {
+  if (!isBrowser()) return;
+
+  if (!window.__MANDU_DATA__) {
+    window.__MANDU_DATA__ = {};
+  }
+  window.__MANDU_DATA__[routeId] = { serverData: data };
+}
+
+// ============================================
+// Hydration Roots
+// ============================================
+
+export function getHydratedRoots(): Map<string, Root> {
+  if (!isBrowser()) return new Map();
+
+  if (!window.__MANDU_ROOTS__) {
+    window.__MANDU_ROOTS__ = new Map();
+  }
+  return window.__MANDU_ROOTS__;
+}
+
+export function setHydratedRoot(id: string, root: Root): void {
+  getHydratedRoots().set(id, root);
+}
+
+export function removeHydratedRoot(id: string): boolean {
+  return getHydratedRoots().delete(id);
+}

package/src/config/index.ts

@@ -1 +1,2 @@
 export * from "./mandu";
+export * from "./validate";

package/src/config/mandu.ts

@@ -1,23 +1,62 @@
 import path from "path";
-import fs from "fs/promises";
+import { readJsonFile } from "../utils/bun";
 
-export type GuardRuleSeverity = "error" | "warn" | "off";
+export type GuardRuleSeverity = "error" | "warn" | "warning" | "off";
 
 export interface ManduConfig {
+  server?: {
+    port?: number;
+    hostname?: string;
+    cors?:
+      | boolean
+      | {
+          origin?: string | string[];
+          methods?: string[];
+          credentials?: boolean;
+        };
+    streaming?: boolean;
+  };
   guard?: {
+    preset?: "mandu" | "fsd" | "clean" | "hexagonal" | "atomic";
+    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[];
+  };
+  fsRoutes?: {
+    routesDir?: string;
+    extensions?: string[];
+    exclude?: string[];
+    islandSuffix?: string;
+    legacyManifestPath?: string;
+    mergeWithLegacy?: boolean;
+  };
+  seo?: {
+    enabled?: boolean;
+    defaultTitle?: string;
+    titleTemplate?: string;
+  };
 }
 
-const CONFIG_FILES = [
+export const CONFIG_FILES = [
   "mandu.config.ts",
   "mandu.config.js",
   "mandu.config.json",
   path.join(".mandu", "guard.json"),
 ];
 
-function coerceConfig(raw: unknown, source: string): ManduConfig {
+export function coerceConfig(raw: unknown, source: string): ManduConfig {
   if (!raw || typeof raw !== "object") return {};
 
   // .mandu/guard.json can be guard-only
@@ -31,16 +70,13 @@ function coerceConfig(raw: unknown, source: string): ManduConfig {
 export async function loadManduConfig(rootDir: string): Promise<ManduConfig> {
   for (const fileName of CONFIG_FILES) {
     const filePath = path.join(rootDir, fileName);
-    try {
-      await fs.access(filePath);
-    } catch {
+    if (!(await Bun.file(filePath).exists())) {
       continue;
     }
 
     if (fileName.endsWith(".json")) {
       try {
-        const content = await Bun.file(filePath).text();
-        const parsed = JSON.parse(content);
+        const parsed = await readJsonFile(filePath);
         return coerceConfig(parsed, fileName);
       } catch {
         return {};

package/src/config/validate.ts

@@ -0,0 +1,158 @@
+import { z, ZodError } from "zod";
+import path from "path";
+import { pathToFileURL } from "url";
+import { CONFIG_FILES, coerceConfig } from "./mandu";
+import { readJsonFile } from "../utils/bun";
+
+/**
+ * Mandu 설정 스키마
+ */
+export const ManduConfigSchema = z
+  .object({
+    server: z
+      .object({
+        port: z.number().min(1).max(65535).default(3000),
+        hostname: z.string().default("localhost"),
+        cors: z
+          .union([
+            z.boolean(),
+            z.object({
+              origin: z.union([z.string(), z.array(z.string())]).optional(),
+              methods: z.array(z.string()).optional(),
+              credentials: z.boolean().optional(),
+            }),
+          ])
+          .default(false),
+        streaming: z.boolean().default(false),
+      })
+      .default({}),
+
+    guard: z
+      .object({
+        preset: z.enum(["mandu", "fsd", "clean", "hexagonal", "atomic"]).default("mandu"),
+        srcDir: z.string().default("src"),
+        exclude: z.array(z.string()).default([]),
+        realtime: z.boolean().default(true),
+        rules: z.record(z.enum(["error", "warn", "warning", "off"])).optional(),
+      })
+      .default({}),
+
+    build: z
+      .object({
+        outDir: z.string().default(".mandu"),
+        minify: z.boolean().default(true),
+        sourcemap: z.boolean().default(false),
+        splitting: z.boolean().default(false),
+      })
+      .default({}),
+
+    dev: z
+      .object({
+        hmr: z.boolean().default(true),
+        watchDirs: z.array(z.string()).default([]),
+      })
+      .default({}),
+
+    fsRoutes: z
+      .object({
+        routesDir: z.string().default("app"),
+        extensions: z.array(z.string()).default([".tsx", ".ts", ".jsx", ".js"]),
+        exclude: z.array(z.string()).default([]),
+        islandSuffix: z.string().default(".island"),
+        legacyManifestPath: z.string().optional(),
+        mergeWithLegacy: z.boolean().default(true),
+      })
+      .default({}),
+
+    seo: z
+      .object({
+        enabled: z.boolean().default(true),
+        defaultTitle: z.string().optional(),
+        titleTemplate: z.string().optional(),
+      })
+      .default({}),
+  })
+  .passthrough();
+
+export type ValidatedManduConfig = z.infer<typeof ManduConfigSchema>;
+
+/**
+ * 검증 결과
+ */
+export interface ValidationResult {
+  valid: boolean;
+  config?: ValidatedManduConfig;
+  errors?: Array<{
+    path: string;
+    message: string;
+  }>;
+  source?: string;
+}
+
+/**
+ * 설정 파일 검증
+ */
+export async function validateConfig(rootDir: string): Promise<ValidationResult> {
+  for (const fileName of CONFIG_FILES) {
+    const filePath = path.join(rootDir, fileName);
+    if (!(await Bun.file(filePath).exists())) {
+      continue;
+    }
+
+    try {
+      let raw: unknown;
+      if (fileName.endsWith(".json")) {
+        raw = await readJsonFile(filePath);
+      } else {
+        const module = await import(pathToFileURL(filePath).href);
+        raw = module?.default ?? module;
+      }
+
+      const config = ManduConfigSchema.parse(coerceConfig(raw ?? {}, fileName));
+      return { valid: true, config, source: fileName };
+    } catch (error) {
+      if (error instanceof ZodError) {
+        const errors = error.errors.map((e) => ({
+          path: e.path.join("."),
+          message: e.message,
+        }));
+        return { valid: false, errors, source: fileName };
+      }
+
+      return {
+        valid: false,
+        errors: [
+          {
+            path: "",
+            message: `Failed to load config: ${
+              error instanceof Error ? error.message : String(error)
+            }`,
+          },
+        ],
+        source: fileName,
+      };
+    }
+  }
+
+  // 설정 파일 없음 - 기본값 사용
+  return { valid: true, config: ManduConfigSchema.parse({}) };
+}
+
+/**
+ * CLI용 검증 및 리포트
+ */
+export async function validateAndReport(rootDir: string): Promise<ValidatedManduConfig | null> {
+  const result = await validateConfig(rootDir);
+
+  if (!result.valid) {
+    console.error(`\n❌ Invalid config${result.source ? ` (${result.source})` : ""}:\n`);
+    for (const error of result.errors || []) {
+      const location = error.path ? `  ${error.path}: ` : "  ";
+      console.error(`${location}${error.message}`);
+    }
+    console.error("");
+    return null;
+  }
+
+  return result.config!;
+}

package/src/constants.ts

@@ -0,0 +1,25 @@
+/**
+ * Mandu core constants
+ * Centralized defaults for timeouts, limits, and client behavior.
+ */
+
+export const TIMEOUTS = {
+  LOADER_DEFAULT: 5000,
+  CLIENT_DEFAULT: 30000,
+  WATCHER_DEBOUNCE: 100,
+  HMR_RECONNECT_DELAY: 1000,
+  HMR_MAX_RECONNECT: 10,
+} as const;
+
+export const PORTS = {
+  HMR_OFFSET: 1,
+} as const;
+
+export const HYDRATION = {
+  DEFAULT_PRIORITY: "visible" as const,
+} as const;
+
+export const LIMITS = {
+  ROUTER_PATTERN_CACHE: 200,
+  ROUTER_PREFETCH_CACHE: 500,
+} as const;

package/src/contract/client.ts

@@ -7,13 +7,14 @@
  * - 타입 안전 fetch 호출
  */
 
-import type { z } from "zod";
+import type { z } from "zod";
 import type {
   ContractSchema,
   ContractMethod,
   MethodRequestSchema,
 } from "./schema";
 import type { InferResponseSchema } from "./types";
+import { TIMEOUTS } from "../constants";
 
 /**
  * Client options for making requests
@@ -176,7 +177,7 @@ export function createClient<T extends ContractSchema>(
     baseUrl,
     headers: defaultHeaders = {},
     fetch: customFetch = fetch,
-    timeout = 30000,
+    timeout = TIMEOUTS.CLIENT_DEFAULT,
   } = options;
 
   const methods: ContractMethod[] = ["GET", "POST", "PUT", "PATCH", "DELETE"];
@@ -286,7 +287,7 @@ export async function contractFetch<
   const {
     headers: defaultHeaders = {},
     fetch: customFetch = fetch,
-    timeout = 30000,
+    timeout = TIMEOUTS.CLIENT_DEFAULT,
   } = clientOptions;
 
   // Build URL