Compare commits

...

2 Commits

4 changed files with 577 additions and 1 deletions
+89 -1
View File
@@ -1,7 +1,7 @@
"use client"; "use client";
import type { CSSProperties, ReactNode } from "react"; import type { CSSProperties, ReactNode } from "react";
import { useState } from "react"; import { useEffect, useState } from "react";
import { import {
DndContext, DndContext,
PointerSensor, PointerSensor,
@@ -33,11 +33,16 @@ export default function EditorPage() {
const addButtonBlock = useEditorStore((state) => state.addButtonBlock); const addButtonBlock = useEditorStore((state) => state.addButtonBlock);
const addImageBlock = useEditorStore((state) => state.addImageBlock); const addImageBlock = useEditorStore((state) => state.addImageBlock);
const addSectionBlock = useEditorStore((state) => state.addSectionBlock); const addSectionBlock = useEditorStore((state) => state.addSectionBlock);
const addHeroTemplateSection = useEditorStore((state) => state.addHeroTemplateSection);
const addFeaturesTemplateSection = useEditorStore((state) => state.addFeaturesTemplateSection);
const addCtaTemplateSection = useEditorStore((state) => state.addCtaTemplateSection);
const updateBlock = useEditorStore((state) => state.updateBlock); const updateBlock = useEditorStore((state) => state.updateBlock);
const selectBlock = useEditorStore((state) => state.selectBlock); const selectBlock = useEditorStore((state) => state.selectBlock);
const replaceBlocks = useEditorStore((state) => state.replaceBlocks); const replaceBlocks = useEditorStore((state) => state.replaceBlocks);
const reorderBlocks = useEditorStore((state) => state.reorderBlocks); const reorderBlocks = useEditorStore((state) => state.reorderBlocks);
const moveBlock = useEditorStore((state) => state.moveBlock); 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 [editingBlockId, setEditingBlockId] = useState<string | null>(null);
const [editingText, setEditingText] = useState(""); const [editingText, setEditingText] = useState("");
@@ -194,6 +199,65 @@ export default function EditorPage() {
const rootBlocks = blocks.filter((block) => !block.sectionId); 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[]) => const renderBlocks = (targetBlocks: Block[]) =>
targetBlocks.map((block) => { targetBlocks.map((block) => {
const isSelected = block.id === selectedBlockId; const isSelected = block.id === selectedBlockId;
@@ -253,6 +317,30 @@ export default function EditorPage() {
> >
</button> </button>
<div className="pt-3 border-t border-slate-800 mt-3 space-y-2">
<h3 className="text-[11px] font-medium text-slate-300">릿</h3>
<button
type="button"
className="w-full rounded border border-sky-700 bg-sky-950 px-3 py-2 text-left text-xs text-sky-100 hover:bg-sky-900"
onClick={addHeroTemplateSection}
>
Hero 릿
</button>
<button
type="button"
className="w-full rounded border border-slate-700 bg-slate-900 px-3 py-2 text-left text-xs hover:bg-slate-800"
onClick={addFeaturesTemplateSection}
>
Features 릿
</button>
<button
type="button"
className="w-full rounded border border-slate-700 bg-slate-900 px-3 py-2 text-left text-xs hover:bg-slate-800"
onClick={addCtaTemplateSection}
>
CTA 릿
</button>
</div>
<p className="text-xs text-slate-500"> <p className="text-xs text-slate-500">
Text / Image / Button / Section . Text / Image / Button / Section .
</p> </p>
+237
View File
@@ -51,15 +51,22 @@ export interface Block {
export interface EditorState { export interface EditorState {
blocks: Block[]; blocks: Block[];
selectedBlockId: string | null; selectedBlockId: string | null;
history: Block[][];
future: Block[][];
addTextBlock: () => void; addTextBlock: () => void;
addButtonBlock: () => void; addButtonBlock: () => void;
addImageBlock: () => void; addImageBlock: () => void;
addSectionBlock: () => void; addSectionBlock: () => void;
addHeroTemplateSection: () => void;
addFeaturesTemplateSection: () => void;
addCtaTemplateSection: () => void;
updateBlock: (id: string, partial: Partial<TextBlockProps & ButtonBlockProps>) => void; updateBlock: (id: string, partial: Partial<TextBlockProps & ButtonBlockProps>) => void;
selectBlock: (id: string | null) => void; selectBlock: (id: string | null) => void;
replaceBlocks: (blocks: Block[]) => void; replaceBlocks: (blocks: Block[]) => void;
reorderBlocks: (activeId: string, overId: string) => void; reorderBlocks: (activeId: string, overId: string) => void;
moveBlock: (id: string, sectionId: string | null, columnId: string | null) => void; moveBlock: (id: string, sectionId: string | null, columnId: string | null) => void;
undo: () => void;
redo: () => void;
} }
// 간단한 ID 생성기 (추후 uuid 라이브러리로 교체 가능) // 간단한 ID 생성기 (추후 uuid 라이브러리로 교체 가능)
@@ -71,6 +78,8 @@ const createId = () => `blk_${Date.now()}_${idCounter++}`;
const createEditorState = (set: any, get: any): EditorState => ({ const createEditorState = (set: any, get: any): EditorState => ({
blocks: [], blocks: [],
selectedBlockId: null, selectedBlockId: null,
history: [],
future: [],
// 텍스트 블록 추가: 기본 텍스트와 함께 생성 후 선택 상태로 만든다 // 텍스트 블록 추가: 기본 텍스트와 함께 생성 후 선택 상태로 만든다
addTextBlock: () => { addTextBlock: () => {
@@ -109,9 +118,209 @@ const createEditorState = (set: any, get: any): EditorState => ({
set((state: EditorState) => ({ set((state: EditorState) => ({
blocks: [...state.blocks, newBlock], blocks: [...state.blocks, newBlock],
selectedBlockId: id, selectedBlockId: id,
history: [...state.history, blocks],
future: [],
})); }));
}, },
// Hero 템플릿 섹션 추가: 섹션 1개와 기본 텍스트/버튼 블록들을 첫 컬럼에 배치한다
addHeroTemplateSection: () => {
const sectionId = createId();
// Hero 템플릿용 섹션: 기본 배경/패딩 + 1컬럼(12)
const sectionBlock: Block = {
id: sectionId,
type: "section",
props: {
background: "default",
paddingY: "lg",
columns: [
{
id: `${sectionId}_col_1`,
span: 12,
},
],
},
sectionId: null,
columnId: null,
};
const firstColumnId = `${sectionId}_col_1`;
// Hero 텍스트 블록 (예: 헤드라인)
const heroHeadlineId = createId();
const heroHeadline: Block = {
id: heroHeadlineId,
type: "text",
props: {
text: "Hero 제목을 여기에 입력하세요",
align: "center",
size: "lg",
},
sectionId,
columnId: firstColumnId,
};
// Hero 서브텍스트 블록
const heroSubId = createId();
const heroSub: Block = {
id: heroSubId,
type: "text",
props: {
text: "제품이나 서비스를 한 문장으로 설명하는 서브텍스트입니다.",
align: "center",
size: "base",
},
sectionId,
columnId: firstColumnId,
};
// CTA 버튼 블록
const heroButtonId = createId();
const heroButton: Block = {
id: heroButtonId,
type: "button",
props: {
label: "지금 시작하기",
href: "#",
},
sectionId,
columnId: firstColumnId,
};
set((state: EditorState) => {
const newBlocks = [...state.blocks, sectionBlock, heroHeadline, heroSub, heroButton];
return {
blocks: newBlocks,
selectedBlockId: heroButtonId,
};
});
},
// Features 템플릿 섹션 추가: 3컬럼(4/4/4) 섹션과 각 컬럼의 제목/설명 텍스트를 생성한다
addFeaturesTemplateSection: () => {
const sectionId = createId();
const columns = [
{ id: `${sectionId}_col_1`, span: 4 },
{ id: `${sectionId}_col_2`, span: 4 },
{ id: `${sectionId}_col_3`, span: 4 },
];
const sectionBlock: Block = {
id: sectionId,
type: "section",
props: {
background: "muted",
paddingY: "md",
columns,
},
sectionId: null,
columnId: null,
};
const featureBlocks: Block[] = columns.flatMap((col, index) => {
const titleId = createId();
const descId = createId();
const title: Block = {
id: titleId,
type: "text",
props: {
text: `Feature ${index + 1} 제목`,
align: "left",
size: "lg",
},
sectionId,
columnId: col.id,
};
const description: Block = {
id: descId,
type: "text",
props: {
text: "해당 기능을 간단히 설명하는 텍스트입니다.",
align: "left",
size: "sm",
},
sectionId,
columnId: col.id,
};
return [title, description];
});
const lastBlockId = featureBlocks[featureBlocks.length - 1].id;
set((state: EditorState) => {
const newBlocks = [...state.blocks, sectionBlock, ...featureBlocks];
return {
blocks: newBlocks,
selectedBlockId: lastBlockId,
};
});
},
// CTA 템플릿 섹션 추가: 텍스트와 버튼이 포함된 1컬럼 섹션을 생성한다
addCtaTemplateSection: () => {
const sectionId = createId();
const sectionBlock: Block = {
id: sectionId,
type: "section",
props: {
background: "primary",
paddingY: "md",
columns: [
{
id: `${sectionId}_col_1`,
span: 12,
},
],
},
sectionId: null,
columnId: null,
};
const firstColumnId = `${sectionId}_col_1`;
const textId = createId();
const textBlock: Block = {
id: textId,
type: "text",
props: {
text: "지금 바로 행동을 유도하는 CTA 텍스트를 입력하세요.",
align: "center",
size: "base",
},
sectionId,
columnId: firstColumnId,
};
const buttonId = createId();
const buttonBlock: Block = {
id: buttonId,
type: "button",
props: {
label: "CTA 버튼",
href: "#",
},
sectionId,
columnId: firstColumnId,
};
set((state: EditorState) => {
const newBlocks = [...state.blocks, sectionBlock, textBlock, buttonBlock];
return {
blocks: newBlocks,
selectedBlockId: buttonId,
};
});
},
// 이미지 블록 추가: 기본 플레이스홀더와 함께 생성 후 선택 상태로 만든다 // 이미지 블록 추가: 기본 플레이스홀더와 함께 생성 후 선택 상태로 만든다
addImageBlock: () => { addImageBlock: () => {
const id = createId(); const id = createId();
@@ -277,6 +486,34 @@ 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 컴포넌트에서 사용하는 전역 훅 스토어 // React 컴포넌트에서 사용하는 전역 훅 스토어
+101
View File
@@ -291,3 +291,104 @@ test("2컬럼 섹션에서 블록을 다른 컬럼 영역으로 드래그하면
// 왼쪽 컬럼에는 더 이상 블록이 없어야 한다. // 왼쪽 컬럼에는 더 이상 블록이 없어야 한다.
await expect(leftColumn.getByTestId("editor-block")).toHaveCount(0); await expect(leftColumn.getByTestId("editor-block")).toHaveCount(0);
}); });
test("Hero 템플릿 버튼을 클릭하면 섹션과 기본 텍스트/버튼 블록이 캔버스에 생성되어야 한다", async ({ page }) => {
await page.goto("/editor");
const canvas = page.getByTestId("editor-canvas");
// Hero 템플릿을 추가한다.
await page.getByRole("button", { name: "Hero 템플릿 추가" }).click();
// 섹션/블록이 하나 이상 존재해야 한다.
const blocks = canvas.getByTestId("editor-block");
await expect(blocks.first()).toBeVisible();
// Hero 헤드라인 텍스트가 포함된 블록이 보여야 한다.
await expect(canvas.getByText("Hero 제목을 여기에 입력하세요")).toBeVisible();
// CTA 버튼도 렌더되어 있어야 한다.
const ctaButton = canvas.getByRole("button", { name: "지금 시작하기" });
await expect(ctaButton).toBeVisible();
});
test("Features 템플릿 버튼을 클릭하면 3개의 Feature 항목(제목/설명)이 생성되어야 한다", async ({ page }) => {
await page.goto("/editor");
const canvas = page.getByTestId("editor-canvas");
await page.getByRole("button", { name: "Features 템플릿 추가" }).click();
// Feature 제목들이 렌더되어야 한다.
await expect(canvas.getByText("Feature 1 제목")).toBeVisible();
await expect(canvas.getByText("Feature 2 제목")).toBeVisible();
await expect(canvas.getByText("Feature 3 제목")).toBeVisible();
});
test("CTA 템플릿 버튼을 클릭하면 CTA 텍스트와 버튼이 포함된 섹션이 캔버스에 생성되어야 한다", async ({ page }) => {
await page.goto("/editor");
const canvas = page.getByTestId("editor-canvas");
await page.getByRole("button", { name: "CTA 템플릿 추가" }).click();
await expect(canvas.getByText("지금 바로 행동을 유도하는 CTA 텍스트를 입력하세요.")).toBeVisible();
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");
});
+150
View File
@@ -174,4 +174,154 @@ describe("editorStore", () => {
expect(moved.sectionId).toBe(sectionBlock.id); expect(moved.sectionId).toBe(sectionBlock.id);
expect(moved.columnId).toBe(updatedColumns[1].id); expect(moved.columnId).toBe(updatedColumns[1].id);
}); });
it("Hero 템플릿 섹션을 추가하면 섹션과 기본 텍스트/버튼 블록들이 한번에 생성되어야 한다", () => {
const store = createEditorStore();
// 템플릿 액션을 호출한다고 가정한다.
// Hero 템플릿은 기본적으로 1개의 섹션과 최소 1개의 텍스트/1개의 버튼 블록을 생성한다고 정의한다.
// (구체적인 props 내용은 구현에서 맞춰가되, 타입/개수/섹션/컬럼 배치만 검증한다.)
store.getState().addHeroTemplateSection();
const { blocks, selectedBlockId } = store.getState();
// 섹션 1개 + 텍스트/버튼 블록이 최소 1개씩 존재해야 한다.
const sectionBlocks = blocks.filter((b) => b.type === "section");
const textBlocks = blocks.filter((b) => b.type === "text");
const buttonBlocks = blocks.filter((b) => b.type === "button");
expect(sectionBlocks).toHaveLength(1);
expect(textBlocks.length).toBeGreaterThanOrEqual(1);
expect(buttonBlocks.length).toBeGreaterThanOrEqual(1);
const section = sectionBlocks[0] as any;
// 템플릿에서 생성된 텍스트/버튼 블록은 모두 동일 섹션의 첫 컬럼에 배치된다고 가정한다.
const columns = (section.props as any).columns;
expect(Array.isArray(columns)).toBe(true);
expect(columns.length).toBeGreaterThanOrEqual(1);
const firstColumnId = columns[0].id;
textBlocks.forEach((tb: any) => {
expect(tb.sectionId).toBe(section.id);
expect(tb.columnId).toBe(firstColumnId);
});
buttonBlocks.forEach((bb: any) => {
expect(bb.sectionId).toBe(section.id);
expect(bb.columnId).toBe(firstColumnId);
});
// 마지막으로 생성된 블록(예: CTA 버튼)이 선택되어 있다고 가정한다.
expect(selectedBlockId).toBe(blocks[blocks.length - 1].id);
});
it("Features 템플릿 섹션을 추가하면 3컬럼 섹션과 각 컬럼의 제목/설명 텍스트가 생성되어야 한다", () => {
const store = createEditorStore();
// Features 템플릿 액션을 호출한다고 가정한다.
store.getState().addFeaturesTemplateSection();
const { blocks, selectedBlockId } = store.getState();
const sectionBlocks = blocks.filter((b) => b.type === "section");
expect(sectionBlocks).toHaveLength(1);
const section = sectionBlocks[0] as any;
const columns = (section.props as any).columns;
expect(Array.isArray(columns)).toBe(true);
expect(columns.length).toBe(3);
const textBlocks = blocks.filter((b) => b.type === "text") as any[];
// 최소 3개의 feature 항목(제목/설명)을 가정하고, 각 컬럼에는 2개의 텍스트(제목+설명)가 있다고 본다.
expect(textBlocks.length).toBeGreaterThanOrEqual(6);
// 모든 텍스트 블록이 동일 섹션에 속하는지 확인한다.
textBlocks.forEach((tb) => {
expect(tb.sectionId).toBe(section.id);
expect(columns.some((col: any) => col.id === tb.columnId)).toBe(true);
});
expect(selectedBlockId).toBe(blocks[blocks.length - 1].id);
});
it("CTA 템플릿 섹션을 추가하면 텍스트와 버튼이 포함된 섹션이 생성되어야 한다", () => {
const store = createEditorStore();
// CTA 템플릿 액션을 호출한다고 가정한다.
store.getState().addCtaTemplateSection();
const { blocks, selectedBlockId } = store.getState();
const sectionBlocks = blocks.filter((b) => b.type === "section");
expect(sectionBlocks).toHaveLength(1);
const section = sectionBlocks[0] as any;
const columns = (section.props as any).columns;
expect(Array.isArray(columns)).toBe(true);
expect(columns.length).toBeGreaterThanOrEqual(1);
const firstColumnId = columns[0].id;
const textBlocks = blocks.filter((b) => b.type === "text") as any[];
const buttonBlocks = blocks.filter((b) => b.type === "button") as any[];
expect(textBlocks.length).toBeGreaterThanOrEqual(1);
expect(buttonBlocks.length).toBeGreaterThanOrEqual(1);
textBlocks.forEach((tb) => {
expect(tb.sectionId).toBe(section.id);
expect(tb.columnId).toBe(firstColumnId);
});
buttonBlocks.forEach((bb) => {
expect(bb.sectionId).toBe(section.id);
expect(bb.columnId).toBe(firstColumnId);
});
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);
});
}); });