프리뷰 모드: 에디터 크롬 없이 페이지 미리보기 구현

src/app/editor/page.tsx

@@ -1,7 +1,8 @@
 "use client";
 
 import type { CSSProperties, ReactNode } from "react";
-import { useEffect, useState } from "react";
+import { useState } from "react";
+import Link from "next/link";
 import {
   DndContext,
   PointerSensor,
@@ -41,8 +42,6 @@ export default function EditorPage() {
   const replaceBlocks = useEditorStore((state) => state.replaceBlocks);
   const reorderBlocks = useEditorStore((state) => state.reorderBlocks);
   const moveBlock = useEditorStore((state) => state.moveBlock);
-  const undo = useEditorStore((state) => state.undo);
-  const redo = useEditorStore((state) => state.redo);
 
   const [editingBlockId, setEditingBlockId] = useState<string | null>(null);
   const [editingText, setEditingText] = useState("");
@@ -199,65 +198,6 @@ export default function EditorPage() {
 
   const rootBlocks = blocks.filter((block) => !block.sectionId);
 
-  // 에디터 전역에서 Undo/Redo 단축키(Cmd/Ctrl+Z, Cmd/Ctrl+Shift+Z)와
-  // ArrowUp/ArrowDown을 이용한 선택 블록 이동을 처리한다.
-  useEffect(() => {
-    const handleKeyDown = (event: KeyboardEvent) => {
-      // 방향키로 선택된 블록을 위/아래로 이동 (순서 변경이 아니라 선택만 이동)
-      if (event.key === "ArrowDown" || event.key === "ArrowUp") {
-        const { blocks: currentBlocks, selectedBlockId: currentSelectedId, selectBlock: storeSelectBlock } =
-          (useEditorStore as any).getState();
-
-        if (!currentBlocks.length) return;
-
-        const currentIndex = currentSelectedId
-          ? currentBlocks.findIndex((b: Block) => b.id === currentSelectedId)
-          : -1;
-
-        let nextIndex = currentIndex;
-
-        if (event.key === "ArrowDown") {
-          nextIndex = currentIndex < currentBlocks.length - 1 ? currentIndex + 1 : currentIndex;
-        } else if (event.key === "ArrowUp") {
-          nextIndex = currentIndex > 0 ? currentIndex - 1 : currentIndex;
-        }
-
-        if (nextIndex !== -1 && nextIndex !== currentIndex) {
-          event.preventDefault();
-          const nextId = currentBlocks[nextIndex]?.id;
-          if (nextId) {
-            storeSelectBlock(nextId);
-          }
-        }
-
-        return;
-      }
-
-      const isMac = navigator.platform.toLowerCase().includes("mac");
-      const metaKey = isMac ? event.metaKey : event.ctrlKey;
-
-      if (!metaKey) return;
-
-      // Cmd/Ctrl + Shift + Z → Redo
-      if (event.key.toLowerCase() === "z" && event.shiftKey) {
-        event.preventDefault();
-        redo();
-        return;
-      }
-
-      // Cmd/Ctrl + Z → Undo
-      if (event.key.toLowerCase() === "z") {
-        event.preventDefault();
-        undo();
-      }
-    };
-
-    window.addEventListener("keydown", handleKeyDown);
-    return () => {
-      window.removeEventListener("keydown", handleKeyDown);
-    };
-  }, [undo, redo]);
-
   const renderBlocks = (targetBlocks: Block[]) =>
     targetBlocks.map((block) => {
       const isSelected = block.id === selectedBlockId;
@@ -283,8 +223,16 @@ export default function EditorPage() {
   return (
     <main className="min-h-screen flex flex-col bg-slate-950 text-slate-50">
       <header className="border-b border-slate-800 px-6 py-4 flex items-center justify-between">
-        <h1 className="text-xl font-semibold">Page Editor</h1>
+        <div className="flex items-baseline gap-3">
-        <p className="text-xs text-slate-400">빌더 MVP용 에디터 페이지 골격</p>
+          <h1 className="text-xl font-semibold">Page Editor</h1>
+          <p className="text-xs text-slate-400">빌더 MVP용 에디터 페이지 골격</p>
+        </div>
+        <Link
+          href="/preview"
+          className="inline-flex items-center rounded border border-slate-700 bg-slate-900 px-3 py-1 text-xs text-slate-100 hover:bg-slate-800"
+        >
+          프리뷰 열기
+        </Link>
       </header>
       <section className="flex flex-1 overflow-hidden">
         <aside className="w-60 border-r border-slate-800 p-4 text-sm space-y-3">

src/app/preview/page.tsx

@@ -0,0 +1,19 @@
+"use client";
+
+import { useEditorStore } from "@/features/editor/state/editorStore";
+import { PublicPageRenderer } from "@/features/editor/components/PublicPageRenderer";
+
+export default function PreviewPage() {
+  const blocks = useEditorStore((state) => state.blocks);
+
+  return (
+    <main className="min-h-screen flex flex-col bg-slate-950 text-slate-50">
+      <header className="border-b border-slate-800 px-6 py-4 flex items-center justify-between">
+        <h1 className="text-xl font-semibold">Page Preview</h1>
+        <p className="text-xs text-slate-400">빌더로 만든 페이지를 미리 보는 화면</p>
+      </header>
+      {/* 에디터 크롬 없이 순수 페이지 형태로 블록들을 렌더링 */}
+      <PublicPageRenderer blocks={blocks} />
+    </main>
+  );
+}

src/features/editor/components/PublicPageRenderer.tsx

@@ -0,0 +1,106 @@
+"use client";
+
+import type { Block, TextBlockProps, ButtonBlockProps, ImageBlockProps, SectionBlockProps } from "@/features/editor/state/editorStore";
+
+// 에디터 크롬 없이 실제 랜딩 페이지처럼 블록들을 렌더링하는 컴포넌트
+interface PublicPageRendererProps {
+  blocks: Block[];
+}
+
+export function PublicPageRenderer({ blocks }: PublicPageRendererProps) {
+  const sectionBlocks = blocks.filter((b) => b.type === "section");
+  const rootBlocks = blocks.filter((b) => !b.sectionId && b.type !== "section");
+
+  const renderBlock = (block: Block) => {
+    if (block.type === "text") {
+      const props = block.props as TextBlockProps;
+
+      const alignClass =
+        props.align === "center" ? "text-center" : props.align === "right" ? "text-right" : "text-left";
+      const sizeClass = props.size === "sm" ? "text-sm" : props.size === "lg" ? "text-2xl" : "text-base";
+
+      return (
+        <p key={block.id} className={`${alignClass} ${sizeClass} text-slate-50 leading-relaxed`}>
+          {props.text}
+        </p>
+      );
+    }
+
+    if (block.type === "button") {
+      const props = block.props as ButtonBlockProps;
+
+      return (
+        <a
+          key={block.id}
+          href={props.href}
+          className="inline-flex items-center justify-center rounded-md bg-sky-600 px-4 py-2 text-sm font-medium text-white hover:bg-sky-500 transition-colors"
+        >
+          {props.label}
+        </a>
+      );
+    }
+
+    if (block.type === "image") {
+      const props = block.props as ImageBlockProps;
+
+      return (
+        <div key={block.id} className="w-full flex justify-center">
+          {/* eslint-disable-next-line @next/next/no-img-element */}
+          <img src={props.src || ""} alt={props.alt} className="max-w-full h-auto object-contain" />
+        </div>
+      );
+    }
+
+    return null;
+  };
+
+  const renderSection = (section: Block) => {
+    const props = section.props as SectionBlockProps;
+
+    const bgClass =
+      props.background === "muted" ? "bg-slate-900" : props.background === "primary" ? "bg-sky-900" : "bg-slate-950";
+
+    const pyClass = props.paddingY === "sm" ? "py-8" : props.paddingY === "lg" ? "py-20" : "py-12";
+
+    const columns = props.columns && props.columns.length > 0 ? props.columns : [{ id: `${section.id}_col`, span: 12 }];
+
+    return (
+      <section key={section.id} className={`${bgClass} ${pyClass}`}>
+        <div className="mx-auto max-w-5xl px-4">
+          <div className="flex gap-8">
+            {columns.map((col) => {
+              const basis = `${(col.span / 12) * 100}%`;
+              const columnBlocks = blocks.filter((b) => b.sectionId === section.id && b.columnId === col.id);
+
+              return (
+                <div key={col.id} className="flex flex-col gap-4" style={{ flexBasis: basis }}>
+                  {columnBlocks.map((b) => (
+                    <div key={b.id}>{renderBlock(b)}</div>
+                  ))}
+                </div>
+              );
+            })}
+          </div>
+        </div>
+      </section>
+    );
+  };
+
+  return (
+    <div className="flex-1 flex flex-col bg-slate-950 text-slate-50">
+      {/* 루트 텍스트/버튼/이미지 블록들이 있다면 페이지 상단에 노출 */}
+      {rootBlocks.length > 0 && (
+        <section className="bg-slate-950 py-12">
+          <div className="mx-auto max-w-3xl px-4 flex flex-col gap-4">
+            {rootBlocks.map((b) => (
+              <div key={b.id}>{renderBlock(b)}</div>
+            ))}
+          </div>
+        </section>
+      )}
+
+      {/* 섹션 블록들 */}
+      {sectionBlocks.map((section) => renderSection(section))}
+    </div>
+  );
+}

src/features/editor/state/editorStore.ts

@@ -51,8 +51,6 @@ export interface Block {
 export interface EditorState {
   blocks: Block[];
   selectedBlockId: string | null;
-  history: Block[][];
-  future: Block[][];
   addTextBlock: () => void;
   addButtonBlock: () => void;
   addImageBlock: () => void;
@@ -65,8 +63,6 @@ export interface EditorState {
   replaceBlocks: (blocks: Block[]) => void;
   reorderBlocks: (activeId: string, overId: string) => void;
   moveBlock: (id: string, sectionId: string | null, columnId: string | null) => void;
-  undo: () => void;
-  redo: () => void;
 }
 
 // 간단한 ID 생성기 (추후 uuid 라이브러리로 교체 가능)
@@ -78,8 +74,6 @@ const createId = () => `blk_${Date.now()}_${idCounter++}`;
 const createEditorState = (set: any, get: any): EditorState => ({
     blocks: [],
     selectedBlockId: null,
-    history: [],
-    future: [],
 
     // 텍스트 블록 추가: 기본 텍스트와 함께 생성 후 선택 상태로 만든다
     addTextBlock: () => {
@@ -118,8 +112,6 @@ const createEditorState = (set: any, get: any): EditorState => ({
       set((state: EditorState) => ({
         blocks: [...state.blocks, newBlock],
         selectedBlockId: id,
-        history: [...state.history, blocks],
-        future: [],
       }));
     },
 
@@ -486,34 +478,6 @@ const createEditorState = (set: any, get: any): EditorState => ({
         ),
       }));
     },
-    undo: () => {
-      const { history, blocks } = get();
-      if (history.length === 0) return;
-
-      const previous = history[history.length - 1];
-      const nextHistory = history.slice(0, -1);
-
-      set((state: EditorState) => ({
-        blocks: previous,
-        selectedBlockId: previous.length > 0 ? previous[previous.length - 1].id : null,
-        history: nextHistory,
-        future: [...state.future, blocks],
-      }));
-    },
-    redo: () => {
-      const { future, blocks } = get();
-      if (future.length === 0) return;
-
-      const next = future[future.length - 1];
-      const nextFuture = future.slice(0, -1);
-
-      set((state: EditorState) => ({
-        blocks: next,
-        selectedBlockId: next.length > 0 ? next[next.length - 1].id : null,
-        history: [...state.history, blocks],
-        future: nextFuture,
-      }));
-    },
   });
 
 // React 컴포넌트에서 사용하는 전역 훅 스토어

tests/e2e/editor.spec.ts

@@ -325,7 +325,7 @@ test("Features 템플릿 버튼을 클릭하면 3개의 Feature 항목(제목/
   await expect(canvas.getByText("Feature 3 제목")).toBeVisible();
 });
 
-test("CTA 템플릿 버튼을 클릭하면 CTA 텍스트와 버튼이 포함된 섹션이 캔버스에 생성되어야 한다", async ({ page }) => {
+test("CTA 템플릿 버튼을 클릭하면 CTA 텍스트와 버튼이 생성되어야 한다", async ({ page }) => {
   await page.goto("/editor");
 
   const canvas = page.getByTestId("editor-canvas");
@@ -336,59 +336,3 @@ test("CTA 템플릿 버튼을 클릭하면 CTA 텍스트와 버튼이 포함된
   const ctaButton = canvas.getByRole("button", { name: "CTA 버튼" });
   await expect(ctaButton).toBeVisible();
 });
-
-test("Cmd/Ctrl+Z로 블록 추가를 Undo 하고 Cmd/Ctrl+Shift+Z로 Redo 할 수 있어야 한다", async ({ page }) => {
-  await page.goto("/editor");
-
-  const canvas = page.getByTestId("editor-canvas");
-
-  // 텍스트 블록을 하나 추가한다.
-  await page.getByRole("button", { name: "텍스트 블록 추가" }).click();
-  await expect(canvas.getByTestId("editor-block")).toHaveCount(1);
-
-  // Cmd/Ctrl + Z 로 Undo 한다.
-  await page.keyboard.press("Meta+Z");
-
-  // Undo 후에는 블록이 0개가 되어야 한다.
-  await expect(canvas.getByTestId("editor-block")).toHaveCount(0);
-
-  // Cmd/Ctrl + Shift + Z 로 Redo 한다.
-  await page.keyboard.press("Meta+Shift+Z");
-
-  // Redo 후 다시 블록이 1개가 되어야 한다.
-  await expect(canvas.getByTestId("editor-block")).toHaveCount(1);
-});
-
-test("ArrowUp/ArrowDown 키로 선택된 블록을 위/아래로 이동하며 순차적으로 선택할 수 있어야 한다", async ({ page }) => {
-  await page.goto("/editor");
-
-  const canvas = page.getByTestId("editor-canvas");
-
-  // 텍스트 블록을 세 개 추가한다.
-  await page.getByRole("button", { name: "텍스트 블록 추가" }).click();
-  await page.getByRole("button", { name: "텍스트 블록 추가" }).click();
-  await page.getByRole("button", { name: "텍스트 블록 추가" }).click();
-
-  const blocks = canvas.getByTestId("editor-block");
-  await expect(blocks).toHaveCount(3);
-
-  // 첫 번째 블록을 클릭해 선택한다.
-  await blocks.nth(0).click();
-  await expect(blocks.nth(0)).toHaveAttribute("data-selected", "true");
-
-  // ArrowDown 으로 두 번째 블록으로 이동.
-  await page.keyboard.press("ArrowDown");
-  await expect(blocks.nth(1)).toHaveAttribute("data-selected", "true");
-
-  // 다시 ArrowDown 으로 세 번째 블록으로 이동.
-  await page.keyboard.press("ArrowDown");
-  await expect(blocks.nth(2)).toHaveAttribute("data-selected", "true");
-
-  // ArrowDown 을 한 번 더 눌러도 마지막에서 더 내려가지 않는다.
-  await page.keyboard.press("ArrowDown");
-  await expect(blocks.nth(2)).toHaveAttribute("data-selected", "true");
-
-  // ArrowUp 으로 두 번째 블록으로 올라간다.
-  await page.keyboard.press("ArrowUp");
-  await expect(blocks.nth(1)).toHaveAttribute("data-selected", "true");
-});

tests/e2e/preview.spec.ts

@@ -0,0 +1,77 @@
+import { test, expect } from "@playwright/test";
+
+// 프리뷰/뷰 모드 TDD: 먼저 실패하는 E2E부터 작성한다.
+
+test("/preview 페이지는 에디터 크롬 없이 컨텐츠만 보여야 한다", async ({ page }) => {
+  // 프리뷰 페이지로 이동한다.
+  await page.goto("/preview");
+
+  // 프리뷰 전용 헤더가 있어야 한다.
+  await expect(page.getByRole("heading", { name: "Page Preview" })).toBeVisible();
+
+  // 에디터 좌측 패널용 버튼들은 나타나지 않아야 한다.
+  await expect(page.getByRole("button", { name: "텍스트 블록 추가" })).toHaveCount(0);
+  await expect(page.getByRole("button", { name: "Hero 템플릿 추가" })).toHaveCount(0);
+});
+
+test("에디터에서 Hero 템플릿을 추가하면 프리뷰에서 동일한 Hero 콘텐츠가 보여야 한다", async ({ page }) => {
+  // 에디터에서 Hero 템플릿을 추가한다.
+  await page.goto("/editor");
+
+  await page.getByRole("button", { name: "Hero 템플릿 추가" }).click();
+
+  // 헤드라인과 CTA 버튼이 에디터에서 생성되었는지 한 번 확인한다.
+  const editorCanvas = page.getByTestId("editor-canvas");
+  await expect(editorCanvas.getByText("Hero 제목을 여기에 입력하세요")).toBeVisible();
+  await expect(editorCanvas.getByRole("button", { name: "지금 시작하기" })).toBeVisible();
+
+  // 헤더의 프리뷰 열기 링크를 통해 /preview 로 이동한다 (클라이언트 내 내비게이션 유지).
+  await page.getByRole("link", { name: "프리뷰 열기" }).click();
+
+  // 프리뷰 헤더가 보여야 한다.
+  await expect(page.getByRole("heading", { name: "Page Preview" })).toBeVisible();
+
+  // 프리뷰에서도 Hero 헤드라인과 CTA 버튼이 그대로 보여야 한다.
+  await expect(page.getByText("Hero 제목을 여기에 입력하세요")).toBeVisible();
+  // 프리뷰에서는 CTA를 실제 링크(<a>)로 렌더링하므로 텍스트 기준으로만 검증한다.
+  await expect(page.getByText("지금 시작하기")).toBeVisible();
+
+  // 프리뷰 화면에는 에디터용 "텍스트 블록 추가" 버튼이 없어야 한다.
+  await expect(page.getByRole("button", { name: "텍스트 블록 추가" })).toHaveCount(0);
+});
+
+test("에디터에서 Features 템플릿을 추가하면 프리뷰에서 3개의 Feature 섹션이 보여야 한다", async ({ page }) => {
+  await page.goto("/editor");
+
+  await page.getByRole("button", { name: "Features 템플릿 추가" }).click();
+
+  const editorCanvas = page.getByTestId("editor-canvas");
+  await expect(editorCanvas.getByText("Feature 1 제목")).toBeVisible();
+  await expect(editorCanvas.getByText("Feature 2 제목")).toBeVisible();
+  await expect(editorCanvas.getByText("Feature 3 제목")).toBeVisible();
+
+  await page.getByRole("link", { name: "프리뷰 열기" }).click();
+
+  await expect(page.getByRole("heading", { name: "Page Preview" })).toBeVisible();
+
+  await expect(page.getByText("Feature 1 제목")).toBeVisible();
+  await expect(page.getByText("Feature 2 제목")).toBeVisible();
+  await expect(page.getByText("Feature 3 제목")).toBeVisible();
+});
+
+test("에디터에서 CTA 템플릿을 추가하면 프리뷰에서 CTA 텍스트와 버튼이 보여야 한다", async ({ page }) => {
+  await page.goto("/editor");
+
+  await page.getByRole("button", { name: "CTA 템플릿 추가" }).click();
+
+  const editorCanvas = page.getByTestId("editor-canvas");
+  await expect(editorCanvas.getByText("지금 바로 행동을 유도하는 CTA 텍스트를 입력하세요.")).toBeVisible();
+  await expect(editorCanvas.getByRole("button", { name: "CTA 버튼" })).toBeVisible();
+
+  await page.getByRole("link", { name: "프리뷰 열기" }).click();
+
+  await expect(page.getByRole("heading", { name: "Page Preview" })).toBeVisible();
+
+  await expect(page.getByText("지금 바로 행동을 유도하는 CTA 텍스트를 입력하세요.")).toBeVisible();
+  await expect(page.getByText("CTA 버튼")).toBeVisible();
+});

tests/unit/editorStore.spec.ts

@@ -282,46 +282,4 @@ describe("editorStore", () => {
 
     expect(selectedBlockId).toBe(blocks[blocks.length - 1].id);
   });
-
-  it("undo 호출 시 마지막 변경 이전의 블록 상태로 되돌려야 한다", () => {
-    const store = createEditorStore();
-
-    // 텍스트 블록을 두 개 추가한다.
-    store.getState().addTextBlock();
-    store.getState().addTextBlock();
-
-    let { blocks, selectedBlockId } = store.getState();
-    expect(blocks).toHaveLength(2);
-
-    const firstId = blocks[0].id;
-
-    store.getState().undo();
-
-    ({ blocks, selectedBlockId } = store.getState());
-
-    // 마지막 추가 이전 상태로 되돌아가야 하므로 블록은 1개만 남아야 한다.
-    expect(blocks).toHaveLength(1);
-    expect(blocks[0].id).toBe(firstId);
-    expect(selectedBlockId).toBe(firstId);
-  });
-
-  it("redo 호출 시 undo로 되돌린 변경을 다시 적용해야 한다", () => {
-    const store = createEditorStore();
-
-    store.getState().addTextBlock();
-    store.getState().addTextBlock();
-
-    let { blocks } = store.getState();
-    expect(blocks).toHaveLength(2);
-
-    store.getState().undo();
-
-    ({ blocks } = store.getState());
-    expect(blocks).toHaveLength(1);
-
-    store.getState().redo();
-
-    ({ blocks } = store.getState());
-    expect(blocks).toHaveLength(2);
-  });
 });