fix(core,extensions): 창 크기 변경 후 저장 시 편집기 본문이 사라지던 문제

저장소 B(_global._local)를 동기화하는 두 지점이 저장소 A 계열 스냅샷을 그대로
넘겨 왔다. setGlobalState 는 _local 을 얕게 병합하므로 그 쓰기는 patch 가 아니라
통째 교체이며, A 가 아직 받지 못한 값 — CKEditor 가 setLocal({render:false,
selfManaged:true}) 로 B 에만 쓴 본문 — 이 예외도 로그도 없이 사라진다.

handleSetState COMPONENT 분기의 B 쓰기와 sequence 반환값을 함께 live B 기반으로
바꾼다. 요청 body 는 B 가 아니라 그 반환값에서 오므로, B 쓰기만 고치면 저장은
여전히 422 가 난다. 같은 형태의 setParentLocal 도 함께 정정했다.

트리거는 브레이크포인트 교차가 아니라 19px 폭 변경이다 — 모바일 URL바 숨김·
가상키보드·화면 회전이 모두 해당한다. 작성 화면은 422 로, 수정 화면은 성공
토스트와 함께 조용한 데이터 손실로 나타났다.

함께 담은 것:
- ckeditor5: 미리보기 입력이 설정으로 저장되던 문제, 본문만 고치면 저장 버튼이
 비활성으로 남던 문제
- board: 일괄 적용 확인 창의 항목 목록이 통째로 렌더되지 않던 문제(표현식
 평가기가 콜백 안 멤버 대입을 거부), 「금지어」 라벨 누락
- 확장 문서의 Playwright 명령이 코어 config 를 잡아 "No tests found" 로 조용히
 0건이 지나가던 문제
This commit is contained in:
HeuJung committed 2026-09-01 18:08:40 +09:00
1 parent da5f76a9d8
commit cd189190c2
41 files changed
+1899 -117

No files matched your search

