@mandujs/core 0.12.1 → 0.13.0

package/src/change/snapshot.ts

@@ -11,6 +11,7 @@ import {
 } from "../lockfile";
 import { validateAndReport } from "../config";
 
+const MANDU_DIR = ".mandu";
 const SPEC_DIR = "spec";
 const MANIFEST_FILE = "routes.manifest.json";
 const LOCK_FILE = "spec.lock.json";
@@ -33,7 +34,7 @@ function generateSnapshotId(): string {
  * 스냅샷 저장 경로 반환
  */
 function getSnapshotPath(rootDir: string, snapshotId: string): string {
-  return path.join(rootDir, SPEC_DIR, HISTORY_DIR, SNAPSHOTS_DIR, `${snapshotId}.snapshot.json`);
+  return path.join(rootDir, MANDU_DIR, HISTORY_DIR, SNAPSHOTS_DIR, `${snapshotId}.snapshot.json`);
 }
 
 /**
@@ -71,9 +72,9 @@ async function collectSlotContents(rootDir: string): Promise<Record<string, stri
  * 현재 spec 상태의 스냅샷 생성
  */
 export async function createSnapshot(rootDir: string): Promise<Snapshot> {
-  const specDir = path.join(rootDir, SPEC_DIR);
-  const manifestPath = path.join(specDir, MANIFEST_FILE);
-  const lockPath = path.join(specDir, LOCK_FILE);
+  const manduDir = path.join(rootDir, MANDU_DIR);
+  const manifestPath = path.join(manduDir, MANIFEST_FILE);
+  const lockPath = path.join(manduDir, LOCK_FILE);
 
   // Manifest 읽기 (필수)
   const manifestFile = Bun.file(manifestPath);
@@ -168,10 +169,10 @@ export async function readSnapshotById(rootDir: string, snapshotId: string): Pro
  * 스냅샷으로부터 상태 복원
  */
 export async function restoreSnapshot(rootDir: string, snapshot: Snapshot): Promise<RestoreResult> {
-  const specDir = path.join(rootDir, SPEC_DIR);
-  const manifestPath = path.join(specDir, MANIFEST_FILE);
-  const lockPath = path.join(specDir, LOCK_FILE);
-  const slotsDir = path.join(specDir, SLOTS_DIR);
+  const manduDir = path.join(rootDir, MANDU_DIR);
+  const manifestPath = path.join(manduDir, MANIFEST_FILE);
+  const lockPath = path.join(manduDir, LOCK_FILE);
+  const slotsDir = path.join(rootDir, SPEC_DIR, SLOTS_DIR);
 
   const restoredFiles: string[] = [];
   const failedFiles: string[] = [];
@@ -258,7 +259,7 @@ export async function deleteSnapshot(rootDir: string, snapshotId: string): Promi
  * 모든 스냅샷 ID 목록 조회
  */
 export async function listSnapshotIds(rootDir: string): Promise<string[]> {
-  const snapshotsDir = path.join(rootDir, SPEC_DIR, HISTORY_DIR, SNAPSHOTS_DIR);
+  const snapshotsDir = path.join(rootDir, MANDU_DIR, HISTORY_DIR, SNAPSHOTS_DIR);
 
   try {
     const entries = await Array.fromAsync(

package/src/change/transaction.ts

@@ -8,7 +8,7 @@ import type {
 } from "./types";
 import { createSnapshot, writeSnapshot, readSnapshotById, restoreSnapshot } from "./snapshot";
 
-const SPEC_DIR = "spec";
+const MANDU_DIR = ".mandu";
 const HISTORY_DIR = "history";
 const CHANGES_FILE = "changes.json";
 const ACTIVE_FILE = "active.json";
@@ -28,7 +28,7 @@ function generateChangeId(): string {
  * History 디렉토리 경로
  */
 function getHistoryDir(rootDir: string): string {
-  return path.join(rootDir, SPEC_DIR, HISTORY_DIR);
+  return path.join(rootDir, MANDU_DIR, HISTORY_DIR);
 }
 
 /**

package/src/client/Link.tsx

@@ -1,227 +1,227 @@
-/**
- * Mandu Link Component 🔗
- * Client-side 네비게이션을 위한 Link 컴포넌트
- */
-
-import React, {
-  type AnchorHTMLAttributes,
-  type MouseEvent,
-  type ReactNode,
-  useCallback,
-  useEffect,
-  useRef,
-} from "react";
-import { navigate, prefetch } from "./router";
-
-export interface LinkProps
-  extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
-  /** 이동할 URL */
-  href: string;
-  /** history.replaceState 사용 여부 */
-  replace?: boolean;
-  /** 마우스 hover 시 prefetch 여부 */
-  prefetch?: boolean;
-  /** 스크롤 위치 복원 여부 (기본: true) */
-  scroll?: boolean;
-  /** 자식 요소 */
-  children?: ReactNode;
-}
-
-/**
- * Client-side 네비게이션 Link 컴포넌트
- *
- * @example
- * ```tsx
- * import { Link } from "@mandujs/core/client";
- *
- * // 기본 사용
- * <Link href="/about">About</Link>
- *
- * // Prefetch 활성화
- * <Link href="/users" prefetch>Users</Link>
- *
- * // Replace 모드 (뒤로가기 히스토리 없음)
- * <Link href="/login" replace>Login</Link>
- * ```
- */
-export function Link({
-  href,
-  replace = false,
-  prefetch: shouldPrefetch = false,
-  scroll = true,
-  children,
-  onClick,
-  onMouseEnter,
-  onFocus,
-  ...rest
-}: LinkProps): React.ReactElement {
-  const prefetchedRef = useRef(false);
-
-  // 클릭 핸들러
-  const handleClick = useCallback(
-    (event: MouseEvent<HTMLAnchorElement>) => {
-      // 사용자 정의 onClick 먼저 실행
-      onClick?.(event);
-
-      // 기본 동작 방지 조건
-      if (
-        event.defaultPrevented ||
-        event.button !== 0 ||
-        event.metaKey ||
-        event.altKey ||
-        event.ctrlKey ||
-        event.shiftKey
-      ) {
-        return;
-      }
-
-      // 외부 링크 체크
-      try {
-        const url = new URL(href, window.location.origin);
-        if (url.origin !== window.location.origin) {
-          return; // 외부 링크는 기본 동작
-        }
-      } catch {
-        return;
-      }
-
-      // Client-side 네비게이션
-      event.preventDefault();
-      navigate(href, { replace, scroll });
-    },
-    [href, replace, scroll, onClick]
-  );
-
-  // Prefetch 실행
-  const doPrefetch = useCallback(() => {
-    if (!shouldPrefetch || prefetchedRef.current) return;
-
-    try {
-      const url = new URL(href, window.location.origin);
-      if (url.origin === window.location.origin) {
-        prefetch(href);
-        prefetchedRef.current = true;
-      }
-    } catch {
-      // 무시
-    }
-  }, [href, shouldPrefetch]);
-
-  // 마우스 hover 핸들러
-  const handleMouseEnter = useCallback(
-    (event: MouseEvent<HTMLAnchorElement>) => {
-      onMouseEnter?.(event);
-      doPrefetch();
-    },
-    [onMouseEnter, doPrefetch]
-  );
-
-  // 포커스 핸들러 (키보드 네비게이션)
-  const handleFocus = useCallback(
-    (event: React.FocusEvent<HTMLAnchorElement>) => {
-      onFocus?.(event);
-      doPrefetch();
-    },
-    [onFocus, doPrefetch]
-  );
-
-  // Viewport 진입 시 prefetch (IntersectionObserver)
-  useEffect(() => {
-    if (!shouldPrefetch || typeof IntersectionObserver === "undefined") {
-      return;
-    }
-
-    // ref가 없으면 무시 (SSR)
-    return;
-  }, [shouldPrefetch]);
-
-  return (
-    <a
-      href={href}
-      onClick={handleClick}
-      onMouseEnter={handleMouseEnter}
-      onFocus={handleFocus}
-      data-mandu-link=""
-      {...rest}
-    >
-      {children}
-    </a>
-  );
-}
-
-/**
- * NavLink - 현재 경로와 일치할 때 활성 스타일 적용
- *
- * @example
- * ```tsx
- * import { NavLink } from "@mandujs/core/client";
- *
- * <NavLink
- *   href="/about"
- *   className={({ isActive }) => isActive ? "active" : ""}
- * >
- *   About
- * </NavLink>
- * ```
- */
-export interface NavLinkProps extends Omit<LinkProps, "className" | "style"> {
-  /** 활성 상태에 따른 className */
-  className?: string | ((props: { isActive: boolean }) => string);
-  /** 활성 상태에 따른 style */
-  style?:
-    | React.CSSProperties
-    | ((props: { isActive: boolean }) => React.CSSProperties);
-  /** 활성 상태일 때 적용할 style (style과 병합됨) */
-  activeStyle?: React.CSSProperties;
-  /** 활성 상태일 때 추가할 className */
-  activeClassName?: string;
-  /** 정확히 일치해야 활성화 (기본: false) */
-  exact?: boolean;
-}
-
-export function NavLink({
-  href,
-  className,
-  style,
-  activeStyle,
-  activeClassName,
-  exact = false,
-  ...rest
-}: NavLinkProps): React.ReactElement {
-  // 현재 경로와 비교
-  const isActive =
-    typeof window !== "undefined"
-      ? exact
-        ? window.location.pathname === href
-        : window.location.pathname.startsWith(href)
-      : false;
-
-  // className 처리
-  let resolvedClassName =
-    typeof className === "function" ? className({ isActive }) : className;
-
-  if (isActive && activeClassName) {
-    resolvedClassName = resolvedClassName
-      ? `${resolvedClassName} ${activeClassName}`
-      : activeClassName;
-  }
-
-  // style 처리
-  let resolvedStyle =
-    typeof style === "function" ? style({ isActive }) : style;
-
-  if (isActive && activeStyle) {
-    resolvedStyle = { ...resolvedStyle, ...activeStyle };
-  }
-
-  return (
-    <Link
-      href={href}
-      className={resolvedClassName}
-      style={resolvedStyle}
-      {...rest}
-    />
-  );
-}
-
-export default Link;
+/**
+ * Mandu Link Component 🔗
+ * Client-side 네비게이션을 위한 Link 컴포넌트
+ */
+
+import React, {
+  type AnchorHTMLAttributes,
+  type MouseEvent,
+  type ReactNode,
+  useCallback,
+  useEffect,
+  useRef,
+} from "react";
+import { navigate, prefetch } from "./router";
+
+export interface LinkProps
+  extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+  /** 이동할 URL */
+  href: string;
+  /** history.replaceState 사용 여부 */
+  replace?: boolean;
+  /** 마우스 hover 시 prefetch 여부 */
+  prefetch?: boolean;
+  /** 스크롤 위치 복원 여부 (기본: true) */
+  scroll?: boolean;
+  /** 자식 요소 */
+  children?: ReactNode;
+}
+
+/**
+ * Client-side 네비게이션 Link 컴포넌트
+ *
+ * @example
+ * ```tsx
+ * import { Link } from "@mandujs/core/client";
+ *
+ * // 기본 사용
+ * <Link href="/about">About</Link>
+ *
+ * // Prefetch 활성화
+ * <Link href="/users" prefetch>Users</Link>
+ *
+ * // Replace 모드 (뒤로가기 히스토리 없음)
+ * <Link href="/login" replace>Login</Link>
+ * ```
+ */
+export function Link({
+  href,
+  replace = false,
+  prefetch: shouldPrefetch = false,
+  scroll = true,
+  children,
+  onClick,
+  onMouseEnter,
+  onFocus,
+  ...rest
+}: LinkProps): React.ReactElement {
+  const prefetchedRef = useRef(false);
+
+  // 클릭 핸들러
+  const handleClick = useCallback(
+    (event: MouseEvent<HTMLAnchorElement>) => {
+      // 사용자 정의 onClick 먼저 실행
+      onClick?.(event);
+
+      // 기본 동작 방지 조건
+      if (
+        event.defaultPrevented ||
+        event.button !== 0 ||
+        event.metaKey ||
+        event.altKey ||
+        event.ctrlKey ||
+        event.shiftKey
+      ) {
+        return;
+      }
+
+      // 외부 링크 체크
+      try {
+        const url = new URL(href, window.location.origin);
+        if (url.origin !== window.location.origin) {
+          return; // 외부 링크는 기본 동작
+        }
+      } catch {
+        return;
+      }
+
+      // Client-side 네비게이션
+      event.preventDefault();
+      navigate(href, { replace, scroll });
+    },
+    [href, replace, scroll, onClick]
+  );
+
+  // Prefetch 실행
+  const doPrefetch = useCallback(() => {
+    if (!shouldPrefetch || prefetchedRef.current) return;
+
+    try {
+      const url = new URL(href, window.location.origin);
+      if (url.origin === window.location.origin) {
+        prefetch(href);
+        prefetchedRef.current = true;
+      }
+    } catch {
+      // 무시
+    }
+  }, [href, shouldPrefetch]);
+
+  // 마우스 hover 핸들러
+  const handleMouseEnter = useCallback(
+    (event: MouseEvent<HTMLAnchorElement>) => {
+      onMouseEnter?.(event);
+      doPrefetch();
+    },
+    [onMouseEnter, doPrefetch]
+  );
+
+  // 포커스 핸들러 (키보드 네비게이션)
+  const handleFocus = useCallback(
+    (event: React.FocusEvent<HTMLAnchorElement>) => {
+      onFocus?.(event);
+      doPrefetch();
+    },
+    [onFocus, doPrefetch]
+  );
+
+  // Viewport 진입 시 prefetch (IntersectionObserver)
+  useEffect(() => {
+    if (!shouldPrefetch || typeof IntersectionObserver === "undefined") {
+      return;
+    }
+
+    // ref가 없으면 무시 (SSR)
+    return;
+  }, [shouldPrefetch]);
+
+  return (
+    <a
+      href={href}
+      onClick={handleClick}
+      onMouseEnter={handleMouseEnter}
+      onFocus={handleFocus}
+      data-mandu-link=""
+      {...rest}
+    >
+      {children}
+    </a>
+  );
+}
+
+/**
+ * NavLink - 현재 경로와 일치할 때 활성 스타일 적용
+ *
+ * @example
+ * ```tsx
+ * import { NavLink } from "@mandujs/core/client";
+ *
+ * <NavLink
+ *   href="/about"
+ *   className={({ isActive }) => isActive ? "active" : ""}
+ * >
+ *   About
+ * </NavLink>
+ * ```
+ */
+export interface NavLinkProps extends Omit<LinkProps, "className" | "style"> {
+  /** 활성 상태에 따른 className */
+  className?: string | ((props: { isActive: boolean }) => string);
+  /** 활성 상태에 따른 style */
+  style?:
+    | React.CSSProperties
+    | ((props: { isActive: boolean }) => React.CSSProperties);
+  /** 활성 상태일 때 적용할 style (style과 병합됨) */
+  activeStyle?: React.CSSProperties;
+  /** 활성 상태일 때 추가할 className */
+  activeClassName?: string;
+  /** 정확히 일치해야 활성화 (기본: false) */
+  exact?: boolean;
+}
+
+export function NavLink({
+  href,
+  className,
+  style,
+  activeStyle,
+  activeClassName,
+  exact = false,
+  ...rest
+}: NavLinkProps): React.ReactElement {
+  // 현재 경로와 비교
+  const isActive =
+    typeof window !== "undefined"
+      ? exact
+        ? window.location.pathname === href
+        : window.location.pathname.startsWith(href)
+      : false;
+
+  // className 처리
+  let resolvedClassName =
+    typeof className === "function" ? className({ isActive }) : className;
+
+  if (isActive && activeClassName) {
+    resolvedClassName = resolvedClassName
+      ? `${resolvedClassName} ${activeClassName}`
+      : activeClassName;
+  }
+
+  // style 처리
+  let resolvedStyle =
+    typeof style === "function" ? style({ isActive }) : style;
+
+  if (isActive && activeStyle) {
+    resolvedStyle = { ...resolvedStyle, ...activeStyle };
+  }
+
+  return (
+    <Link
+      href={href}
+      className={resolvedClassName}
+      style={resolvedStyle}
+      {...rest}
+    />
+  );
+}
+
+export default Link;

package/src/client/globals.ts

@@ -1,44 +1,44 @@
-/**
- * Mandu 전역 타입 선언
- * 클라이언트 측 전역 상태의 타입 정의
- */
-import type { Root } from "react-dom/client";
-import type { RouterState } from "./router";
-
-interface ManduRouteInfo {
-  id: string;
-  pattern: string;
-  params: Record<string, string>;
-}
-
-interface ManduDataEntry {
-  serverData: unknown;
-  timestamp?: number;
-}
-
-declare global {
-  interface Window {
-    /** 서버에서 전달된 데이터 (routeId → data) */
-    __MANDU_DATA__?: Record<string, ManduDataEntry>;
-
-    /** 직렬화된 서버 데이터 (raw JSON) */
-    __MANDU_DATA_RAW__?: string;
-
-    /** 현재 라우트 정보 */
-    __MANDU_ROUTE__?: ManduRouteInfo;
-
-    /** 클라이언트 라우터 상태 */
-    __MANDU_ROUTER_STATE__?: RouterState;
-
-    /** 라우터 상태 변경 리스너 */
-    __MANDU_ROUTER_LISTENERS__?: Set<(state: RouterState) => void>;
-
-    /** Hydrated roots 추적 (unmount용) */
-    __MANDU_ROOTS__?: Map<string, Root>;
-
-    /** React 인스턴스 공유 */
-    __MANDU_REACT__?: typeof import("react");
-  }
-}
-
-export {};
+/**
+ * Mandu 전역 타입 선언
+ * 클라이언트 측 전역 상태의 타입 정의
+ */
+import type { Root } from "react-dom/client";
+import type { RouterState } from "./router";
+
+interface ManduRouteInfo {
+  id: string;
+  pattern: string;
+  params: Record<string, string>;
+}
+
+interface ManduDataEntry {
+  serverData: unknown;
+  timestamp?: number;
+}
+
+declare global {
+  interface Window {
+    /** 서버에서 전달된 데이터 (routeId → data) */
+    __MANDU_DATA__?: Record<string, ManduDataEntry>;
+
+    /** 직렬화된 서버 데이터 (raw JSON) */
+    __MANDU_DATA_RAW__?: string;
+
+    /** 현재 라우트 정보 */
+    __MANDU_ROUTE__?: ManduRouteInfo;
+
+    /** 클라이언트 라우터 상태 */
+    __MANDU_ROUTER_STATE__?: RouterState;
+
+    /** 라우터 상태 변경 리스너 */
+    __MANDU_ROUTER_LISTENERS__?: Set<(state: RouterState) => void>;
+
+    /** Hydrated roots 추적 (unmount용) */
+    __MANDU_ROOTS__?: Map<string, Root>;
+
+    /** React 인스턴스 공유 */
+    __MANDU_REACT__?: typeof import("react");
+  }
+}
+
+export {};