feat(core,extensions): 구동 에셋 자체 제공 · 자산 실패 폴백 · 운영자 추가 에셋(custom/)

공개 저장소 이슈 gnuboard/g7 (@bigmsg) 제보에서 출발한 작업이다.

브라우저가 화면을 그리려고 제3자 CDN 에 도달해야 하면, 그 도달 실패는 예외도 로그도
남기지 않고 화면 기능만 조용히 사라진다. 폐쇄망·방화벽·광고차단기에서 재현되는데
자체 서버 로그에는 흔적이 없어 운영자가 원인을 특정할 수 없다. 제보된 것은 편집기
하나였지만 같은 구조가 아이콘·글꼴·코드편집기·압축 라이브러리·설치 마법사·개발
대시보드에 똑같이 있었으므로, 번들 확장과 템플릿 전체를 자체 제공으로 옮겼다.
런타임에 외부로 나가는 것은 주소 검색 서비스 하나만 남았다.

자체 제공만으로는 부족하다 — 자기 서버에서 받는 파일도 실패할 수 있고, 종전에는 그
실패가 무음이었다. CSS 경로에 재시도 계층을 세우고(스크립트 경로와 동형), 서버가 HTML
에 직접 심는 externals 까지 실패를 붙잡아 안내 배너와 [다시 시도]로 표면화했다.
편집기·코드편집기는 확보 실패 시 평문 입력으로 내려앉되 저장 계약을 유지한다.

두 번째 축은 운영자가 CSS 를 덧붙일 자리가 없던 문제다(sir.kr 문의). 확장 디렉토리의
custom/ 을 운영자 소유로 정해, 확장 교체가 그 디렉토리만은 보존하게 했다. 출처에
의존하지 않는 서술자로 해석하므로 나중에 다른 출처가 붙어도 소비자는 바뀌지 않는다.
확장 자산과 같은 메커니즘으로 정적 게시되어 CSS 내부 상대 url 도 해석되고, 파일을
고치면 그 변경을 감지해 재게시까지 예약된다.

FTP 접근이 없는 운영자에게는 그 자리도 없는 것과 같으므로 레이아웃 편집기에서 직접
넣고 고칠 수 있게 했다. 모듈·플러그인·템플릿이 한 엔드포인트를 공유한다 — 타입별로
나누면 같은 검증이 세 벌로 갈리고 그중 약한 하나가 우회로가 된다. 여기서 올린
스크립트는 그 레이아웃 한 장이 아니라 사이트 전 화면에서 실행되므로 레이아웃 편집과
분리된 전용 권한으로 연다. 운영자 CSS 가 화면을 조작 불능으로 만들면 그것을 고칠
화면에도 같은 CSS 가 실려 스스로 갇히므로, 서버가 목록을 비우는 탈출구(?custom=off)를
함께 뒀다.

동봉 자산은 재생성 경로에 버전 대조 가드를 붙였다. 선언과 다른 버전을 버전 디렉토리에
써 넣는 조용한 거짓말은 배포된 뒤에는 드러나지 않는다.
This commit is contained in:
HeuJung committed 2026-08-27 16:47:14 +09:00
1 parent 72f2e94c1a
commit 3945b6f1b3
1042 files changed
+107435 -947

No files matched your search

