@flextudio/scenario 0.1.0

package/contract-data/schema/v1/design-system/tests/_base.materialize.test.mjs

@@ -0,0 +1,596 @@
+// design-system/tests/_base.materialize.test.mjs
+// 실행: node --test meta-contract/schema/v1/design-system/tests/_base.materialize.test.mjs
+//
+// design 키 훅이 patterns/_base.materialize.mjs 의 tree walker 에 올바르게
+// 통합됐는지 검증 (patterns 모듈을 import 하지만 검증 주체는 design 통합).
+// 기존 pattern materialize 자체 동작은 별도 e2e (examples/*.json) 가 커버.
+
+import { test } from "node:test";
+import assert from "node:assert/strict";
+
+import {
+  materializeScenario,
+  materializeFragment,
+} from "../../patterns/_base.materialize.mjs";
+
+// ────────────────────────────────────────────────────────────────────────────
+// Fragment-level: 단일 control / group
+// ────────────────────────────────────────────────────────────────────────────
+
+test("fragment: raw Label + design → FontStyle expanded, design 키 제거", async () => {
+  const node = {
+    ControlType: "Label",
+    labeltext: "hi",
+    Id: "f_1",
+    design: { font: "body-large", color: "body" },
+  };
+  const r = await materializeFragment(node);
+  assert.deepEqual(r.errors, []);
+  assert.equal(r.fragment.design, undefined);
+  assert.equal(r.fragment.FontStyle.FontSize, "16");
+  assert.equal(r.fragment.FontStyle.FontColor, "var(--colorGray1)");
+  assert.equal(r.report.designsApplied, 1);
+  assert.equal(r.report.designSourceMaps["$"]["FontStyle.FontColor"], "$.design.color");
+});
+
+test("fragment: raw Group + design → Padding / BgStyle expanded, Contents walking 유지", async () => {
+  const node = {
+    ContentsType: "Group",
+    Id: "f_1",
+    design: { p: "16", bg: "card" },
+    Contents: [
+      {
+        ControlType: "Label",
+        labeltext: "child",
+        Id: "f_2",
+        design: { color: "body-soft" },
+      },
+    ],
+  };
+  const r = await materializeFragment(node);
+  assert.deepEqual(r.errors, []);
+  assert.equal(r.fragment.Padding.Top, "16");
+  assert.equal(r.fragment.BgStyle.BgColor, "var(--colorWhite)");
+  // 자식 design 도 expand 됐는지
+  assert.equal(r.fragment.Contents[0].FontStyle.FontColor, "var(--colorGray3)");
+  assert.equal(r.report.designsApplied, 2);
+  // sourceMap 이 노드 path 별로 누적
+  assert.ok(r.report.designSourceMaps["$"]);
+  assert.ok(r.report.designSourceMaps["$.Contents[0]"]);
+});
+
+test("fragment: design errors 가 materializer errors 에 합쳐짐", async () => {
+  const node = {
+    ControlType: "Label",
+    labeltext: "x",
+    Id: "f_1",
+    design: { color: "not-a-slot" },
+  };
+  const r = await materializeFragment(node);
+  assert.equal(r.errors.length, 1);
+  assert.equal(r.errors[0].kind, "design");
+  assert.match(r.errors[0].message, /unknown text color slot 'not-a-slot'/);
+  // 에러가 있어도 fragment 는 부분 결과로 반환
+  assert.equal(r.fragment.design, undefined);
+});
+
+test("fragment: design 없는 raw control 은 passthrough — designsApplied 0", async () => {
+  const node = {
+    ControlType: "Label",
+    labeltext: "hi",
+    Id: "f_1",
+    FontStyle: { UseFont: true, FontColor: "#abc" },
+  };
+  const r = await materializeFragment(node);
+  assert.deepEqual(r.errors, []);
+  assert.equal(r.report.designsApplied, 0);
+  assert.deepEqual(r.report.designSourceMaps, {});
+  // raw 그대로
+  assert.equal(r.fragment.FontStyle.FontColor, "#abc");
+});
+
+test("fragment: design + raw leaf 공존 — design 우선, 안 겹친 raw 보존", async () => {
+  const node = {
+    ControlType: "Label",
+    labeltext: "x",
+    Id: "f_1",
+    FontStyle: { UseFont: true, FontSize: "20", FontColor: "#abc" },
+    design: { color: "body" },
+  };
+  const r = await materializeFragment(node);
+  assert.deepEqual(r.errors, []);
+  // design.color 가 FontColor 덮어씀
+  assert.equal(r.fragment.FontStyle.FontColor, "var(--colorGray1)");
+  // raw FontSize 는 보존
+  assert.equal(r.fragment.FontStyle.FontSize, "20");
+});
+
+test("fragment: InputFile Attributes.InnerCKey strip ([no-inner-block]) — FlexKey.ckey 보존", async () => {
+  // 관측 케이스: FlexFile + FlexKey.ckey 이미 채워졌는데 InnerCKey 중복 → 스키마
+  // 'boolean schema is false'. 결정적 strip, 기존 저장 필드 손실 없음.
+  const node = {
+    ControlType: "InputFile",
+    Id: "f_1",
+    Module: "FlexFile",
+    Attributes: {
+      UseCategory: false,
+      InnerCKey: "fReceipt",
+      FlexKey: { ckey: "fReceipt" },
+      SharedTarget: "tenant",
+    },
+  };
+  const r = await materializeFragment(node);
+  assert.deepEqual(r.errors, []);
+  assert.equal("InnerCKey" in r.fragment.Attributes, false);
+  assert.equal(r.fragment.Attributes.FlexKey.ckey, "fReceipt");
+});
+
+test("fragment: InputFile InnerCKey 이관 — 1차 저장 필드 비었으면 값 복사(발명 아님)", async () => {
+  // FlexFile: FlexKey.ckey 없을 때 InnerCKey 값을 FlexKey.ckey 로 이관.
+  const flex = await materializeFragment({
+    ControlType: "InputFile", Id: "f_1", Module: "FlexFile",
+    Attributes: { InnerCKey: "fDoc" },
+  });
+  assert.equal("InnerCKey" in flex.fragment.Attributes, false);
+  assert.equal(flex.fragment.Attributes.FlexKey.ckey, "fDoc");
+
+  // KsystemFile: Ckeys 비었으면 [value] 로 이관.
+  const ks = await materializeFragment({
+    ControlType: "InputFile", Id: "f_2", Module: "KsystemFile",
+    Attributes: { InnerCKey: "seqKey" },
+  });
+  assert.equal("InnerCKey" in ks.fragment.Attributes, false);
+  assert.deepEqual(ks.fragment.Attributes.Ckeys, ["seqKey"]);
+});
+
+test("scenario: BottomButton UseEvents strip — Events 보존, Step root UseEvents 미영향", async () => {
+  const scenario = {
+    Steps: {
+      Step1: {
+        // Step root 의 UseEvents 는 유효 → 건드리면 안 됨
+        UseEvents: true,
+        Events: { Init: "loadStep" },
+        BottomButtons: [
+          // BottomButton 의 UseEvents 는 잉여 → strip, Events 보존
+          { ButtonName: "제출", MoveTo: "None", UseEvents: true, Events: { Click: "SubmitConfirm" } },
+          // UseEvents 없는 정상 버튼은 그대로
+          { ButtonName: "다음", MoveTo: "Next" },
+        ],
+      },
+    },
+  };
+  const r = await materializeScenario(scenario);
+  const s1 = r.scenario.Steps.Step1;
+  // BottomButton[0]: UseEvents 제거, Events 보존
+  assert.equal("UseEvents" in s1.BottomButtons[0], false);
+  assert.deepEqual(s1.BottomButtons[0].Events, { Click: "SubmitConfirm" });
+  // BottomButton[1]: 변화 없음
+  assert.deepEqual(s1.BottomButtons[1], { ButtonName: "다음", MoveTo: "Next" });
+  // Step root UseEvents 는 유지 (전역 strip 아님)
+  assert.equal(s1.UseEvents, true);
+});
+
+test("fragment: Items 원소 표준키 외 strip (strict-fields)", async () => {
+  // ComboList.Items 에 실데이터 커스텀키(bizUnitName/bizUnitCode) 직접 박음 → strip.
+  const r = await materializeFragment({
+    ControlType: "ComboList", Id: "f_1", UseDataSource: false,
+    Items: [
+      { ItemName: "본사", ItemValue: "HQ", bizUnitName: "본사", bizUnitCode: "HQ" },
+      { ItemName: "지사", ItemValue: "BR1", ItemValueDel: "0" },  // ItemValueDel 은 표준키 보존
+    ],
+  });
+  assert.deepEqual(r.fragment.Items[0], { ItemName: "본사", ItemValue: "HQ" });
+  assert.deepEqual(r.fragment.Items[1], { ItemName: "지사", ItemValue: "BR1", ItemValueDel: "0" });
+});
+
+test("fragment: {{=Field}} 이중중괄호 → {=Field} (i18n {{KEY}} 보존)", async () => {
+  const r = await materializeFragment({
+    ControlType: "Label", Id: "f_1", LabelType: "labeltext",
+    labeltext: "{{=fName}} 님 / {{WELCOME_MSG}}",
+  });
+  // {{=X}} → {=X}, = 없는 i18n 이중중괄호는 그대로
+  assert.equal(r.fragment.labeltext, "{=fName} 님 / {{WELCOME_MSG}}");
+  // 이미 올바른 단일 {=X} 는 불변
+  const r2 = await materializeFragment({
+    ControlType: "Label", Id: "f_2", LabelType: "labeltext", labeltext: "{=already}",
+  });
+  assert.equal(r2.fragment.labeltext, "{=already}");
+});
+
+test("fragment: Combo Dialog.Layouts ContentsType strip (Controls/SaveKey 보존)", async () => {
+  const r = await materializeFragment({
+    ControlType: "Combo", Id: "f_1", Ckeys: ["k", "n"], CtrlDisplayCkey: "n",
+    Dialog: { Layouts: [{ ContentsType: "Layout", Controls: [
+      { ControlType: "ComboList", Id: "f_2", UseDataSource: false, Ckeys: ["k", "n"],
+        SaveNameKey: "k", SaveValueKey: "n", Items: [{ ItemName: "1", ItemValue: "일" }] },
+    ] }] },
+  });
+  const L = r.fragment.Dialog.Layouts[0];
+  assert.equal("ContentsType" in L, false);   // Combo → 제거
+  assert.equal(L.Controls.length, 1);          // Controls 보존
+  // SaveKey/Ckeys 는 유동적이라 손대지 않음
+  assert.equal(L.Controls[0].SaveNameKey, "k");
+  assert.equal(L.Controls[0].SaveValueKey, "n");
+});
+
+test("fragment: Search / InputDate Dialog.Layouts ContentsType 는 보존 (Combo 한정)", async () => {
+  // Search → ContentsType:"Layout" 정본, 유지
+  const s = await materializeFragment({
+    ControlType: "Search", Id: "f_1", CtrlDisplayCkey: "n",
+    Dialog: { Layouts: [{ ContentsType: "Layout", Controls: [
+      { ControlType: "List", Id: "f_2", DataSourceName: "DS", Ckeys: ["k", "n"] },
+    ] }] },
+  });
+  assert.equal(s.fragment.Dialog.Layouts[0].ContentsType, "Layout");
+  // InputDate → ContentsType:"Layout" 정본, 유지
+  const d = await materializeFragment({
+    ControlType: "InputDate", Id: "f_3", DateFormat: "YYYY-MM-DD",
+    Dialog: { Layouts: [{ ContentsType: "Layout", Controls: [
+      { ControlType: "Calendar", Id: "f_4", CalendarType: "dayCalendar", SelectType: "SingleDate",
+        SingleDate: { Ckeys: ["fDate"] } },
+    ] }] },
+  });
+  assert.equal(d.fragment.Dialog.Layouts[0].ContentsType, "Layout");
+});
+
+test("fragment: Calendar SelectType 'One'→SingleDate alias", async () => {
+  const r = await materializeFragment({
+    ControlType: "Calendar", Id: "f_1", CalendarType: "dayCalendar", SelectType: "One",
+    SingleDate: { Ckeys: ["fDate"] },
+  });
+  assert.equal(r.fragment.SelectType, "SingleDate");
+  // 동의어 range→FromTo
+  const r2 = await materializeFragment({
+    ControlType: "Calendar", Id: "f_2", CalendarType: "dayCalendar", SelectType: "range",
+    StartDate: { Ckeys: ["fS"] }, EndDate: { Ckeys: ["fE"] },
+  });
+  assert.equal(r2.fragment.SelectType, "FromTo");
+});
+
+test("fragment: Label LabelType↔필드 정합 (oneOf cascade 원인)", async () => {
+  // LabelType='labeltext' 인데 labeltext 없이 LabelCKey 만 채움 → LabelType='LabelCKey' 로 교정.
+  const r = await materializeFragment({
+    ControlType: "Label", Id: "f_1", LabelType: "labeltext", LabelCKey: "fDeclNo",
+  });
+  assert.equal(r.fragment.LabelType, "LabelCKey");
+  // 반대: LabelType='LabelCKey' 인데 labeltext 만 → 'labeltext'.
+  const r2 = await materializeFragment({
+    ControlType: "Label", Id: "f_2", LabelType: "LabelCKey", labeltext: "제목",
+  });
+  assert.equal(r2.fragment.LabelType, "labeltext");
+  // 둘 다 채워짐 → 모호, 손대지 않음.
+  const r3 = await materializeFragment({
+    ControlType: "Label", Id: "f_3", LabelType: "labeltext", labeltext: "x", LabelCKey: "y",
+  });
+  assert.equal(r3.fragment.LabelType, "labeltext");
+});
+
+test("scenario: DataSource 구조 정본화 (Items→FixedItems/GridItems + 잉여 DataSourceName strip)", async () => {
+  const r = await materializeScenario({
+    Steps: {},
+    DataSources: {
+      // Fixed 인데 FixedItems 대신 Items + 잉여 DataSourceName → oneOf 전 분기 탈락
+      MdEmployeeDS: { DataSourceType: "Fixed", DataSourceName: "MdEmployeeDS",
+        Items: [{ EmpCode: "MD001", EmpName: "박상우" }] },
+      // Grid 동형
+      StatGrid: { DataSourceType: "Grid", Items: [{ a: 1 }] },
+      // 이미 올바른 것은 불변
+      OkDS: { DataSourceType: "Fixed", FixedItems: [{ ItemName: "x", ItemValue: "1" }] },
+    },
+  });
+  const ds = r.scenario.DataSources;
+  assert.equal("DataSourceName" in ds.MdEmployeeDS, false);   // 잉여 strip
+  assert.equal("Items" in ds.MdEmployeeDS, false);            // Items 제거
+  assert.deepEqual(ds.MdEmployeeDS.FixedItems, [{ EmpCode: "MD001", EmpName: "박상우" }]);
+  assert.deepEqual(ds.StatGrid.GridItems, [{ a: 1 }]);
+  assert.equal("Items" in ds.StatGrid, false);
+  // 올바른 것 불변
+  assert.deepEqual(ds.OkDS.FixedItems, [{ ItemName: "x", ItemValue: "1" }]);
+});
+
+test("scenario: ScenarioTitle 가비지 슬롯 → '' 강제", async () => {
+  const r = await materializeScenario({ ScenarioTitle: "자재반납신청 조회", Steps: {} });
+  assert.equal(r.scenario.ScenarioTitle, "");
+});
+
+test("scenario: BottomButton Prev 주입 + Next 슬롯 객체→'' + UseClickEvent strip", async () => {
+  const r = await materializeScenario({
+    Steps: {
+      Step1: {
+        BottomButtons: [
+          // Next 슬롯에 객체 → "" (MoveStepOrder 배열 유지)
+          { ButtonName: "다음", MoveTo: "Next",
+            Next: { MoveStepOrder: ["Step2"], Step2: { Condition: "", MoveTo: "Next" } } },
+        ],
+      },
+      Step2: {
+        BottomButtons: [
+          // MoveTo='Prev' 인데 top-level Prev 없음 → 빈 Prev 주입 + UseClickEvent strip
+          { ButtonName: "이전", MoveTo: "Prev", UseClickEvent: true, Events: { Click: "goBack" } },
+        ],
+      },
+    },
+  });
+  const nx = r.scenario.Steps.Step1.BottomButtons[0].Next;
+  assert.deepEqual(nx.MoveStepOrder, ["Step2"]);
+  assert.equal(nx.Step2, "");
+  const prevBtn = r.scenario.Steps.Step2.BottomButtons[0];
+  assert.deepEqual(prevBtn.Prev, { MoveStepOrder: [] });
+  assert.equal("UseClickEvent" in prevBtn, false);
+  assert.deepEqual(prevBtn.Events, { Click: "goBack" });
+});
+
+test("scenario: BottomButton design expand (residual 'design' 제거)", async () => {
+  const r = await materializeScenario({
+    Steps: {
+      Step1: {
+        BottomButtons: [
+          { ButtonName: "제출", MoveTo: "None", design: { w: "full", bg: "error" } },
+        ],
+      },
+    },
+  });
+  const b = r.scenario.Steps.Step1.BottomButtons[0];
+  assert.equal("design" in b, false);   // design 키 expand 되어 제거
+  assert.ok(b.Width || b.BgStyle);       // raw 스타일 키로 변환됨
+});
+
+test("fragment: Combo DataSourceName 본체→자식 동기화 + display-key 보정", async () => {
+  const r = await materializeFragment({
+    ControlType: "Combo", Id: "f_1",
+    DataSourceName: "WarehouseDS",
+    Ckeys: ["whCode", "whName"],           // [값키, 표시키]
+    Dialog: { Layouts: [{ Controls: [
+      { ControlType: "ComboList", Id: "f_2", UseDataSource: true },  // DataSourceName/Ckeys 누락
+    ] }] },
+  });
+  const body = r.fragment;
+  const inner = body.Dialog.Layouts[0].Controls[0];
+  assert.equal(inner.DataSourceName, "WarehouseDS");   // 본체→자식 복사
+  assert.equal(body.CtrlDisplayCkey, "whName");        // Ckeys 표시키로 display-key 보정
+});
+
+test("fragment: 고정모드 Combo — 빈 CtrlDisplayCkey 를 자식 SaveNameKey 로 자동 채움 (표시키↔저장키 연결)", async () => {
+  const r = await materializeFragment({
+    ControlType: "Combo", Id: "f_1",
+    Ckeys: ["StatusCode", "StatusName"],
+    Dialog: { Layouts: [{ Controls: [
+      {
+        ControlType: "ComboList", Id: "f_2", UseDataSource: false,
+        SaveNameKey: "StatusName", SaveValueKey: "StatusCode",
+        Items: [{ ItemName: "대기", ItemValue: "P" }],
+      },
+    ] }] },
+  });
+  // 비어있던 CtrlDisplayCkey 가 SaveNameKey 로 채워짐
+  assert.equal(r.fragment.CtrlDisplayCkey, "StatusName");
+});
+
+test("fragment: 고정모드 Combo — SaveNameKey 없으면 SaveValueKey 로 채움", async () => {
+  const r = await materializeFragment({
+    ControlType: "Combo", Id: "f_1",
+    Ckeys: ["StatusCode", "StatusName"],
+    Dialog: { Layouts: [{ Controls: [
+      {
+        ControlType: "ComboList", Id: "f_2", UseDataSource: false,
+        SaveValueKey: "StatusCode",   // SaveNameKey 없음
+        Items: [{ ItemName: "대기", ItemValue: "P" }],
+      },
+    ] }] },
+  });
+  assert.equal(r.fragment.CtrlDisplayCkey, "StatusCode");
+});
+
+test("fragment: 고정모드 Combo — CtrlDisplayCkey 가 SaveKey 와 불일치하면 교정", async () => {
+  const r = await materializeFragment({
+    ControlType: "Combo", Id: "f_1",
+    Ckeys: ["StatusCode", "StatusName"],
+    CtrlDisplayCkey: "WrongField",   // 자식 SaveKey 어느 것과도 불일치
+    Dialog: { Layouts: [{ Controls: [
+      {
+        ControlType: "ComboList", Id: "f_2", UseDataSource: false,
+        SaveNameKey: "StatusName", SaveValueKey: "StatusCode",
+        Items: [{ ItemName: "대기", ItemValue: "P" }],
+      },
+    ] }] },
+  });
+  assert.equal(r.fragment.CtrlDisplayCkey, "StatusName");  // SaveNameKey 로 교정
+});
+
+test("fragment: 고정모드 Combo — DisplayValue 표현식이 있으면 CtrlDisplayCkey 안 채움 (표현식 표시 보존)", async () => {
+  const r = await materializeFragment({
+    ControlType: "Combo", Id: "f_1",
+    Ckeys: ["StatusCode", "StatusName"],
+    DisplayValue: "{=StatusName}",   // 표현식 표시 의도
+    Dialog: { Layouts: [{ Controls: [
+      {
+        ControlType: "ComboList", Id: "f_2", UseDataSource: false,
+        SaveNameKey: "StatusName", SaveValueKey: "StatusCode",
+        Items: [{ ItemName: "대기", ItemValue: "P" }],
+      },
+    ] }] },
+  });
+  assert.equal(r.fragment.CtrlDisplayCkey, undefined);   // 표현식 보존, 안 채움
+  assert.equal(r.fragment.DisplayValue, "{=StatusName}");
+});
+
+test("fragment: Search 빈 껍데기는 보정 불가 (Ckeys 없으면 손대지 않음)", async () => {
+  const r = await materializeFragment({
+    ControlType: "Search", Id: "f_1", DisplayType: "CtrlDisplayCkey",
+    Dialog: { Layouts: [{ Controls: [{ ControlType: "List", Id: "f_2" }] }] },
+  });
+  // Ckeys/DataSourceName 소스가 없으므로 발명하지 않음 — schema 가 잡게 둠
+  assert.equal(r.fragment.CtrlDisplayCkey, undefined);
+});
+
+// ────────────────────────────────────────────────────────────────────────────
+// DataConnection: 조회(query) + TargetSector.Filters → UseTargetSector:true 보장
+// ────────────────────────────────────────────────────────────────────────────
+
+test("fragment: query + TargetSector.Filters → UseTargetSector:true 자동 주입", async () => {
+  const r = await materializeFragment({
+    ContentsType: "Group", Id: "f_1",
+    UseDataConnection: true,
+    DataConnection: {
+      TargetType: "category", DataUsage: "query", CategoryName: "OrderList",
+      TargetSector: { Filters: [{ FilterType: "Parent", DCParentKey: "OrderNo", DCChildKey: "OrderNo" }] },
+    },
+    Contents: [],
+  });
+  const dc = r.fragment.DataConnection;
+  assert.equal(dc.UseTargetSector, true);                 // Filters 있으면 스위치 ON
+  assert.equal(dc.DataUsage, "query");                    // query 는 보존 (detail/update 로 안 바뀜)
+  assert.equal(dc.TargetSector.Filters.length, 1);        // Filters 보존
+});
+
+test("fragment: query + Filters 없음 → UseTargetSector 주입 안 함", async () => {
+  const r = await materializeFragment({
+    ContentsType: "Group", Id: "f_1",
+    UseDataConnection: true,
+    DataConnection: { TargetType: "category", DataUsage: "query", CategoryName: "OrderList" },
+    Contents: [],
+  });
+  const dc = r.fragment.DataConnection;
+  assert.equal("UseTargetSector" in dc, false);           // 필터 없으면 전체 섹터 전송 — 스위치 불필요
+});
+
+test("fragment: UseTargetSector:false + Filters → true 로 교정 (필터 무시 방지)", async () => {
+  const r = await materializeFragment({
+    ContentsType: "Group", Id: "f_1",
+    UseDataConnection: true,
+    DataConnection: {
+      TargetType: "category", DataUsage: "query", CategoryName: "OrderList",
+      UseTargetSector: false,   // 모순: Filters 정의했는데 스위치 꺼짐
+      TargetSector: { Filters: [{ FilterType: "Status", Status: ["active"] }] },
+    },
+    Contents: [],
+  });
+  assert.equal(r.fragment.DataConnection.UseTargetSector, true);  // 켜짐으로 교정
+});
+
+// ────────────────────────────────────────────────────────────────────────────
+// Scenario-level: Steps walker 가 design 키 처리하는지
+// ────────────────────────────────────────────────────────────────────────────
+
+test("scenario: Steps[*].Contents 에서 design 키 expand", async () => {
+  const scenario = {
+    Steps: {
+      S1: {
+        StepName: "S1",
+        Contents: [
+          {
+            ContentsType: "Group",
+            Id: "f_1",
+            design: { p: "20", bg: "subtle" },
+            Contents: [
+              {
+                ControlType: "Label",
+                labeltext: "안녕",
+                Id: "f_2",
+                design: { font: "title-large", color: "body" },
+              },
+            ],
+          },
+        ],
+      },
+    },
+  };
+  const r = await materializeScenario(scenario);
+  assert.deepEqual(r.errors, []);
+  const group = r.scenario.Steps.S1.Contents[0];
+  assert.equal(group.Padding.Top, "20");
+  assert.equal(group.BgStyle.BgColor, "var(--colorGray9)");
+  const label = group.Contents[0];
+  assert.equal(label.FontStyle.FontSize, "18");
+  assert.equal(label.FontStyle.FontWeight, "SemiBold");
+  assert.equal(label.FontStyle.FontColor, "var(--colorGray1)");
+  assert.equal(r.report.designsApplied, 2);
+
+  // sourceMap 의 path 가 Steps.S1.Contents[0] 형태로 누적
+  const smKeys = Object.keys(r.report.designSourceMaps);
+  assert.ok(smKeys.includes("Steps.S1.Contents[0]"));
+  assert.ok(smKeys.includes("Steps.S1.Contents[0].Contents[0]"));
+});
+
+test("scenario: pattern 결과는 design 처리 비대상 (pattern 이 own style)", async () => {
+  // pattern invocation 은 materializer 가 fully-materialized 결과를 반환하고
+  // 그 결과는 walker 가 더 이상 descend 하지 않음 (development.md §6).
+  // 따라서 pattern 출력 안에 우연히 design 키가 들어가 있어도 expand 안 됨.
+  const scenario = {
+    Steps: {
+      S1: {
+        StepName: "S1",
+        Contents: [
+          {
+            ContentsType: "Group",
+            Id: "f_1",
+            Contents: [
+              { button: { label: "확인", variant: "primary", width: "full" } },
+            ],
+          },
+        ],
+      },
+    },
+  };
+  const r = await materializeScenario(scenario);
+  // button pattern 이 정상 materialize 됐고 design 처리는 fire 안 됨 (button 안에 design 키 없음).
+  assert.deepEqual(r.errors, []);
+  assert.equal(r.report.patternsApplied, 1);
+  assert.equal(r.report.designsApplied, 0);
+});
+
+test("scenario: design 에러도 path 가 정확히 표시됨", async () => {
+  const scenario = {
+    Steps: {
+      S1: {
+        StepName: "S1",
+        Contents: [
+          {
+            ContentsType: "Group",
+            Id: "f_1",
+            Contents: [
+              {
+                ControlType: "Label",
+                labeltext: "x",
+                Id: "f_2",
+                design: { font: "made-up-role" },
+              },
+            ],
+          },
+        ],
+      },
+    },
+  };
+  const r = await materializeScenario(scenario);
+  assert.equal(r.errors.length, 1);
+  assert.equal(r.errors[0].path, "Steps.S1.Contents[0].Contents[0].design.font");
+});
+
+// ────────────────────────────────────────────────────────────────────────────
+// Regression: pattern materialize 기존 동작 유지 (design 훅이 깨지 않음)
+// ────────────────────────────────────────────────────────────────────────────
+
+test("regression: 순수 pattern 시나리오는 designsApplied 0 + 기존 패턴 처리 그대로", async () => {
+  const scenario = {
+    Steps: {
+      S1: {
+        StepName: "S1",
+        Contents: [
+          {
+            ContentsType: "Group",
+            Id: "f_1",
+            Contents: [
+              { button: { label: "확인", variant: "primary", width: "full" } },
+              { button: { label: "취소", variant: "secondary", width: "full" } },
+            ],
+          },
+        ],
+      },
+    },
+  };
+  const r = await materializeScenario(scenario);
+  assert.deepEqual(r.errors, []);
+  assert.equal(r.report.patternsApplied, 2);
+  assert.equal(r.report.designsApplied, 0);
+  assert.deepEqual(r.report.designSourceMaps, {});
+});