섹션 템플릿: Hero/Features/CTA 프리셋 추가

src/app/editor/page.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import type { CSSProperties } from "react";
+import type { CSSProperties, ReactNode } from "react";
 import { useState } from "react";
 import {
   DndContext,
@@ -9,6 +9,7 @@ import {
   useSensor,
   useSensors,
   DragEndEvent,
+  useDroppable,
 } from "@dnd-kit/core";
 import {
   SortableContext,
@@ -32,10 +33,14 @@ export default function EditorPage() {
   const addButtonBlock = useEditorStore((state) => state.addButtonBlock);
   const addImageBlock = useEditorStore((state) => state.addImageBlock);
   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 selectBlock = useEditorStore((state) => state.selectBlock);
   const replaceBlocks = useEditorStore((state) => state.replaceBlocks);
   const reorderBlocks = useEditorStore((state) => state.reorderBlocks);
+  const moveBlock = useEditorStore((state) => state.moveBlock);
 
   const [editingBlockId, setEditingBlockId] = useState<string | null>(null);
   const [editingText, setEditingText] = useState("");
@@ -156,9 +161,64 @@ export default function EditorPage() {
   const handleDragEnd = (event: DragEndEvent) => {
     const { active, over } = event;
     if (!over || active.id === over.id) return;
-    reorderBlocks(String(active.id), String(over.id));
+    const activeId = String(active.id);
+    const overId = String(over.id);
+
+    // 컬럼 droppable에 드롭한 경우: 해당 섹션/컬럼으로 이동만 수행한다.
+    if (overId.startsWith("column:")) {
+      const [, sectionId, columnId] = overId.split(":");
+      moveBlock(activeId, sectionId || null, columnId || null);
+      return;
+    }
+
+    const activeBlock = blocks.find((b) => b.id === activeId);
+    const overBlock = blocks.find((b) => b.id === overId);
+
+    if (!activeBlock || !overBlock) {
+      reorderBlocks(activeId, overId);
+      return;
+    }
+
+    const activeSectionId = activeBlock.sectionId ?? null;
+    const activeColumnId = activeBlock.columnId ?? null;
+    const overSectionId = overBlock.sectionId ?? null;
+    const overColumnId = overBlock.columnId ?? null;
+
+    // 같은 섹션/컬럼 내에서는 순서만 변경한다.
+    if (activeSectionId === overSectionId && activeColumnId === overColumnId) {
+      reorderBlocks(activeId, overId);
+      return;
+    }
+
+    // 다른 컬럼/섹션으로 이동: 위치를 변경한 뒤, 블록 기준 드롭이면 순서 재배치까지 진행한다.
+    moveBlock(activeId, overSectionId, overColumnId);
+    reorderBlocks(activeId, overId);
   };
 
+  const rootBlocks = blocks.filter((block) => !block.sectionId);
+
+  const renderBlocks = (targetBlocks: Block[]) =>
+    targetBlocks.map((block) => {
+      const isSelected = block.id === selectedBlockId;
+      const isEditing = block.id === editingBlockId;
+
+      return (
+        <SortableEditorBlock
+          key={block.id}
+          block={block}
+          isSelected={isSelected}
+          isEditing={isEditing}
+          editingText={editingText}
+          startEditing={startEditing}
+          commitEditing={commitEditing}
+          setEditingText={setEditingText}
+          selectBlock={selectBlock}
+          allBlocks={blocks}
+          renderBlocks={renderBlocks}
+        />
+      );
+    });
+
   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">
@@ -196,6 +256,30 @@ export default function EditorPage() {
           >
             섹션 블록 추가
           </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">
             Text / Image / Button / Section 블록을 이 영역에서 추가할 수 있습니다.
           </p>
@@ -218,24 +302,7 @@ export default function EditorPage() {
                 items={blocks.map((b) => b.id)}
                 strategy={verticalListSortingStrategy}
               >
-                {blocks.map((block) => {
+                {renderBlocks(rootBlocks)}
-                  const isSelected = block.id === selectedBlockId;
-                  const isEditing = block.id === editingBlockId;
-
-                  return (
-                    <SortableEditorBlock
-                      key={block.id}
-                      block={block}
-                      isSelected={isSelected}
-                      isEditing={isEditing}
-                      editingText={editingText}
-                      startEditing={startEditing}
-                      commitEditing={commitEditing}
-                      setEditingText={setEditingText}
-                      selectBlock={selectBlock}
-                    />
-                  );
-                })}
               </SortableContext>
             </DndContext>
           )}
@@ -350,6 +417,55 @@ export default function EditorPage() {
 
                   return (
                     <>
+                      <div className="space-y-1">
+                        <label className="flex flex-col gap-1 text-xs text-slate-400">
+                          <span>레이아웃</span>
+                          <select
+                            className="rounded border border-slate-700 bg-slate-900 px-2 py-1 text-xs outline-none focus:border-sky-500"
+                            aria-label="섹션 레이아웃"
+                            value={(() => {
+                              const cols = sectionProps.columns ?? [];
+                              if (cols.length === 1 && cols[0].span === 12) return "1col";
+                              if (cols.length === 2 && cols[0].span === 6 && cols[1].span === 6) return "2col";
+                              if (
+                                cols.length === 3 &&
+                                cols[0].span === 4 &&
+                                cols[1].span === 4 &&
+                                cols[2].span === 4
+                              )
+                                return "3col";
+                              return "custom";
+                            })()}
+                            onChange={(e) => {
+                              const preset = e.target.value;
+                              if (preset === "custom") return;
+
+                              const cols =
+                                preset === "1col"
+                                  ? [{ id: `${selectedBlock.id}_col_1`, span: 12 }]
+                                  : preset === "2col"
+                                  ? [
+                                      { id: `${selectedBlock.id}_col_1`, span: 6 },
+                                      { id: `${selectedBlock.id}_col_2`, span: 6 },
+                                    ]
+                                  : [
+                                      { id: `${selectedBlock.id}_col_1`, span: 4 },
+                                      { id: `${selectedBlock.id}_col_2`, span: 4 },
+                                      { id: `${selectedBlock.id}_col_3`, span: 4 },
+                                    ];
+
+                              updateBlock(selectedBlockId, { columns: cols } as any);
+                            }}
+                          >
+                            <option value="1col">1열 (100%)</option>
+                            <option value="2col">2열 (50 / 50)</option>
+                            <option value="3col">3열 (33 / 33 / 33)</option>
+                            <option value="custom" disabled>
+                              사용자 정의
+                            </option>
+                          </select>
+                        </label>
+                      </div>
                       <div className="space-y-1">
                         <label className="flex flex-col gap-1 text-xs text-slate-400">
                           <span>배경색</span>
@@ -548,6 +664,8 @@ interface SortableEditorBlockProps {
   commitEditing: () => void;
   setEditingText: (value: string) => void;
   selectBlock: (id: string) => void;
+  allBlocks: Block[];
+  renderBlocks: (targetBlocks: Block[]) => ReactNode;
 }
 
 function SortableEditorBlock({
@@ -559,6 +677,8 @@ function SortableEditorBlock({
   commitEditing,
   setEditingText,
   selectBlock,
+  allBlocks,
+  renderBlocks,
 }: SortableEditorBlockProps) {
   const { attributes, listeners, setNodeRef, transform, transition } = useSortable({
     id: block.id,
@@ -703,13 +823,45 @@ function SortableEditorBlock({
                 ? "py-10"
                 : "py-6";
 
+            const columns = sectionProps.columns && sectionProps.columns.length > 0
+              ? sectionProps.columns
+              : [{ id: `${block.id}_col_fallback`, span: 12 }];
+
             return (
-              <div
+              <div className={`w-full ${bgClass} ${pyClass} rounded border border-dashed border-slate-700`}
-                className={`w-full ${bgClass} ${pyClass} rounded border border-dashed border-slate-700 flex items-center justify-center`}
               >
-                <span className="text-[11px] text-slate-400 px-2 text-center">
+                <div className="flex gap-3">
-                  섹션 영역입니다. (레이아웃 단계에서 컬럼/블록을 배치할 예정입니다.)
+                  {columns.map((col) => {
-                </span>
+                    const basis = `${(col.span / 12) * 100}%`;
+                    const columnBlocks = allBlocks.filter(
+                      (b) => b.sectionId === block.id && b.columnId === col.id,
+                    );
+                    const droppableId = `column:${block.id}:${col.id}`;
+                    return (
+                      <ColumnDroppable
+                        key={col.id}
+                        id={droppableId}
+                        sectionId={block.id}
+                        columnId={col.id}
+                      >
+                        <div
+                          className="border border-slate-800/80 bg-slate-950/40 rounded flex flex-col gap-2 items-stretch justify-start px-2 py-2"
+                          style={{ flexBasis: basis }}
+                        >
+                          {columnBlocks.length === 0 ? (
+                            <span className="text-[11px] text-slate-500 px-2 text-center">
+                              컬럼 영역 (span {col.span}/12)
+                            </span>
+                          ) : (
+                            <div className="flex flex-col gap-2">
+                              {renderBlocks(columnBlocks)}
+                            </div>
+                          )}
+                        </div>
+                      </ColumnDroppable>
+                    );
+                  })}
+                </div>
               </div>
             );
           })()}
@@ -718,3 +870,25 @@ function SortableEditorBlock({
     </div>
   );
 }
+
+interface ColumnDroppableProps {
+  id: string;
+  sectionId: string;
+  columnId: string;
+  children: ReactNode;
+}
+
+function ColumnDroppable({ id, sectionId, columnId, children }: ColumnDroppableProps) {
+  const { setNodeRef } = useDroppable({ id });
+
+  return (
+    <div
+      ref={setNodeRef}
+      data-section-id={sectionId}
+      data-column-id={columnId}
+      className="flex-1"
+    >
+      {children}
+    </div>
+  );
+}

src/features/editor/state/editorStore.ts

@@ -30,6 +30,11 @@ export interface ImageBlockProps {
 export interface SectionBlockProps {
   background: "default" | "muted" | "primary";
   paddingY: "sm" | "md" | "lg";
+  // 레이아웃 컬럼 정의 (12 그리드 기준 span)
+  columns: Array<{
+    id: string;
+    span: number;
+  }>;
 }
 
 // 공통 블록 모델
@@ -37,6 +42,9 @@ export interface Block {
   id: string;
   type: BlockType;
   props: TextBlockProps | ButtonBlockProps | ImageBlockProps | SectionBlockProps;
+  // 레이아웃 트리 상 위치 정보 (루트 텍스트/버튼/이미지 블록은 null)
+  sectionId?: string | null;
+  columnId?: string | null;
 }
 
 // 에디터 상태 인터페이스
@@ -47,10 +55,14 @@ export interface EditorState {
   addButtonBlock: () => void;
   addImageBlock: () => void;
   addSectionBlock: () => void;
+  addHeroTemplateSection: () => void;
+  addFeaturesTemplateSection: () => void;
+  addCtaTemplateSection: () => void;
   updateBlock: (id: string, partial: Partial<TextBlockProps & ButtonBlockProps>) => void;
   selectBlock: (id: string | null) => void;
   replaceBlocks: (blocks: Block[]) => void;
   reorderBlocks: (activeId: string, overId: string) => void;
+  moveBlock: (id: string, sectionId: string | null, columnId: string | null) => void;
 }
 
 // 간단한 ID 생성기 (추후 uuid 라이브러리로 교체 가능)
@@ -66,6 +78,25 @@ const createEditorState = (set: any, get: any): EditorState => ({
     // 텍스트 블록 추가: 기본 텍스트와 함께 생성 후 선택 상태로 만든다
     addTextBlock: () => {
       const id = createId();
+
+      const { selectedBlockId, blocks } = get();
+      let sectionId: string | null = null;
+      let columnId: string | null = null;
+
+      if (selectedBlockId) {
+        const target = blocks.find((b: Block) => b.id === selectedBlockId);
+        if (target) {
+          if (target.type === "section") {
+            const sProps = target.props as SectionBlockProps;
+            sectionId = target.id;
+            columnId = sProps.columns?.[0]?.id ?? null;
+          } else {
+            sectionId = (target as any).sectionId ?? null;
+            columnId = (target as any).columnId ?? null;
+          }
+        }
+      }
+
       const newBlock: Block = {
         id,
         type: "text",
@@ -74,6 +105,8 @@ const createEditorState = (set: any, get: any): EditorState => ({
           align: "left",
           size: "base",
         },
+        sectionId,
+        columnId,
       };
 
       set((state: EditorState) => ({
@@ -82,9 +115,226 @@ const createEditorState = (set: any, get: any): EditorState => ({
       }));
     },
 
+    // 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: () => {
       const id = createId();
+
+      const { selectedBlockId, blocks } = get();
+      let sectionId: string | null = null;
+      let columnId: string | null = null;
+
+      if (selectedBlockId) {
+        const target = blocks.find((b: Block) => b.id === selectedBlockId);
+        if (target) {
+          if (target.type === "section") {
+            const sProps = target.props as SectionBlockProps;
+            sectionId = target.id;
+            columnId = sProps.columns?.[0]?.id ?? null;
+          } else {
+            sectionId = (target as any).sectionId ?? null;
+            columnId = (target as any).columnId ?? null;
+          }
+        }
+      }
+
       const newBlock: Block = {
         id,
         type: "image",
@@ -92,6 +342,8 @@ const createEditorState = (set: any, get: any): EditorState => ({
           src: "",
           alt: "이미지 설명",
         },
+        sectionId,
+        columnId,
       };
 
       set((state: EditorState) => ({
@@ -109,7 +361,15 @@ const createEditorState = (set: any, get: any): EditorState => ({
         props: {
           background: "default",
           paddingY: "md",
+          columns: [
+            {
+              id: `${id}_col_1`,
+              span: 12,
+            },
+          ],
         },
+        sectionId: null,
+        columnId: null,
       };
 
       set((state: EditorState) => ({
@@ -121,6 +381,24 @@ const createEditorState = (set: any, get: any): EditorState => ({
     // 버튼 블록 추가: 기본 라벨/링크와 함께 생성 후 선택 상태로 만든다
     addButtonBlock: () => {
       const id = createId();
+
+      const { selectedBlockId, blocks } = get();
+      let sectionId: string | null = null;
+      let columnId: string | null = null;
+
+      if (selectedBlockId) {
+        const target = blocks.find((b: Block) => b.id === selectedBlockId);
+        if (target) {
+          if (target.type === "section") {
+            const sProps = target.props as SectionBlockProps;
+            sectionId = target.id;
+            columnId = sProps.columns?.[0]?.id ?? null;
+          } else {
+            sectionId = (target as any).sectionId ?? null;
+            columnId = (target as any).columnId ?? null;
+          }
+        }
+      }
       const newBlock: Block = {
         id,
         type: "button",
@@ -128,6 +406,8 @@ const createEditorState = (set: any, get: any): EditorState => ({
           label: "버튼",
           href: "#",
         },
+        sectionId,
+        columnId,
       };
 
       set((state: EditorState) => ({
@@ -185,6 +465,19 @@ const createEditorState = (set: any, get: any): EditorState => ({
         return { blocks: updated };
       });
     },
+    moveBlock: (id, sectionId, columnId) => {
+      set((state: EditorState) => ({
+        blocks: state.blocks.map((block: Block) =>
+          block.id === id
+            ? {
+                ...block,
+                sectionId,
+                columnId,
+              }
+            : block,
+        ),
+      }));
+    },
   });
 
 // React 컴포넌트에서 사용하는 전역 훅 스토어

tests/e2e/editor.spec.ts

@@ -253,3 +253,86 @@ test("버튼 블록을 추가하고 라벨과 링크를 수정할 수 있어야
   const updatedButton = canvas.getByRole("button", { name: "자세히 보기" });
   await expect(updatedButton).toBeVisible();
 });
+
+test("2컬럼 섹션에서 블록을 다른 컬럼 영역으로 드래그하면 컬럼이 변경되어야 한다", async ({ page }) => {
+  await page.goto("/editor");
+
+  const canvas = page.getByTestId("editor-canvas");
+
+  // 섹션을 하나 추가하고 레이아웃을 2컬럼으로 변경한다.
+  await page.getByRole("button", { name: "섹션 블록 추가" }).click();
+
+  // 섹션을 선택한다 (캔버스 첫 블록).
+  const sectionBlock = canvas.getByTestId("editor-block").nth(0);
+  await sectionBlock.click();
+
+  const layoutSelect = page.getByRole("combobox", { name: "섹션 레이아웃" });
+  await layoutSelect.selectOption("2col");
+
+  // 왼쪽 컬럼에 텍스트 블록을 하나 추가한다.
+  await page.getByRole("button", { name: "텍스트 블록 추가" }).click();
+
+  const leftColumn = canvas.locator('[data-section-id][data-column-id]').nth(0);
+  const rightColumn = canvas.locator('[data-section-id][data-column-id]').nth(1);
+
+  // 왼쪽 컬럼 안에 텍스트 블록이 존재하는지 확인한다.
+  const leftBlocks = leftColumn.getByTestId("editor-block");
+  await expect(leftBlocks).toHaveCount(1);
+
+  // 왼쪽 컬럼의 첫 블록을 오른쪽 컬럼 droppable 영역으로 드래그한다.
+  const leftBlock = leftBlocks.nth(0);
+  const handle = leftBlock.getByRole("button", { name: "블록 드래그 핸들" });
+  await handle.dragTo(rightColumn);
+
+  // 드래그 이후, 오른쪽 컬럼 안에 블록이 존재해야 하고 왼쪽 컬럼은 비어 있어야 한다.
+  const rightBlocks = rightColumn.getByTestId("editor-block");
+  await expect(rightBlocks).toHaveCount(1);
+
+  // 왼쪽 컬럼에는 더 이상 블록이 없어야 한다.
+  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();
+});

tests/unit/editorStore.spec.ts

@@ -77,4 +77,209 @@ describe("editorStore", () => {
     expect(updatedButtonProps.href).toBe("https://example.com");
     expect(selectedBlockId).toBe(updatedBlocks[0].id);
   });
+
+  it("섹션이 선택된 상태에서 텍스트 블록을 추가하면 해당 섹션의 첫 컬럼에 배치되어야 한다", () => {
+    const store = createEditorStore();
+
+    // 섹션 블록을 하나 추가하고 기본 1컬럼 레이아웃을 사용한다.
+    store.getState().addSectionBlock();
+
+    const { blocks: afterSection } = store.getState();
+    expect(afterSection).toHaveLength(1);
+    const sectionBlock = afterSection[0];
+    expect(sectionBlock.type).toBe("section");
+
+    const sectionProps = sectionBlock.props as any;
+    expect(Array.isArray(sectionProps.columns)).toBe(true);
+    expect(sectionProps.columns.length).toBeGreaterThan(0);
+
+    // 섹션을 선택한 후 텍스트 블록을 추가한다.
+    store.getState().selectBlock(sectionBlock.id);
+    store.getState().addTextBlock();
+
+    const { blocks: finalBlocks } = store.getState();
+    expect(finalBlocks).toHaveLength(2);
+
+    const textBlock = finalBlocks.find((b) => b.type === "text")!;
+
+    // 새 텍스트 블록의 sectionId/columnId가 선택된 섹션과 첫 컬럼을 가리켜야 한다.
+    expect((textBlock as any).sectionId).toBe(sectionBlock.id);
+    expect((textBlock as any).columnId).toBe(sectionProps.columns[0].id);
+  });
+
+  it("블록이 선택된 상태에서 새 텍스트 블록을 추가하면 동일한 섹션/컬럼에 배치되어야 한다", () => {
+    const store = createEditorStore();
+
+    // 섹션 + 텍스트 블록을 만든다.
+    store.getState().addSectionBlock();
+    const { blocks: afterSection } = store.getState();
+    const sectionBlock = afterSection[0];
+    const sectionProps = sectionBlock.props as any;
+
+    store.getState().selectBlock(sectionBlock.id);
+    store.getState().addTextBlock();
+
+    let { blocks } = store.getState();
+    const firstText = blocks.find((b) => b.type === "text")!;
+
+    // 첫 텍스트 블록의 위치를 기준으로 한다.
+    store.getState().selectBlock(firstText.id);
+    store.getState().addTextBlock();
+
+    blocks = store.getState().blocks;
+    const textBlocks = blocks.filter((b) => b.type === "text");
+    expect(textBlocks).toHaveLength(2);
+
+    const [t1, t2] = textBlocks as any[];
+
+    // 두 번째 텍스트 블록도 같은 섹션/컬럼에 있어야 한다.
+    expect(t1.sectionId).toBe(sectionBlock.id);
+    expect(t2.sectionId).toBe(sectionBlock.id);
+    expect(t1.columnId).toBe(sectionProps.columns[0].id);
+    expect(t2.columnId).toBe(sectionProps.columns[0].id);
+  });
+
+  it("moveBlock 호출 시 블록의 sectionId/columnId가 변경되어야 한다", () => {
+    const store = createEditorStore();
+
+    // 섹션 + 텍스트 블록 1개를 만든다.
+    store.getState().addSectionBlock();
+    const { blocks: afterSection } = store.getState();
+    const sectionBlock = afterSection[0];
+    const sectionProps = sectionBlock.props as any;
+
+    store.getState().selectBlock(sectionBlock.id);
+    store.getState().addTextBlock();
+
+    let { blocks } = store.getState();
+    const textBlock = blocks.find((b) => b.type === "text") as any;
+
+    // 초기 위치는 섹션의 첫 컬럼이어야 한다.
+    expect(textBlock.sectionId).toBe(sectionBlock.id);
+    expect(textBlock.columnId).toBe(sectionProps.columns[0].id);
+
+    // 섹션 레이아웃을 2컬럼으로 바꾸고 두 번째 컬럼으로 이동시킨다.
+    const updatedColumns = [
+      { id: `${sectionBlock.id}_col_1`, span: 6 },
+      { id: `${sectionBlock.id}_col_2`, span: 6 },
+    ];
+
+    store.getState().updateBlock(sectionBlock.id, { columns: updatedColumns } as any);
+
+    store.getState().moveBlock(textBlock.id, sectionBlock.id, updatedColumns[1].id);
+
+    blocks = store.getState().blocks;
+    const moved = blocks.find((b) => b.id === textBlock.id) as any;
+
+    expect(moved.sectionId).toBe(sectionBlock.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);
+  });
 });