@@ -43,6 +43,12 @@ vi.mock('@monaco-editor/react', () => ({
</div>
);
},
// CodeEditor 가 동봉 Monaco 를 가리키도록 loader 를 쓴다(#123 Phase 4).
// 이 스텁이 없으면 렌더 시점에 loader 가 undefined 라 컴포넌트가 통째로 실패한다.
loader: {
init: () => Promise.resolve({}),
config: vi.fn(),
},
}));
/**
@@ -40,6 +40,12 @@ vi.mock('@monaco-editor/react', () => ({
</div>
);
},
// CodeEditor 가 동봉 Monaco 를 가리키도록 loader 를 쓴다(#123 Phase 4).
// 이 스텁이 없으면 렌더 시점에 loader 가 undefined 라 컴포넌트가 통째로 실패한다.
loader: {
init: () => Promise.resolve({}),
config: vi.fn(),
},
}));
const FIXTURES_DIR = join(__dirname, '__fixtures__');
@@ -1,6 +1,43 @@
import React, { useEffect, useRef } from 'react';
import Editor, { Monaco } from '@monaco-editor/react';
import * as monaco from 'monaco-editor';
import React, { useEffect, useRef, useState } from 'react';
import Editor, { Monaco, loader } from '@monaco-editor/react';
import type * as monaco from 'monaco-editor';
/** 동봉한 Monaco 버전 (`dist/vendor/monaco-editor/{VERSION}/`) */
const MONACO_VERSION = '0.54.0';
/** 이 템플릿 식별자 */
const TEMPLATE_ID = 'sirsoft-admin_basic';
/** 자산 실패 안내 식별자 */
const FAILURE_ID = 'monaco-editor';
/**
* Monaco 로더가 동봉본을 바라보도록 1회 설정합니다.
*
* `@monaco-editor/react` 는 기본적으로 Monaco 를 외부 CDN 에서 받는다. 그러면 폐쇄망에서
* 레이아웃 코드 편집 화면이 통째로 뜨지 않으므로, 템플릿이 함께 담은 사본을 가리키게 한다.
*
* AMD 로더는 `paths.vs` 뒤에 파일 경로를 이어 붙이므로 **디렉토리 접두**가 필요하다 —
* 그래서 `G7Core.asset.templateDir` 을 쓴다(정적 게시본 우선).
*
* @returns bool 설정에 성공했으면 true
*/
function configureMonacoLoader(): boolean {
const asset = (window as any)?.G7Core?.asset;
if (typeof asset?.templateDir !== 'function') {
return false;
}
loader.config({
paths: { vs: asset.templateDir(TEMPLATE_ID, `vendor/monaco-editor/${MONACO_VERSION}/vs`) },
});
return true;
}
/** 로더 설정은 앱 수명 동안 1회만 유효하다 (초기화 후 변경 불가) */
let loaderConfigured = false;
export interface CodeEditorProps {
value: string;
@@ -20,12 +57,18 @@ export const CodeEditor: React.FC<CodeEditorProps> = ({
theme = 'vs-dark',
}) => {
const editorRef = useRef<monaco.editor.IStandaloneCodeEditor | null>(null);
const [failed, setFailed] = useState(false);
if (!loaderConfigured) {
loaderConfigured = configureMonacoLoader();
}
const handleEditorDidMount = (
editor: monaco.editor.IStandaloneCodeEditor,
monacoInstance: Monaco
) => {
editorRef.current = editor;
(window as any)?.G7Core?.assets?.clearFailure?.(FAILURE_ID);
// JSON 스키마 검증 설정
if (language === 'json') {
@@ -48,6 +91,23 @@ export const CodeEditor: React.FC<CodeEditorProps> = ({
});
};
/**
* Monaco 확보 실패를 폴백으로 받습니다.
*
* 편집기가 없다고 화면을 비워 두면 레이아웃을 고칠 방법이 사라진다. 저장 계약
* (값·onChange)이 같은 textarea 로 대체하고, 사용자에게 사실을 알린다.
*/
const handleLoadFailure = () => {
setFailed(true);
(window as any)?.G7Core?.assets?.notifyFailure?.({
id: FAILURE_ID,
label: '코드 편집기',
retry: () => {
setFailed(false);
},
});
};
const handleChange = (value: string | undefined) => {
if (onChange && value !== undefined) {
// 엔진의 isCustomComponentEvent 경로로 처리되도록 { target: { value } } 패턴 사용
@@ -61,6 +121,62 @@ export const CodeEditor: React.FC<CodeEditorProps> = ({
}
}, [readOnly]);
// Monaco 확보 여부를 직접 확인한다. `<Editor>` 는 로드 실패를 알려주지 않고
// 로딩 표시에서 멈추므로, 그대로 두면 "영영 불러오는 중" 화면이 남는다.
useEffect(() => {
if (failed) {
return;
}
let cancelled = false;
const init = loader.init();
init.catch(() => {
if (!cancelled) {
handleLoadFailure();
}
});
return () => {
cancelled = true;
};
}, [failed]);
if (failed) {
return (
<div className="border border-gray-300 dark:border-gray-700 rounded-lg overflow-hidden">
<textarea
data-testid="code-editor-fallback"
className="w-full block p-3 font-mono text-sm bg-gray-100 text-gray-900 dark:bg-gray-900 dark:text-gray-100 outline-none resize-y"
style={{ height: height === '100%' ? '480px' : height }}
value={value}
readOnly={readOnly}
spellCheck={false}
wrap="off"
onChange={(event) => handleChange(event.target.value)}
onKeyDown={(event) => {
// 탭 들여쓰기 유지 — 코드 편집에서 탭이 포커스를 옮기면 쓸 수 없다
if (event.key !== 'Tab') {
return;
}
event.preventDefault();
const target = event.currentTarget;
const { selectionStart, selectionEnd } = target;
const next = `${value.slice(0, selectionStart)} ${value.slice(selectionEnd)}`;
handleChange(next);
requestAnimationFrame(() => {
target.selectionStart = target.selectionEnd = selectionStart + 2;
});
}}
/>
</div>
);
}
return (
<div className="border border-gray-300 dark:border-gray-700 rounded-lg overflow-hidden">
<Editor
@@ -70,6 +186,12 @@ export const CodeEditor: React.FC<CodeEditorProps> = ({
theme={theme}
onChange={handleChange}
onMount={handleEditorDidMount}
loading={<div className="p-4 text-sm text-gray-500 dark:text-gray-400">편집기를 불러오는 중...</div>}
beforeMount={() => {
if (!loaderConfigured) {
loaderConfigured = configureMonacoLoader();
}
}}
options={{
readOnly,
minimap: { enabled: false },
@@ -24,6 +24,35 @@ import type { Attachment, PendingFile, FileUploaderProps, ApiEndpoints } from '.
import { formatFileSize, extractErrorMessage, t } from './utils';
import { isCrossOriginAssetUrl } from '../assetOrigin';
/** 동봉한 browser-image-compression 버전 */
const IMAGE_COMPRESSION_VERSION = '2.0.2';
/**
* 웹 워커가 불러올 압축 라이브러리 URL 을 돌려줍니다.
*
* `useWebWorker: true` 일 때 라이브러리는 워커 안에서 자기 사본을 다시 받는데, 기본값이
* 외부 CDN 이다. 그 요청이 실패하면 라이브러리가 메인 스레드로 폴백하므로 기능이 깨지지는
* 않지만, 폐쇄망에서 매 업로드마다 외부로 나가는 요청이 남는다. 템플릿이 함께 담은
* 사본을 가리켜 그 왕복을 없앤다.
*
* URL 을 만들 수 없으면(구 코어) `undefined` 를 돌려주어 종전 동작을 유지한다.
*
* @returns 압축 라이브러리 URL 또는 undefined
*/
function resolveCompressionLibUrl(): string | undefined {
const asset = (window as any)?.G7Core?.asset;
if (typeof asset?.template !== 'function') {
return undefined;
}
return asset.template(
'sirsoft-admin_basic',
`vendor/browser-image-compression/${IMAGE_COMPRESSION_VERSION}/browser-image-compression.js`
);
}
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const G7Core = (window as any).G7Core;
@@ -192,6 +221,7 @@ export function useFileUploader(options: UseFileUploaderOptions): UseFileUploade
maxSizeMB: compressionOptions?.maxSizeMB ?? 1,
maxWidthOrHeight: compressionOptions?.maxWidthOrHeight ?? 1920,
useWebWorker: true,
libURL: resolveCompressionLibUrl(),
};
return await imageCompression(file, compressionOpts);
},
@@ -39,6 +39,12 @@ vi.mock('@monaco-editor/react', () => ({
</div>
);
},
// CodeEditor 가 동봉 Monaco 를 가리키도록 loader 를 쓴다(#123 Phase 4).
// 이 스텁이 없으면 렌더 시점에 loader 가 undefined 라 컴포넌트가 통째로 실패한다.
loader: {
init: () => Promise.resolve({}),
config: vi.fn(),
},
}));
describe('CodeEditor', () => {