+4 -4
View File
@@ -171,8 +171,8 @@
| 종류 | 개수 | 위치 |
|---|---|---|
| PHPUnit | 15개 | `plugins/_bundled/sirsoft-ckeditor5/tests` |
| Vitest | 9개 | `vitest.config.ts` |
| Playwright | 3개 | `tests/Playwright` |
| Vitest | 10개 | `vitest.config.ts` |
| Playwright | 4개 | `tests/Playwright` |
| 시나리오 매니페스트 | 1개 | `tests/scenarios` |
기저 TestCase: `tests/PluginTestCase.php` — 확장 테스트는 이 클래스를 상속합니다 (`Tests\TestCase` 직접 상속 금지).
@@ -184,8 +184,8 @@ php vendor/bin/phpunit plugins/_bundled/sirsoft-ckeditor5/tests --filter='<대
# Vitest (확장 디렉토리에서) (PowerShell)
cd plugins/_bundled/sirsoft-ckeditor5 && powershell -Command "npm run test:run -- <대상>"
# Playwright E2E (Bash)
npx playwright test plugins/_bundled/sirsoft-ckeditor5/tests/Playwright/specs/<대상>.spec.ts
# Playwright E2E (확장 디렉토리에서) (Bash)
cd plugins/_bundled/sirsoft-ckeditor5 && npm run test:e2e -- specs/<대상>.spec.ts
```
@@ -17,6 +17,8 @@
### Fixed
- 관리자 화면에서 글을 수정하다 다른 글의 수정 화면으로 곧바로 옮기면 편집기에 이전 글의 본문이 그대로 남아 있던 문제를 고쳤습니다. 그 상태에서 글자를 입력하면 저장 시 본문이 이전 글의 것으로 덮어써질 수 있었습니다.
- 플러그인 설정 화면에서 미리보기 편집기에 입력한 내용이 설정과 함께 저장되던 문제를 고쳤습니다. 미리보기는 설정을 시험해 보는 자리이므로 저장 대상에서 제외됩니다.
- 글을 수정할 때 본문만 고치면 [저장] 버튼이 계속 비활성으로 남아 저장할 수 없던 문제를 고쳤습니다. 제목 등 다른 항목을 함께 건드리면 버튼이 켜졌기 때문에 화면에 따라 드러나기도 하고 아니기도 했습니다.
- 에디터 스타일과 본문 스타일을 불러오지 못했을 때 아무 표시 없이 서식만 깨지던 문제를 고쳤습니다. 이제 다시 시도한 뒤에도 실패하면 화면에 알립니다.
- 번역 파일을 불러오지 못하면 아무 기록 없이 영어로 표시되던 동작에 경고 기록을 남기고, 일시적인 실패는 다시 시도합니다.
+3 -3
View File
@@ -1,4 +1,4 @@
var SirsoftCkeditor5=function(D){"use strict";const E=new Map;let Z=!1;function _t(){return Z}function K(t){Z=t}const O=new Map;function tt(t,o){const e=O.get(t)??[];e.push(o),O.set(t,e)}function et(t){(O.get(t)??[]).forEach(o=>{try{o.stop()}catch{}}),O.delete(t)}const St=400,vt=1e4;function ot(t,o){const{name:e,locale:n,multilingual:r}=o;let l=location.pathname,i=null,s=!1,k=null,c=0;const a=()=>{const u=window.G7Core?.state?.getLocal?.()?.form;if(!u||!e)return;const f=r?u[e]?.[n]:u[e];return typeof f=="string"?f:void 0},b=window.setInterval(()=>{let d;try{d=t.getData()}catch{window.clearInterval(b);return}location.pathname!==l&&(l=location.pathname,i=null,s=!0,c=Date.now(),k=d);const u=a();if(u!==void 0){if(s){if(u===k){Date.now()-c>vt&&(s=!1,k=null);return}if(u!==d){K(!0);try{t.setData(u)}finally{K(!1)}}s=!1,k=null,i=u;return}if(u===i||u===d){i=u;return}}},St);return{shouldEmit:()=>!s,noteEmitted:d=>{i=d},stop:()=>window.clearInterval(b)}}const Et="43.3.1",F="sirsoft-ckeditor5",H=`dist/vendor/ckeditor5/${Et}`,q="ckeditor5-vendor-css";function V(){const t=window?.G7Core?.asset;if(!t||typeof t.plugin!="function")throw new Error("G7Core.asset is unavailable — core 7.0.10 or later is required to resolve bundled CKEditor5 assets");return t}function xt(){return V().plugin(F,`${H}/ckeditor5.umd.js`)}function nt(){return V().plugin(F,`${H}/ckeditor5.css`)}function Lt(t){return V().plugin(F,`${H}/translations/${t}.umd.js`)}const T="data-ckeditor5-fallback",W=new WeakMap;function j(t,o){const e=window.G7Core;if(!e?.state?.setLocal||!t)return;const n={[`form.${t}_mode`]:"text",hasChanges:!0};if(typeof o=="string")n[`form.${t}`]=o;else for(const[r,l]of Object.entries(o))n[`form.${t}.${r}`]=l;e.state.setLocal(n,{render:!1,selfManaged:!0})}function R(t){const{container:o,name:e,height:n,readOnly:r,placeholder:l,multilingual:i}=t;if(o.querySelector(`[${T}]`))return;o.innerHTML="";const s=i?t.locales??[]:[],k=t.activeLocale??s[0]??"",c=i?{...t.contentMap??{}}:{"":t.initialContent??""},a=document.createElement("textarea");a.setAttribute(T,"1"),a.name=e,a.readOnly=r,a.placeholder=l??"",a.style.cssText=["width:100%",`height:${n}px`,"padding:12px","border:1px solid #d1d5db","border-radius:6px","font-family:inherit","font-size:14px","line-height:1.6","resize:vertical","box-sizing:border-box"].join(";");let b=k;if(i){const d=document.createElement("div");d.className="ckeditor5-locale-tabs";const u=()=>{d.querySelectorAll("button").forEach(f=>{const m=f.dataset.locale??"",w=m===b;f.classList.toggle("is-active",w);const S=(c[m]??"").trim()!=="",v=f.querySelector("[data-check]");v&&(v.style.display=S?"":"none")})};s.forEach((f,m)=>{const w=document.createElement("button");w.type="button",w.dataset.locale=f,m===0&&w.classList.add("is-default"),w.textContent=f.toUpperCase();const S=document.createElement("span");S.dataset.check="1",S.textContent="✓",S.style.display="none",w.appendChild(S),w.addEventListener("click",()=>{c[b]=a.value,b=f,a.value=c[f]??"",a.dataset.locale=f,j(e,c),u()}),d.appendChild(w)}),o.appendChild(d),a.dataset.locale=b,a.value=c[b]??"",u(),a.addEventListener("input",()=>{c[b]=a.value,j(e,c),u()})}else a.value=c[""]??"",a.addEventListener("input",()=>{c[""]=a.value,j(e,a.value)});o.appendChild(a),W.set(o,{multilingual:i,values:c,activeLocale:b}),j(e,i?c:c[""]??"")}function $t(t){const o=W.get(t);if(!o)return null;const e=t.querySelector(`textarea[${T}]`);return e&&(o.values[o.multilingual?e.dataset.locale??o.activeLocale:""]=e.value),o.multilingual?{...o.values}:o.values[""]??""}function It(t){return t.querySelector(`[${T}]`)?(t.innerHTML="",W.delete(t),!0):!1}const rt="ckeditor5-dark-override",lt="ckeditor5-tab-style",ct={minimal:["bold","italic","underline","|","link","uploadImage","|","undo","redo"],standard:["heading","|","bold","italic","underline","strikethrough","|","alignment","|","link","blockQuote","|","bulletedList","numberedList","indent","outdent","|","insertTable","uploadImage","|","undo","redo"],full:["heading","|","fontSize","fontColor","fontBackgroundColor","|","bold","italic","underline","strikethrough","|","alignment","|","link","blockQuote","insertTable","uploadImage","mediaEmbed","horizontalLine","|","bulletedList","numberedList","indent","outdent","|","codeBlock","sourceEditing","|","undo","redo"]};function Gt(t){if(t==="en")return Promise.resolve();const o=`ckeditor5-translations-${t}`;if(document.getElementById(o))return Promise.resolve();const e=window?.G7Core?.asset?.loadScript;return new Promise(n=>{let r;try{r=Lt(t)}catch(i){console.warn("[ckeditor5] 번역 URL 을 만들지 못했습니다 (영어로 동작):",i),n();return}if(typeof e=="function"){e(r,{id:o},{label:`ckeditor5 translations: ${t}`,retries:1}).catch(i=>{console.warn(`[ckeditor5] 번역 로드 실패 (${t}) — 영어로 동작합니다:`,i)}).then(()=>n());return}const l=document.createElement("script");l.id=o,l.src=r,l.onload=()=>n(),l.onerror=()=>{console.warn(`[ckeditor5] 번역 로드 실패 (${t}) — 영어 Line truncated
var SirsoftCkeditor5=function(D){"use strict";const E=new Map;let Z=!1;function _t(){return Z}function K(t){Z=t}const O=new Map;function tt(t,o){const e=O.get(t)??[];e.push(o),O.set(t,e)}function et(t){(O.get(t)??[]).forEach(o=>{try{o.stop()}catch{}}),O.delete(t)}const St=400,vt=1e4;function ot(t,o){const{name:e,locale:n,multilingual:r}=o;let a=location.pathname,i=null,s=!1,k=null,l=0;const c=()=>{const u=window.G7Core?.state?.getLocal?.()?.form;if(!u||!e)return;const f=r?u[e]?.[n]:u[e];return typeof f=="string"?f:void 0},b=window.setInterval(()=>{let d;try{d=t.getData()}catch{window.clearInterval(b);return}location.pathname!==a&&(a=location.pathname,i=null,s=!0,l=Date.now(),k=d);const u=c();if(u!==void 0){if(s){if(u===k){Date.now()-l>vt&&(s=!1,k=null);return}if(u!==d){K(!0);try{t.setData(u)}finally{K(!1)}}s=!1,k=null,i=u;return}if(u===i||u===d){i=u;return}}},St);return{shouldEmit:()=>!s,noteEmitted:d=>{i=d},stop:()=>window.clearInterval(b)}}const Et="43.3.1",F="sirsoft-ckeditor5",H=`dist/vendor/ckeditor5/${Et}`,q="ckeditor5-vendor-css";function V(){const t=window?.G7Core?.asset;if(!t||typeof t.plugin!="function")throw new Error("G7Core.asset is unavailable — core 7.0.10 or later is required to resolve bundled CKEditor5 assets");return t}function xt(){return V().plugin(F,`${H}/ckeditor5.umd.js`)}function nt(){return V().plugin(F,`${H}/ckeditor5.css`)}function Lt(t){return V().plugin(F,`${H}/translations/${t}.umd.js`)}const T="data-ckeditor5-fallback",W=new WeakMap;function j(t,o){const e=window.G7Core;if(!e?.state?.setLocal||!t)return;const n={[`form.${t}_mode`]:"text",hasChanges:!0};if(typeof o=="string")n[`form.${t}`]=o;else for(const[r,a]of Object.entries(o))n[`form.${t}.${r}`]=a;e.state.setLocal(n,{render:!1,selfManaged:!0})}function R(t){const{container:o,name:e,height:n,readOnly:r,placeholder:a,multilingual:i}=t;if(o.querySelector(`[${T}]`))return;o.innerHTML="";const s=i?t.locales??[]:[],k=t.activeLocale??s[0]??"",l=i?{...t.contentMap??{}}:{"":t.initialContent??""},c=document.createElement("textarea");c.setAttribute(T,"1"),c.name=e,c.readOnly=r,c.placeholder=a??"",c.style.cssText=["width:100%",`height:${n}px`,"padding:12px","border:1px solid #d1d5db","border-radius:6px","font-family:inherit","font-size:14px","line-height:1.6","resize:vertical","box-sizing:border-box"].join(";");let b=k;if(i){const d=document.createElement("div");d.className="ckeditor5-locale-tabs";const u=()=>{d.querySelectorAll("button").forEach(f=>{const m=f.dataset.locale??"",w=m===b;f.classList.toggle("is-active",w);const S=(l[m]??"").trim()!=="",v=f.querySelector("[data-check]");v&&(v.style.display=S?"":"none")})};s.forEach((f,m)=>{const w=document.createElement("button");w.type="button",w.dataset.locale=f,m===0&&w.classList.add("is-default"),w.textContent=f.toUpperCase();const S=document.createElement("span");S.dataset.check="1",S.textContent="✓",S.style.display="none",w.appendChild(S),w.addEventListener("click",()=>{l[b]=c.value,b=f,c.value=l[f]??"",c.dataset.locale=f,j(e,l),u()}),d.appendChild(w)}),o.appendChild(d),c.dataset.locale=b,c.value=l[b]??"",u(),c.addEventListener("input",()=>{l[b]=c.value,j(e,l),u()})}else c.value=l[""]??"",c.addEventListener("input",()=>{l[""]=c.value,j(e,c.value)});o.appendChild(c),W.set(o,{multilingual:i,values:l,activeLocale:b}),j(e,i?l:l[""]??"")}function $t(t){const o=W.get(t);if(!o)return null;const e=t.querySelector(`textarea[${T}]`);return e&&(o.values[o.multilingual?e.dataset.locale??o.activeLocale:""]=e.value),o.multilingual?{...o.values}:o.values[""]??""}function It(t){return t.querySelector(`[${T}]`)?(t.innerHTML="",W.delete(t),!0):!1}const rt="ckeditor5-dark-override",at="ckeditor5-tab-style",lt={minimal:["bold","italic","underline","|","link","uploadImage","|","undo","redo"],standard:["heading","|","bold","italic","underline","strikethrough","|","alignment","|","link","blockQuote","|","bulletedList","numberedList","indent","outdent","|","insertTable","uploadImage","|","undo","redo"],full:["heading","|","fontSize","fontColor","fontBackgroundColor","|","bold","italic","underline","strikethrough","|","alignment","|","link","blockQuote","insertTable","uploadImage","mediaEmbed","horizontalLine","|","bulletedList","numberedList","indent","outdent","|","codeBlock","sourceEditing","|","undo","redo"]};function Gt(t){if(t==="en")return Promise.resolve();const o=`ckeditor5-translations-${t}`;if(document.getElementById(o))return Promise.resolve();const e=window?.G7Core?.asset?.loadScript;return new Promise(n=>{let r;try{r=Lt(t)}catch(i){console.warn("[ckeditor5] 번역 URL 을 만들지 못했습니다 (영어로 동작):",i),n();return}if(typeof e=="function"){e(r,{id:o},{label:`ckeditor5 translations: ${t}`,retries:1}).catch(i=>{console.warn(`[ckeditor5] 번역 로드 실패 (${t}) — 영어로 동작합니다:`,i)}).then(()=>n());return}const a=document.createElement("script");a.id=o,a.src=r,a.onload=()=>n(),a.onerror=()=>{console.warn(`[ckeditor5] 번역 로드 실패 (${t}) — 영어 Line truncated
/* 다국어 탭 컨테이너 */
.ckeditor5-locale-tabs {
display: flex;
@@ -332,7 +332,7 @@ var SirsoftCkeditor5=function(D){"use strict";const E=new Map;let Z=!1;function
.ck.ck-editor__editable li::marker {
color: #d1d5db;
}
`,document.head.appendChild(o)}let I=null;function Ut(){I||(I=new MutationObserver(()=>{st()}),I.observe(document.documentElement,{attributes:!0,attributeFilter:["class"]}))}function At(){I&&(I.disconnect(),I=null)}const Pt={ko:"한국어",en:"English",ja:"日本語",zh:"中文",fr:"Français",de:"Deutsch",es:"Español"};function Bt(t){return Pt[t]??t.toUpperCase()}function dt(){const t=window.G7Core;return t?.locale?.supported?t.locale.supported():[localStorage.getItem("g7_locale")||"ko"]}function L(){return window.G7Core?.locale?.current?.()??localStorage.getItem("g7_locale")??"ko"}function Ot(t,o,e){const n=[t.Essentials,t.Bold,t.Italic,t.Underline,t.Strikethrough,t.Link,t.Paragraph,t.Heading,t.BlockQuote,t.List,t.Alignment,t.Table,t.TableToolbar,t.TableProperties,t.TableCellProperties,t.Indent,t.IndentBlock,t.PasteFromOffice,t.GeneralHtmlSupport,t.Image,t.ImageResize,t.ImageStyle,t.ImageCaption,t.ImageToolbar];return o==="full"&&n.push(t.MediaEmbed,t.HorizontalLine,t.CodeBlock,t.SourceEditing,t.FontSize,t.FontColor,t.FontBackgroundColor),e&&n.push(t.ImageUpload,t.SimpleUploadAdapter),n}function Tt(){return"/api/plugins/sirsoft-ckeditor5/upload"}function jt(){const t=localStorage.getItem("auth_token");return t?{Authorization:`Bearer ${t}`}:{}}async function ut(t,o){const e=window.CKEDITOR;if(!e)throw new Error("[sirsoft-ckeditor5] CKEDITOR 전역 객체를 찾을 수 없습니다. CDN 스크립트가 로드되었는지 확인하세요.");const n=ct[o.toolbar]||ct.standard,r=o.imageUpload?n:n.filter(c=>c!=="uploadImage"),l={initialData:o.initialContent,plugins:Ot(e,o.toolbar,o.imageUpload),toolbar:{items:r},table:{contentToolbar:["tableColumn","tableRow","mergeTableCells","|","tableProperties","tableCellProperties"],tableProperties:{defaultProperties:{borderStyle:"solid",borderColor:"#d1d5db",borderWidth:"1px",alignment:"left"}},tableCellProperties:{defaultProperties:{borderStyle:"solid",borderColor:"#d1d5db",borderWidth:"1px",padding:"8px"}}},image:{toolbar:["imageStyle:inline","imageStyle:alignLeft","imageStyle:alignCenter","imageStyle:alignRight","|","toggleImageCaption","|","resizeImage"],resizeOptions:[{name:"resizeImage:original",label:"Original",value:null},{name:"resizeImage:25",label:"25%",value:"25"},{name:"resizeImage:50",label:"50%",value:"50"},{name:"resizeImage:75",label:"75%",value:"75"}],resizeUnit:"%"},indentBlock:{offset:40,unit:"px"},link:{defaultProtocol:"https://",decorators:{openInNewTab:{mode:"automatic",callback:c=>c.startsWith("http://")||c.startsWith("https://"),attributes:{target:"_blank",rel:"noopener noreferrer"}}}},htmlSupport:{allow:[{name:/.*/,attributes:!0,classes:!0,styles:!0}]},placeholder:o.placeholder,language:L()};o.imageUpload&&(l.simpleUpload={uploadUrl:Tt(),headers:jt()});const i=await e.ClassicEditor.create(t,l),s=`ckeditor5-height-style-${o.containerId}`,k=document.getElementById(s);if(k)k.textContent=`#${o.containerId} .ck-editor__editable { min-height: ${o.height}px !important; }`;else{const c=document.createElement("style");c.id=s,c.textContent=`#${o.containerId} .ck-editor__editable { min-height: ${o.height}px !important; }`,document.head.appendChild(c)}return o.readOnly&&i.enableReadOnlyMode("read-only"),i}function Nt(t,o,e,n,r){const l=document.createElement("div");l.className="ckeditor5-locale-tabs";const i=new Map;o.forEach(c=>{const a=document.createElement("div");a.dataset.locale=c,c!==e&&(a.style.cssText="display:none;");const b=document.createElement("div");a.appendChild(b),i.set(c,b)});const s=()=>{r&&l.querySelectorAll("button").forEach(c=>{const a=c.dataset.locale;if(!a||c.classList.contains("is-active")){const f=c.querySelector(".ck5-check");f&&f.remove();return}const d=!!r(a)?.trim(),u=c.querySelector(".ck5-check");if(d&&!u){const f=document.createElement("i");f.className="fas fa-check ck5-check",c.appendChild(f)}else!d&&u&&u.remove()})},k=o[0];return o.forEach(c=>{const a=c===k,b=c===e,d=document.createElement("button");d.type="button",d.dataset.locale=c,d.className=[b?"is-active":"",a?"is-default":""].filter(Boolean).join(" "),d.innerHTML=`<i class="fas fa-globe ck5-lang-icon"></i><span>${Bt(c)}</span>${a?'<span class="ck5-required">*</span>':""}`,d.addEventListener("click",async()=>{l.querySelectorAll("button").forEach(u=>{const m=u.dataset.locale===c;u.classList.toggle("is-active",m)}),i.forEach((u,f)=>{const m=u.parentElement;m&&(m.style.display=f===c?"block":"none")}),n&&await n(c),s()}),l.appendChild(d)}),t.appendChild(l),i.forEach(c=>{c.parentElement&&t.appendChild(c.parentElement)}),{tabsEl:l,contentEls:i,updateCheckIcons:s}}function ft(t,o,e,n){if(_t())return;const r=window.G7Core;if(!r?.state?.setLocal)return;const l={[`form.${t}_mode`]:"html",hasChanges:!0};n?l[`form.${t}.${o}`]=e:l[`form.${t}`]=e,r.state.setLocal(l,{debounce:300,debounceKey:`ckeditor-sync-${t}`,render:!1,selfManaged:!0})}function kt(t,o){const e=window.G7Core,n=typeof t.content=="string"?t.content:"";let l=n.startsWith("{{")&&n.endsWith("}}")?"":n;if(!l&&o){consLine truncated
`,document.head.appendChild(o)}let I=null;function Ut(){I||(I=new MutationObserver(()=>{st()}),I.observe(document.documentElement,{attributes:!0,attributeFilter:["class"]}))}function At(){I&&(I.disconnect(),I=null)}const Pt={ko:"한국어",en:"English",ja:"日本語",zh:"中文",fr:"Français",de:"Deutsch",es:"Español"};function Bt(t){return Pt[t]??t.toUpperCase()}function dt(){const t=window.G7Core;return t?.locale?.supported?t.locale.supported():[localStorage.getItem("g7_locale")||"ko"]}function L(){return window.G7Core?.locale?.current?.()??localStorage.getItem("g7_locale")??"ko"}function Ot(t,o,e){const n=[t.Essentials,t.Bold,t.Italic,t.Underline,t.Strikethrough,t.Link,t.Paragraph,t.Heading,t.BlockQuote,t.List,t.Alignment,t.Table,t.TableToolbar,t.TableProperties,t.TableCellProperties,t.Indent,t.IndentBlock,t.PasteFromOffice,t.GeneralHtmlSupport,t.Image,t.ImageResize,t.ImageStyle,t.ImageCaption,t.ImageToolbar];return o==="full"&&n.push(t.MediaEmbed,t.HorizontalLine,t.CodeBlock,t.SourceEditing,t.FontSize,t.FontColor,t.FontBackgroundColor),e&&n.push(t.ImageUpload,t.SimpleUploadAdapter),n}function Tt(){return"/api/plugins/sirsoft-ckeditor5/upload"}function jt(){const t=localStorage.getItem("auth_token");return t?{Authorization:`Bearer ${t}`}:{}}async function ut(t,o){const e=window.CKEDITOR;if(!e)throw new Error("[sirsoft-ckeditor5] CKEDITOR 전역 객체를 찾을 수 없습니다. CDN 스크립트가 로드되었는지 확인하세요.");const n=lt[o.toolbar]||lt.standard,r=o.imageUpload?n:n.filter(l=>l!=="uploadImage"),a={initialData:o.initialContent,plugins:Ot(e,o.toolbar,o.imageUpload),toolbar:{items:r},table:{contentToolbar:["tableColumn","tableRow","mergeTableCells","|","tableProperties","tableCellProperties"],tableProperties:{defaultProperties:{borderStyle:"solid",borderColor:"#d1d5db",borderWidth:"1px",alignment:"left"}},tableCellProperties:{defaultProperties:{borderStyle:"solid",borderColor:"#d1d5db",borderWidth:"1px",padding:"8px"}}},image:{toolbar:["imageStyle:inline","imageStyle:alignLeft","imageStyle:alignCenter","imageStyle:alignRight","|","toggleImageCaption","|","resizeImage"],resizeOptions:[{name:"resizeImage:original",label:"Original",value:null},{name:"resizeImage:25",label:"25%",value:"25"},{name:"resizeImage:50",label:"50%",value:"50"},{name:"resizeImage:75",label:"75%",value:"75"}],resizeUnit:"%"},indentBlock:{offset:40,unit:"px"},link:{defaultProtocol:"https://",decorators:{openInNewTab:{mode:"automatic",callback:l=>l.startsWith("http://")||l.startsWith("https://"),attributes:{target:"_blank",rel:"noopener noreferrer"}}}},htmlSupport:{allow:[{name:/.*/,attributes:!0,classes:!0,styles:!0}]},placeholder:o.placeholder,language:L()};o.imageUpload&&(a.simpleUpload={uploadUrl:Tt(),headers:jt()});const i=await e.ClassicEditor.create(t,a),s=`ckeditor5-height-style-${o.containerId}`,k=document.getElementById(s);if(k)k.textContent=`#${o.containerId} .ck-editor__editable { min-height: ${o.height}px !important; }`;else{const l=document.createElement("style");l.id=s,l.textContent=`#${o.containerId} .ck-editor__editable { min-height: ${o.height}px !important; }`,document.head.appendChild(l)}return o.readOnly&&i.enableReadOnlyMode("read-only"),i}function Nt(t,o,e,n,r){const a=document.createElement("div");a.className="ckeditor5-locale-tabs";const i=new Map;o.forEach(l=>{const c=document.createElement("div");c.dataset.locale=l,l!==e&&(c.style.cssText="display:none;");const b=document.createElement("div");c.appendChild(b),i.set(l,b)});const s=()=>{r&&a.querySelectorAll("button").forEach(l=>{const c=l.dataset.locale;if(!c||l.classList.contains("is-active")){const f=l.querySelector(".ck5-check");f&&f.remove();return}const d=!!r(c)?.trim(),u=l.querySelector(".ck5-check");if(d&&!u){const f=document.createElement("i");f.className="fas fa-check ck5-check",l.appendChild(f)}else!d&&u&&u.remove()})},k=o[0];return o.forEach(l=>{const c=l===k,b=l===e,d=document.createElement("button");d.type="button",d.dataset.locale=l,d.className=[b?"is-active":"",c?"is-default":""].filter(Boolean).join(" "),d.innerHTML=`<i class="fas fa-globe ck5-lang-icon"></i><span>${Bt(l)}</span>${c?'<span class="ck5-required">*</span>':""}`,d.addEventListener("click",async()=>{a.querySelectorAll("button").forEach(u=>{const m=u.dataset.locale===l;u.classList.toggle("is-active",m)}),i.forEach((u,f)=>{const m=u.parentElement;m&&(m.style.display=f===l?"block":"none")}),n&&await n(l),s()}),a.appendChild(d)}),t.appendChild(a),i.forEach(l=>{l.parentElement&&t.appendChild(l.parentElement)}),{tabsEl:a,contentEls:i,updateCheckIcons:s}}function ft(t,o,e,n){if(_t())return;const r=window.G7Core;if(!r?.state?.setLocal)return;r.state.getLocal?.()?.hasChanges!==!0&&r.state.setLocal({hasChanges:!0});const a={[`form.${t}_mode`]:"html"};n?a[`form.${t}.${o}`]=e:a[`form.${t}`]=e,r.state.setLocal(a,{debounce:300,debounceKey:`ckeditor-sync-${t}`,render:!1,selfManaged:!0})}function kt(t,o){const e=window.G7Core,n=typeof t.content=="string"?t.content:"";letLine truncated
/* 이미지 캡션 - 다크모드 */
html.dark .ck-content .image > figcaption { color: hsl(0, 0%, 80%); background-color: hsl(0, 0%, 15%); }
@@ -369,4 +369,4 @@ var SirsoftCkeditor5=function(D){"use strict";const E=new Map;let Z=!1;function
.ck-content ul ul ul { list-style-type: square; padding-left: 2em; }
.ck-content ol ol { list-style-type: lower-alpha; padding-left: 2em; }
.ck-content ol ol ol { list-style-type: lower-roman; padding-left: 2em; }
`,document.head.appendChild(t)}}const $={initEditor:mt,destroyEditor:Dt,injectContentCss:pt},U=window.G7Core?.createLogger?.(`Plugin:${y}`)??{log:(...t)=>console.log(`[Plugin:${y}]`,...t),warn:(...t)=>console.warn(`[Plugin:${y}]`,...t),error:(...t)=>console.error(`[Plugin:${y}]`,...t)};function ht(t=!1){const o=window.G7Core?.getActionDispatcher?.();if(o)Object.entries($).forEach(([e,n])=>{const r=`${y}.${e}`;o.registerHandler(r,n,{category:"plugin",source:y})}),U.log(`${Object.keys($).length} handler(s) registered:`,Object.keys($).map(e=>`${y}.${e}`));else if(t){let e=0;const n=50,r=()=>{const l=window.G7Core?.getActionDispatcher?.();l?(Object.entries($).forEach(([i,s])=>{const k=`${y}.${i}`;l.registerHandler(k,s,{category:"plugin",source:y})}),U.log(`${Object.keys($).length} handler(s) registered:`,Object.keys($).map(i=>`${y}.${i}`))):(e++,e<=n?(U.warn(`ActionDispatcher not found, retrying... (${e}/${n})`),setTimeout(r,100)):U.error("Failed to register handlers: ActionDispatcher not available after maximum retries"))};r()}else U.warn("ActionDispatcher not found, handlers not registered")}function X(){if(document.readyState==="loading")document.addEventListener("DOMContentLoaded",()=>ht(!0));else{const t=!!window.G7Core?.getActionDispatcher?.();ht(!t)}}return X(),typeof window<"u"&&(window.__SirsoftCkeditor5={identifier:y,handlers:Object.keys($),initPlugin:X}),D.initPlugin=X,Object.defineProperty(D,Symbol.toStringTag,{value:"Module"}),D}({});
`,document.head.appendChild(t)}}const $={initEditor:mt,destroyEditor:Dt,injectContentCss:pt},U=window.G7Core?.createLogger?.(`Plugin:${y}`)??{log:(...t)=>console.log(`[Plugin:${y}]`,...t),warn:(...t)=>console.warn(`[Plugin:${y}]`,...t),error:(...t)=>console.error(`[Plugin:${y}]`,...t)};function ht(t=!1){const o=window.G7Core?.getActionDispatcher?.();if(o)Object.entries($).forEach(([e,n])=>{const r=`${y}.${e}`;o.registerHandler(r,n,{category:"plugin",source:y})}),U.log(`${Object.keys($).length} handler(s) registered:`,Object.keys($).map(e=>`${y}.${e}`));else if(t){let e=0;const n=50,r=()=>{const a=window.G7Core?.getActionDispatcher?.();a?(Object.entries($).forEach(([i,s])=>{const k=`${y}.${i}`;a.registerHandler(k,s,{category:"plugin",source:y})}),U.log(`${Object.keys($).length} handler(s) registered:`,Object.keys($).map(i=>`${y}.${i}`))):(e++,e<=n?(U.warn(`ActionDispatcher not found, retrying... (${e}/${n})`),setTimeout(r,100)):U.error("Failed to register handlers: ActionDispatcher not available after maximum retries"))};r()}else U.warn("ActionDispatcher not found, handlers not registered")}function X(){if(document.readyState==="loading")document.addEventListener("DOMContentLoaded",()=>ht(!0));else{const t=!!window.G7Core?.getActionDispatcher?.();ht(!t)}}return X(),typeof window<"u"&&(window.__SirsoftCkeditor5={identifier:y,handlers:Object.keys($),initPlugin:X}),D.initPlugin=X,Object.defineProperty(D,Symbol.toStringTag,{value:"Module"}),D}({});
@@ -0,0 +1,121 @@
/**
* 회귀: 본문만 고쳐도 저장 버튼이 활성화된다 (`hasChanges` 를 본문 배치에서 분리)
*
* 결함: `syncToForm` 이 `hasChanges: true` 를 본문과 **같은**
* `setLocal({ render:false, selfManaged:true })` 배치에 넣었다. 그 배치는 React 렌더를
* 일으키지 않으므로(성능 — 37,000+ 바인딩 재평가 회피) 저장소 A 는 플래그를 받지 못하고,
* 저장 버튼의 활성 조건 `{{!_local.hasChanges || _local.isSaving}}` 이 재평가되지 않는다.
* 결과적으로 **본문만 고친 운영자는 저장 자체를 할 수 없다** — 오류도 안내도 없이 버튼이
* 계속 비활성으로 남는다.
*
* 제목 등 다른 입력을 함께 건드리면 그 입력의 자동바인딩이 렌더를 일으켜 증상이 가려지므로,
* 화면·게시판에 따라 드러나기도 하고 아니기도 한다(관리자 게시글 수정 화면에서 실측 재현).
*
* 계약:
* 1. `hasChanges` 는 렌더를 일으키는 별도 setLocal 로 보낸다 (render:false 배치에 넣지 않는다)
* 2. 이미 true 면 보내지 않는다 — 편집 세션당 추가 렌더는 최대 1회 (성능 회귀 차단)
* 3. 본문은 종전대로 debounce + render:false + selfManaged:true 를 유지한다
*/
import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
import { syncToForm } from '../../handlers/initEditor';
type Call = { updates: Record<string, any>; options?: Record<string, any> };
let calls: Call[] = [];
let localState: Record<string, any> = {};
/**
* G7Core 전역 스텁을 설치합니다.
*
* @param initialLocal 초기 로컬 상태 (`hasChanges` 포함 가능)
*/
function stubG7Core(initialLocal: Record<string, any> = {}): void {
localState = { ...initialLocal };
calls = [];
(window as any).G7Core = {
state: {
getLocal: () => localState,
setLocal: (updates: Record<string, any>, options?: Record<string, any>) => {
calls.push({ updates, options });
localState = { ...localState, ...updates };
},
},
};
}
/** `hasChanges` 를 보낸 호출만 고른다. */
const hasChangesCalls = () => calls.filter((c) => 'hasChanges' in c.updates);
/** 본문(form.*)을 보낸 호출만 고른다. */
const contentCalls = () => calls.filter((c) => Object.keys(c.updates).some((k) => k.startsWith('form.')));
describe('편집기 본문 동기화 — hasChanges 렌더 분리 (저장 버튼 비활성 회귀)', () => {
beforeEach(() => {
stubG7Core();
vi.restoreAllMocks();
});
afterEach(() => {
delete (window as any).G7Core;
});
it('hasChanges 를 render:false 배치에 넣지 않는다 (넣으면 저장 버튼이 안 켜진다)', () => {
syncToForm('content', 'ko', '<p>본문</p>', false);
for (const c of contentCalls()) {
expect(
'hasChanges' in c.updates,
'hasChanges 가 본문 배치에 섞이면 저장소 A 가 못 받아 버튼이 비활성으로 남는다',
).toBe(false);
}
});
it('hasChanges 는 렌더를 일으키는 setLocal 로 보낸다', () => {
syncToForm('content', 'ko', '<p>본문</p>', false);
const flag = hasChangesCalls();
expect(flag, 'hasChanges 를 보내는 호출이 있어야 한다').toHaveLength(1);
expect(flag[0].updates.hasChanges).toBe(true);
// render:false / selfManaged 가 붙으면 React 가 다시 그리지 않아 버튼이 갱신되지 않는다
expect(flag[0].options?.render, 'render:false 면 안 된다').not.toBe(false);
expect(flag[0].options?.selfManaged, 'selfManaged 면 안 된다').not.toBe(true);
});
it('이미 hasChanges 가 true 면 다시 보내지 않는다 (세션당 추가 렌더 1회)', () => {
stubG7Core({ hasChanges: true });
syncToForm('content', 'ko', '<p>1</p>', false);
syncToForm('content', 'ko', '<p>12</p>', false);
syncToForm('content', 'ko', '<p>123</p>', false);
expect(hasChangesCalls(), '이미 true 면 추가 렌더를 만들지 않는다').toHaveLength(0);
});
it('연속 입력에서도 hasChanges 렌더는 첫 1회뿐이다', () => {
syncToForm('content', 'ko', '<p>a</p>', false);
syncToForm('content', 'ko', '<p>ab</p>', false);
syncToForm('content', 'ko', '<p>abc</p>', false);
expect(hasChangesCalls(), '첫 입력에서만 플래그를 올린다').toHaveLength(1);
expect(contentCalls(), '본문은 매번 보낸다 (디바운스는 엔진이 처리)').toHaveLength(3);
});
it('본문 배치는 종전 성능 옵션을 유지한다 (debounce + render:false + selfManaged)', () => {
syncToForm('content', 'ko', '<p>본문</p>', false);
const body = contentCalls();
expect(body).toHaveLength(1);
expect(body[0].options?.render).toBe(false);
expect(body[0].options?.selfManaged).toBe(true);
expect(body[0].options?.debounce).toBe(300);
expect(body[0].updates['form.content']).toBe('<p>본문</p>');
expect(body[0].updates['form.content_mode']).toBe('html');
});
it('다국어 모드는 로케일 경로로 보낸다', () => {
syncToForm('content', 'ja', '<p>本文</p>', true);
const body = contentCalls();
expect(body[0].updates['form.content.ja']).toBe('<p>本文</p>');
expect(hasChangesCalls()).toHaveLength(1);
});
});
@@ -1096,8 +1096,12 @@ function createMultilingualTabs(
/**
* 폼 데이터 업데이트를 위해 G7Core setState를 호출합니다.
*
* 테스트를 위해 export 한다 — `hasChanges` 를 본문과 분리해 보내는 계약은 화면에서
* "저장 버튼이 계속 비활성" 으로만 드러나므로 단위 테스트로 잠근다
* (`resolveSingleContent` 와 같은 선례).
*/
function syncToForm(
export function syncToForm(
name: string,
locale: string,
value: string,
@@ -1111,9 +1115,24 @@ function syncToForm(
return;
}
// `hasChanges` 는 아래 본문 배치와 함께 보내면 안 된다.
//
// 그 배치는 `render: false` + `selfManaged: true` 라 React 렌더를 일으키지 않는다(성능 —
// 37,000+ 바인딩 재평가 회피). 그런데 저장 버튼의 활성 조건이 `{{!_local.hasChanges || ...}}`
// 처럼 이 플래그를 읽는 화면에서는, 플래그가 저장소 B 에만 들어가고 React 가 다시 그리지
// 않아 **버튼이 계속 비활성으로 남는다** — 본문만 고친 운영자는 저장 자체를 할 수 없다.
// (관리자 게시글 수정 화면에서 실측 재현. 제목 등 다른 입력을 함께 건드리면 그 입력의
// 자동바인딩이 렌더를 일으켜 가려지므로, 화면·보드에 따라 드러나기도 하고 아니기도 한다.)
//
// 이 플래그는 스칼라 한 개라 본문과 달리 성능 사유가 없다. 그래서 렌더를 일으키는 일반
// setLocal 로 분리하되, **false → true 로 처음 넘어갈 때만** 보낸다. 이미 true 면 건너뛰므로
// 편집 세션당 추가 렌더는 최대 1회다.
if (G7Core.state.getLocal?.()?.hasChanges !== true) {
G7Core.state.setLocal({ hasChanges: true });
}
const updates: Record<string, any> = {
[`form.${name}_mode`]: 'html',
hasChanges: true,
};
if (isMultilingual) {
@@ -779,11 +779,12 @@
},
{
"handler": "apiCall",
"comment": "미리보기 편집기(preview_editor)는 props.name 이 preview_content 라 폼 자동바인딩으로 _local.form 에 쌓인다. 저장 대상이 아니므로 body 에서 제외한다 — 그대로 두면 운영자가 미리보기에 입력한 내용이 플러그인 설정으로 저장된다. 표현식 평가기는 구조분해 rest(const { a, ...rest } = obj)와 콜백 안의 멤버 대입(out[k] = v)을 지원하지 않는다 — 쓰면 식이 평가되지 않고 원문 문자열이 그대로 body 로 전송된다(오류 없이 200 이 떨어져 드러나지 않는다). Object.entries/filter/fromEntries 조합만 사용할 것(브라우저 실측으로 확인).",
"auth_required": true,
"target": "/api/admin/plugins/{{route.identifier}}/settings",
"params": {
"method": "PUT",
"body": "{{_local.form}}"
"body": "{{(function() { const form = _local.form || {}; return Object.fromEntries(Object.entries(form).filter(entry => entry[0] !== 'preview_content' && entry[0] !== 'preview_content_mode')); })()}}"
},
"onSuccess": [
{
@@ -0,0 +1,351 @@
/**
* E2E: 브라우저 폭이 바뀐 뒤 저장해도 편집기 본문이 사라지지 않는다 (공개 이슈 #130)
*
* 배경: 엔진은 폼 상태를 React `localDynamicState`(저장소 A)와 `globalState._local`(저장소 B)에
* 이중 저장한다. CKEditor 는 `setLocal({ render:false, selfManaged:true })` 로 **B 에만** 본문을
* 쓴다 — 그 호출은 React 렌더를 한 번도 일으키지 않으므로 `context.state` 는 입력 이전 스냅샷에
* 머문다. 여기에 **브레이크포인트를 넘지 않는 폭 변경**(19px 로 충분)이 겹치면 의존성 배열 없는
* `useLayoutEffect` 가 `__g7PendingLocalState` 를 null 로 지우고, 저장 시 setState 의 base 가
* stale A 로 떨어져 B 와 sequence 반환값이 함께 오염된다.
*
* 증상은 화면에 드러나지 않는다:
* - 작성 화면: `내용은 필수입니다` 422
* - 수정 화면: **성공 토스트가 뜨고 직전 본문이 저장되어 편집분이 사라진다**
* - 콘솔 에러 0건
*
* 그래서 확인해야 하는 것은 "저장됐다" 가 아니라 **요청 body 의 content** 다.
*
* 결정화(없으면 간헐적 false green):
* 1. 타이핑 후 저장소 B 에 마커가 실릴 때까지 poll (CKEditor 디바운스 발화 확정)
* 2. 폭 변경
* 3. `__g7PendingLocalState === null` 이 될 때까지 poll (리렌더 완료 확정)
* 4. 저장 클릭
*
* 준수 사항:
* - 본문 입력은 `pressSequentially` — `fill`/`editor.setData()` 는 `change:data` → `syncToForm`
* 경로를 타지 않아 재현 조건 자체가 성립하지 않는다
* - 화면 진입 후에는 `page.goto` 금지 (전체 새로고침이 모든 렌더러를 재마운트해 조건이 사라진다)
* - 입력 순서는 **제목 먼저 → 본문 나중** 고정 (본문 뒤에 다른 입력이 오면 그 렌더가 memo 를
* 재계산시켜 조건이 사라진다)
*
* @see 트러블슈팅 사례 40 (저장소 B 통째 교체 + stale 반환값)
*/
import { test, expect, authenticatePage } from '../../fixtures/ckeditor5-auth';
import type { Page } from '@playwright/test';
const BOARD = 'notice';
const API = `/api/modules/sirsoft-board/admin/board/${BOARD}/posts`;
/** 브레이크포인트를 넘지 않는 폭 변경 (desktop 구간 안에서만 움직인다) */
const SAME_BREAKPOINT = { from: { width: 1440, height: 900 }, to: { width: 1421, height: 900 } };
/** 브레이크포인트를 넘는 폭 변경 (desktop → tablet) */
const CROSSED_BREAKPOINT = { from: { width: 1034, height: 900 }, to: { width: 1015, height: 900 } };
test.describe.configure({ mode: 'serial' });
/**
* 저장소 B(`globalState._local`) 에 마커가 실릴 때까지 기다립니다 — 디바운스 발화 확정.
*
* @param page Playwright 페이지
* @param marker 본문에 넣은 마커 문자열
*/
async function waitForDebounceFlush(page: Page, marker: string): Promise<void> {
await expect
.poll(
() =>
page.evaluate(() => {
const w = window as any;
const c = w.__templateApp?.getGlobalState?.()?._local?.form?.content;
return typeof c === 'string' ? c : JSON.stringify(c ?? '');
}),
{ timeout: 15_000, message: 'CKEditor 디바운스가 저장소 B 에 본문을 기록해야 한다' },
)
.toContain(marker);
}
/**
* 폭 변경이 `__g7PendingLocalState` 를 비울 때까지 기다립니다 — 리렌더 완료 확정.
*
* @param page Playwright 페이지
*/
async function waitForPendingCleared(page: Page): Promise<void> {
await expect
.poll(() => page.evaluate(() => (window as any).__g7PendingLocalState === null), {
timeout: 15_000,
message: '폭 변경 리렌더가 __g7PendingLocalState 를 비워야 한다 (재현 조건의 절반)',
})
.toBe(true);
}
/**
* 게시글을 API 로 만들고 id 를 돌려줍니다.
*
* @param request Playwright 요청 컨텍스트
* @param token 권한 토큰
* @param title 제목
* @param content 본문 (HTML)
* @return 생성된 게시글 id
*/
async function createPost(
request: import('@playwright/test').APIRequestContext,
token: string,
title: string,
content: string,
): Promise<number> {
const res = await request.post(API, {
headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },
data: { title, content, content_mode: 'html' },
});
expect(res.ok(), `게시글 생성이 성공해야 한다 (status ${res.status()})`).toBeTruthy();
return (await res.json()).data.id as number;
}
test.describe('폭 변경 후 저장 — 편집기 본문 보존', () => {
test.beforeEach(({}, testInfo) => {
testInfo.setTimeout(180_000);
});
/**
* 작성 화면 본문: 폭 변경 후 저장하고 요청 body 를 검사합니다.
*
* `@scenario` 마커는 축 값을 담으므로 각 `test` 안에 **리터럴로** 둔다 —
* 템플릿 리터럴로 만들면 주석 안에서 보간되지 않아 죽은 마커가 되고,
* 게이트는 그것을 조용히 통과시킨다.
*
* @param page Playwright 페이지
* @param editorToken 권한 토큰
* @param viewport 폭 변경 전/후 뷰포트
*/
async function runCreateFlow(
page: Page,
editorToken: string,
viewport: { from: { width: number; height: number }; to: { width: number; height: number } },
): Promise<void> {
const marker = `RESIZE-CREATE-${Date.now()}`;
const consoleErrors: string[] = [];
page.on('console', (m) => {
if (m.type() === 'error') consoleErrors.push(m.text());
});
await page.setViewportSize(viewport.from);
await authenticatePage(page, editorToken);
await page.goto(`/admin/board/${BOARD}/create`);
const editor = page.locator('.ck-editor__editable').first();
await expect(editor).toBeVisible({ timeout: 30_000 });
// 제목 먼저 → 본문 나중 (순서 고정)
await page.locator('input[name="title"]').pressSequentially(`제목 ${marker}`);
await editor.click();
await editor.pressSequentially(marker);
await waitForDebounceFlush(page, marker); // ① 디바운스 발화 확정
// 주장하는 것은 "이 앱에 콘솔 에러가 하나도 없다" 가 아니라 **폭 변경 → 저장 구간이
// 조용하다** 는 것이다. 진입 시점의 에러(환경별 자산 404 등)까지 싸잡으면 이 축이
// 결함과 무관한 이유로 red 가 되어, 정작 지켜야 할 "조용함" 이 신호를 잃는다.
consoleErrors.length = 0;
await page.setViewportSize(viewport.to); // ② 폭 변경
await waitForPendingCleared(page); // ③ 리렌더 완료 확정
const [request, response] = await Promise.all([
page.waitForRequest((r) => r.url().includes('/posts') && r.method() === 'POST'),
page.waitForResponse((r) => r.url().includes('/posts') && r.request().method() === 'POST'),
page.locator('#footer_save_button').click(), // ④ 저장
]);
expect(String(request.postDataJSON().content ?? ''), '요청 body 의 본문에 입력한 마커가 있어야 한다').toContain(marker);
expect(response.status(), '저장이 422 가 아니어야 한다').toBeLessThan(400);
expect(consoleErrors, '폭 변경 → 저장 구간은 조용해야 한다 (이 결함은 콘솔에 아무것도 남기지 않으므로 조용함 자체를 고정한다)').toEqual([]);
}
/**
* 수정 화면 본문: 폭 변경 후 저장하고 요청 body 와 DB 반영을 함께 검사합니다.
*
* @param page Playwright 페이지
* @param request Playwright 요청 컨텍스트
* @param editorToken 권한 토큰
* @param viewport 폭 변경 전/후 뷰포트
*/
async function runEditFlow(
page: Page,
request: import('@playwright/test').APIRequestContext,
editorToken: string,
viewport: { from: { width: number; height: number }; to: { width: number; height: number } },
): Promise<void> {
const original = `ORIGINAL-${Date.now()}`;
const added = `ADDED-${Date.now()}`;
const id = await createPost(request, editorToken, `수정대상 ${original}`, `<p>${original}</p>`);
await page.setViewportSize(viewport.from);
await authenticatePage(page, editorToken);
await page.goto(`/admin/board/${BOARD}/${id}/edit`);
const editor = page.locator('.ck-editor__editable').first();
await expect(editor).toContainText(original, { timeout: 30_000 });
// 제목 먼저 → 본문 나중 (순서 고정).
//
// 제목을 함께 건드리는 것은 편의가 아니라 필수다 — 본문만 고치면 저장 버튼이 계속
// disabled 로 남아 클릭이 무반응이 된다. CKEditor 의 setLocal({render:false}) 은 저장소 B
// 의 hasChanges 만 true 로 만들고 React 렌더를 일으키지 않아, 버튼의 disabled 바인딩
// (저장소 A 기준)이 재평가되지 않기 때문이다. 이 결함은 #130 수정 범위 밖의 **표시 축**
// 이며(저장소 A 를 건드리는 경로는 2026-04-22 철회 이력이 있는 영역이다), 여기서는
// 재현 조건을 성립시키기 위해 제목을 먼저 건드린다.
await page.locator('input[name="title"]').pressSequentially('!');
await editor.click();
await editor.pressSequentially(added);
await waitForDebounceFlush(page, added);
await page.setViewportSize(viewport.to);
await waitForPendingCleared(page);
const [saveRequest, saveResponse] = await Promise.all([
page.waitForRequest((r) => r.url().includes('/posts') && r.method() === 'PUT'),
page.waitForResponse((r) => r.url().includes('/posts') && r.request().method() === 'PUT'),
page.locator('#footer_save_button').click(),
]);
const sent = String(saveRequest.postDataJSON().content ?? '');
expect(sent, '원본 본문이 남아 있어야 한다').toContain(original);
expect(sent, '방금 입력한 편집분이 실려야 한다 — 이것이 조용한 손실 축이다').toContain(added);
expect(saveResponse.status(), '수정 저장이 성공해야 한다').toBeLessThan(400);
// 서버에 실제로 반영됐는지까지 본다 — 이 화면은 실패해도 성공 토스트가 뜨므로
// 화면 피드백으로는 판정할 수 없다. 응답을 기다린 뒤 재조회한다.
const check = await request.get(`${API}/${id}`, {
headers: { Authorization: `Bearer ${editorToken}`, Accept: 'application/json' },
});
expect(String((await check.json()).data.content ?? ''), 'DB 에 편집분이 남아야 한다').toContain(added);
}
test('작성: 같은 브레이크포인트 안에서 폭을 바꿔도 본문이 그대로 전송된다', async ({ page, editorToken }) => {
// @scenario save_flow=create, resize_kind=same_breakpoint
// @effects request_body_content_matches_editor_getdata, create_save_returns_2xx_not_422, canonical_local_keeps_editor_content_after_resize, resize_save_emits_no_console_errors
await runCreateFlow(page, editorToken, SAME_BREAKPOINT);
});
test('작성: 브레이크포인트를 넘겨 폭을 바꿔도 본문이 그대로 전송된다', async ({ page, editorToken }) => {
// @scenario save_flow=create, resize_kind=crossed_breakpoint
// @effects request_body_content_matches_editor_getdata, create_save_returns_2xx_not_422, canonical_local_keeps_editor_content_after_resize, resize_save_emits_no_console_errors
await runCreateFlow(page, editorToken, CROSSED_BREAKPOINT);
});
test('수정: 같은 브레이크포인트 안에서 폭을 바꿔도 편집분이 유실되지 않는다', async ({ page, request, editorToken }) => {
// @scenario save_flow=edit, resize_kind=same_breakpoint
// @effects request_body_content_matches_editor_getdata, edit_save_persists_typed_addition, canonical_local_keeps_editor_content_after_resize, success_toast_only_when_content_actually_saved
await runEditFlow(page, request, editorToken, SAME_BREAKPOINT);
});
test('수정: 브레이크포인트를 넘겨 폭을 바꿔도 편집분이 유실되지 않는다', async ({ page, request, editorToken }) => {
// @scenario save_flow=edit, resize_kind=crossed_breakpoint
// @effects request_body_content_matches_editor_getdata, edit_save_persists_typed_addition, canonical_local_keeps_editor_content_after_resize, success_toast_only_when_content_actually_saved
await runEditFlow(page, request, editorToken, CROSSED_BREAKPOINT);
});
test('대조군(작성): 폭을 바꾸지 않으면 수정 전에도 정상이다', async ({ page, editorToken }) => {
// @scenario save_flow=create, resize_kind=none
// @effects save_without_resize_unaffected, create_save_returns_2xx_not_422
const marker = `NORESIZE-CREATE-${Date.now()}`;
await page.setViewportSize(SAME_BREAKPOINT.from);
await authenticatePage(page, editorToken);
await page.goto(`/admin/board/${BOARD}/create`);
const editor = page.locator('.ck-editor__editable').first();
await expect(editor).toBeVisible({ timeout: 30_000 });
await page.locator('input[name="title"]').pressSequentially(`제목 ${marker}`);
await editor.click();
await editor.pressSequentially(marker);
await waitForDebounceFlush(page, marker);
// 폭을 바꾸지 않으므로 pending 이 살아 있어야 한다 — 결함 모델의 전제
expect(
await page.evaluate(() => (window as any).__g7PendingLocalState !== null),
'폭을 바꾸지 않았으므로 pending 이 살아 있어야 한다',
).toBe(true);
const [request, response] = await Promise.all([
page.waitForRequest((r) => r.url().includes('/posts') && r.method() === 'POST'),
page.waitForResponse((r) => r.url().includes('/posts') && r.request().method() === 'POST'),
page.locator('#footer_save_button').click(),
]);
expect(String(request.postDataJSON().content ?? '')).toContain(marker);
expect(response.status()).toBeLessThan(400);
});
test('대조군(수정): 폭을 바꾸지 않으면 편집분이 그대로 저장된다', async ({ page, request, editorToken }) => {
// @scenario save_flow=edit, resize_kind=none
// @effects save_without_resize_unaffected, edit_save_persists_typed_addition
const original = `NORESIZE-ORIG-${Date.now()}`;
const added = `NORESIZE-ADD-${Date.now()}`;
const id = await createPost(request, editorToken, `대조군 ${original}`, `<p>${original}</p>`);
await page.setViewportSize(SAME_BREAKPOINT.from);
await authenticatePage(page, editorToken);
await page.goto(`/admin/board/${BOARD}/${id}/edit`);
const editor = page.locator('.ck-editor__editable').first();
await expect(editor).toContainText(original, { timeout: 30_000 });
// 제목 먼저 → 본문 나중 (순서 고정).
//
// 제목을 함께 건드리는 것은 편의가 아니라 필수다 — 본문만 고치면 저장 버튼이 계속
// disabled 로 남아 클릭이 무반응이 된다. CKEditor 의 setLocal({render:false}) 은 저장소 B
// 의 hasChanges 만 true 로 만들고 React 렌더를 일으키지 않아, 버튼의 disabled 바인딩
// (저장소 A 기준)이 재평가되지 않기 때문이다. 이 결함은 #130 수정 범위 밖의 **표시 축**
// 이며(저장소 A 를 건드리는 경로는 2026-04-22 철회 이력이 있는 영역이다), 여기서는
// 재현 조건을 성립시키기 위해 제목을 먼저 건드린다.
await page.locator('input[name="title"]').pressSequentially('!');
await editor.click();
await editor.pressSequentially(added);
await waitForDebounceFlush(page, added);
const [request2] = await Promise.all([
page.waitForRequest((r) => r.url().includes('/posts') && r.method() === 'PUT'),
page.locator('#footer_save_button').click(),
]);
const sent = String(request2.postDataJSON().content ?? '');
expect(sent).toContain(original);
expect(sent).toContain(added);
});
test('폭 변경 뒤에도 저장소 B 는 본문을 들고 있다 (setState 가 덮지 않는다)', async ({ page, editorToken }) => {
// @scenario save_flow=create, resize_kind=same_breakpoint
// @effects setstate_local_preserves_canonical_keys_when_pending_is_null, canonical_local_keeps_editor_content_after_resize
const marker = `CANONICAL-${Date.now()}`;
await page.setViewportSize(SAME_BREAKPOINT.from);
await authenticatePage(page, editorToken);
await page.goto(`/admin/board/${BOARD}/create`);
const editor = page.locator('.ck-editor__editable').first();
await expect(editor).toBeVisible({ timeout: 30_000 });
await page.locator('input[name="title"]').pressSequentially(`제목 ${marker}`);
await editor.click();
await editor.pressSequentially(marker);
await waitForDebounceFlush(page, marker);
await page.setViewportSize(SAME_BREAKPOINT.to);
await waitForPendingCleared(page);
// pending 이 null 인 상태에서 setState(local) 을 한 번 태운다 — 저장 sequence 의 첫 액션과 동형
await page.evaluate(() =>
(window as any).G7Core.dispatch({
handler: 'setState',
params: { target: 'local', isSaving: true, errors: null },
}),
);
const canonical = await page.evaluate(() => {
const c = (window as any).__templateApp?.getGlobalState?.()?._local?.form?.content;
return typeof c === 'string' ? c : JSON.stringify(c ?? '');
});
expect(canonical, 'setState 가 저장소 B 의 본문을 지우지 않아야 한다').toContain(marker);
});
});
@@ -162,4 +162,77 @@ test.describe('편집기 자산 실패 폴백', () => {
await expect(page.locator('[data-ckeditor5-fallback]')).toHaveCount(0, { timeout: 20_000 });
await expect(page.locator('#g7-asset-failure-notice')).toHaveCount(0, { timeout: 20_000 });
});
test('폭을 바꾼 뒤 저장해도 폴백 입력창의 본문이 그대로 전송된다', async ({ page, editorToken }) => {
// @scenario asset_class=vendored, outcome=failed
// @effects failed_asset_falls_back_to_plain_input
//
// 공개 #130(engine-v1.63.3) 인접 축. 평문 폴백도 본문을 `setLocal({ render:false,
// selfManaged:true })` 로 저장소 B 에만 쓰므로, 편집기 경로와 **같은 조건**이 성립한다.
// 다만 폴백은 디바운스를 쓰지 않아 입력 즉시 B 에 실린다 — 그래서 편집기 spec 의
// 결정화 4단계 중 ①(디바운스 발화 대기)이 필요 없고, ②폭 변경 → ③pending 클리어
// 확정 → ④저장만 밟는다.
//
// 판정은 화면이 아니라 **요청 body** 로 한다. 이 결함은 작성 화면에서 422 로,
// 수정 화면에서는 성공 토스트와 함께 조용한 손실로 나타나므로 화면 피드백은 근거가
// 되지 못한다.
await page.route(EDITOR_BUNDLE, (route) => route.abort());
await page.setViewportSize({ width: 1440, height: 900 });
await authenticatePage(page, editorToken);
await page.goto('/admin/board/notice/create');
await page.waitForLoadState('networkidle');
const textarea = page.locator('[data-ckeditor5-fallback]');
await expect(textarea).toBeVisible({ timeout: 20_000 });
const stamp = Date.now();
const marker = `FALLBACK-RESIZE-${stamp}`;
await page.locator('input[name="title"]').fill(`E2E 폴백 폭변경 ${stamp}`);
await textarea.fill(marker);
// 본문이 저장소 B 에 실렸는지 먼저 확정한다 (폴백은 디바운스가 없어 즉시 실린다)
await expect
.poll(
async () =>
await page.evaluate(
() => (window as any).G7Core?.state?.getLocal?.()?.form?.content ?? ''
),
{ timeout: 20_000 }
)
.toContain(marker);
// 브레이크포인트를 넘지 않는 19px 변경 — 이것만으로 pending 이 비워진다
await page.setViewportSize({ width: 1421, height: 900 });
await expect
.poll(async () => await page.evaluate(() => (window as any).__g7PendingLocalState === null), {
timeout: 20_000,
})
.toBe(true);
let postId: number | null = null;
try {
const [request, response] = await Promise.all([
page.waitForRequest((r) => r.url().includes('/posts') && r.method() === 'POST'),
page.waitForResponse((r) => r.url().includes('/posts') && r.request().method() === 'POST'),
page.locator('#footer_save_button').click(),
]);
const body = request.postDataJSON();
expect(String(body.content ?? ''), '폭 변경 뒤에도 폴백 본문이 전송돼야 한다').toContain(marker);
expect(body.content_mode, '폴백의 평문 계약은 폭 변경과 무관하게 유지돼야 한다').toBe('text');
expect(response.status(), '저장이 422 가 아니어야 한다').toBeLessThan(400);
const json = await response.json();
postId = json?.data?.id ?? null;
} finally {
if (postId !== null) {
const del = await page.request.delete(
`/api/modules/sirsoft-board/admin/board/notice/posts/${postId}`,
{ headers: { Authorization: `Bearer ${editorToken}`, Accept: 'application/json' } },
);
expect(del.ok(), `정리 삭제가 성공해야 한다 (status ${del.status()})`).toBeTruthy();
}
}
});
});
+2 -2
View File
@@ -161,8 +161,8 @@ php vendor/bin/phpunit plugins/_bundled/sirsoft-gdpr/tests --filter='<대상클
# Vitest (확장 디렉토리에서) (PowerShell)
cd plugins/_bundled/sirsoft-gdpr && powershell -Command "npm run test:run -- <대상>"
# Playwright E2E (Bash)
npx playwright test plugins/_bundled/sirsoft-gdpr/tests/Playwright/specs/<대상>.spec.ts
# Playwright E2E (확장 디렉토리에서) (Bash)
cd plugins/_bundled/sirsoft-gdpr && npm run test:e2e -- specs/<대상>.spec.ts
```
@@ -198,8 +198,8 @@ php vendor/bin/phpunit plugins/_bundled/sirsoft-message_bizppurio/tests --filter
# Vitest (확장 디렉토리에서) (PowerShell)
cd plugins/_bundled/sirsoft-message_bizppurio && powershell -Command "npm run test:run -- <대상>"
# Playwright E2E (Bash)
npx playwright test plugins/_bundled/sirsoft-message_bizppurio/tests/Playwright/specs/<대상>.spec.ts
# Playwright E2E (확장 디렉토리에서) (Bash)
cd plugins/_bundled/sirsoft-message_bizppurio && npm run test:e2e -- specs/<대상>.spec.ts
```
@@ -166,8 +166,8 @@ php vendor/bin/phpunit plugins/_bundled/sirsoft-verification_nhnkcp/tests --filt
# Vitest (확장 디렉토리에서) (PowerShell)
cd plugins/_bundled/sirsoft-verification_nhnkcp && powershell -Command "npm run test:run -- <대상>"
# Playwright E2E (Bash)
npx playwright test plugins/_bundled/sirsoft-verification_nhnkcp/tests/Playwright/specs/<대상>.spec.ts
# Playwright E2E (확장 디렉토리에서) (Bash)
cd plugins/_bundled/sirsoft-verification_nhnkcp && npm run test:e2e -- specs/<대상>.spec.ts
```