@nine-lab/nine-mu 0.1.343 → 0.1.344

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nine-lab/nine-mu",
-  "version": "0.1.343",
+  "version": "0.1.344",
   "description": "AI-Driven Full-Stack Code Fabrication Engine",
   "type": "module",
   "main": "./dist/nine-mu.umd.js",

package/src/components/exception/ExceptionHook.js

@@ -37,6 +37,9 @@ export class ExceptionHook extends HTMLElement {
 			window.onerror = this.#oldOnError;
 			trace.log("🔍 [nine-exception-hook] window.onerror 복구 완료");
 		}
+
+		// 화면 리셋 시 박혀있던 바깥쪽 에러 컨테이너 제거
+		this.#removeExternalOverlay();
 	}
 
 	#setupGlobalSniffer() {
@@ -68,31 +71,16 @@ export class ExceptionHook extends HTMLElement {
 	#renderer = () => {
 		const customImport = nine.cssPath ? `@import "${nine.cssPath}/nine-mu.css";` : "";
 
-		// 🎯 [수정 1] 글로벌 로딩 오버레이를 화면 전체에서 찍어누르기 위한 호스트 및 레이어 스타일 내장
 		this.shadowRoot.innerHTML = `
 			<style>
 				@import "https://cdn.jsdelivr.net/npm/@nine-lab/nine-mu@${__APP_VERSION__}/dist/css/nine-mu.css";
 				${customImport}
-				
 				:host {
 					display: block;
 					width: 100%;
 					height: 100%;
 				}
-				/* 어떤 로딩 레이어가 돌고 있어도 뷰포트 기준 무조건 맨 앞(최상단)으로 빼버리는 절대 방어 클래스 */
-				.nine-hook-full-overlay {
-					position: fixed !important;
-					top: 0 !important;
-					left: 0 !important;
-					width: 100vw !important;
-					height: 100vh !important;
-					box-sizing: border-box !important;
-					background-color: #FFF5F5 !important;
-					z-index: 99999999 !important; 
-					overflow: auto !important;
-				}
 			</style>
-			
 			<div class="nine-hook-core" style="width: 100%; height: 100%;">
 				<slot></slot>
 			</div>
@@ -112,19 +100,13 @@ export class ExceptionHook extends HTMLElement {
 	#handleRuntimeError = (event) => {
 		trace.log("🚨 [nine-exception-hook] window.addEventListener('error') 리스너 포착!!", event);
 
-		if (this.#hasError) {
-			trace.log("⚠️ [nine-exception-hook] 이미 에러 화면이 활성화되어 있어 이벤트 리스너 패스");
-			return;
-		}
+		if (this.#hasError) return;
 
 		const errorMessage = event.error?.message || event.message || String(event);
 		const errorStack = event.error?.stack || "No stack trace available";
 
 		if (errorMessage && errorMessage !== "Script error.") {
-			trace.log("🎯 [nine-exception-hook] 정상적인 에러 메시지 확인 -> 에러 보드 출력 시도", { errorMessage });
 			this.#renderError(errorMessage, errorStack);
-		} else {
-			trace.log("⚠️ [nine-exception-hook] 'Script error.' 이거나 빈 메시지라 무시됨");
 		}
 	}
 
@@ -137,36 +119,34 @@ export class ExceptionHook extends HTMLElement {
 		const errorMessage = reason?.message || String(reason || "Unhandled Promise Rejection");
 		const errorStack = reason?.stack || "No stack trace available";
 
-		trace.log("🎯 [nine-exception-hook] Promise 거부 확인 -> 에러 보드 출력 시도");
 		this.#renderError(errorMessage, errorStack);
 	}
 
 	#handleLocationChange = () => {
 		setTimeout(() => {
-			trace.log("📍 [nine-exception-hook] 주소 이동 감지 체크", {
-				hasError: this.#hasError,
-				lastPath: this.#lastPath,
-				currentPath: window.location.pathname
-			});
-
 			if (this.#hasError && this.#lastPath !== window.location.pathname) {
-				trace.log("✨ [nine-exception-hook] Shadow DOM 내부 예외 청소 및 정상 복구");
+				trace.log("✨ [nine-exception-hook] Shadow DOM 및 글로벌 오버레이 내부 예외 청소 및 정상 복구");
 				this.#lastPath = window.location.pathname;
 				this.#hasError = false;
 
-				const exceptionBoard = this.shadowRoot.querySelector('.nine-exception-board');
-				if (exceptionBoard) exceptionBoard.innerHTML = '';
+				this.#removeExternalOverlay();
 
 				const coreContainer = this.shadowRoot.querySelector('.nine-hook-core');
 				if (coreContainer) coreContainer.style.display = '';
 			}
-		}, 50); // 라우팅 완료 대기 시간을 위해 미세 상향 (50ms)
+		}, 50);
+	}
+
+	#removeExternalOverlay() {
+		const target = document.getElementById('nine-global-exception-container');
+		if (target) target.remove();
 	}
 
 	#sendToAiAction = async (errorMessage, errorStack) => {
-		trace.log("🚀 [nine-exception-hook] AI 수정 요청 버튼 클릭됨");
-		const btn = this.shadowRoot.querySelector('.nine-ai-btn');
-		const footer = this.shadowRoot.querySelector('.nine-error-footer');
+		// 글로벌 엘리먼트 내에서 탐색하도록 변경
+		const root = document.getElementById('nine-global-exception-container') || this.shadowRoot;
+		const btn = root.querySelector('.nine-ai-btn');
+		const footer = root.querySelector('.nine-error-footer');
 		if (!btn) return;
 
 		btn.disabled = true;
@@ -175,7 +155,6 @@ export class ExceptionHook extends HTMLElement {
 
 		try {
 			if (window.triggerAutoRecovery) {
-				trace.log("📡 [nine-exception-hook] window.triggerAutoRecovery 호출 실행");
 				await window.triggerAutoRecovery({
 					message: errorMessage,
 					stack: errorStack || "No stack trace available",
@@ -200,42 +179,52 @@ export class ExceptionHook extends HTMLElement {
 		this.#hasError = true;
 
 		setTimeout(() => {
-			trace.log("🎨 [nine-exception-hook] 리액트 사이클 종료 후 에러 UI 최종 렌더링");
+			trace.log("🎨 [nine-exception-hook] 리액트 사이클 종료 후 최상단 글로벌 에러 레이어 생성");
 
 			const coreContainer = this.shadowRoot.querySelector('.nine-hook-core');
-			if (coreContainer) {
-				coreContainer.style.display = 'none';
-				trace.log("🎨 [nine-exception-hook] <slot> 본문 영역 컨테이너 숨김");
-			}
-
-			const exceptionBoard = this.shadowRoot.querySelector('.nine-exception-board');
-			if (!exceptionBoard) {
-				trace.error("❌ [nine-exception-hook] .nine-exception-board 엘리먼트를 찾을 수 없습니다.");
-				return;
-			}
+			if (coreContainer) coreContainer.style.display = 'none';
+
+			// 🎯 [핵심 변경] Shadow DOM 내부가 아니라 document.body에 직접 fixed 컨테이너를 꽂아버려
+			// global-loading-overlay를 완벽히 덮어버립니다.
+			this.#removeExternalOverlay();
+
+			const externalContainer = document.createElement('div');
+			externalContainer.id = 'nine-global-exception-container';
+
+			// 인라인 스타일로 외부 요소를 완전히 차단하고 맨 앞으로 배치
+			Object.assign(externalContainer.style, {
+				position: 'fixed',
+				top: '0',
+				left: '0',
+				width: '100vw',
+				height: '100vh',
+				backgroundColor: '#FFF5F5',
+				zIndex: '2147483647', // 브라우저 표현 최대 z-index 값 부여
+				overflow: 'auto',
+				boxSizing: 'border-box',
+				display: 'block'
+			});
 
-			// 🎯 [수정 2] 에러 HTML 컨테이너 구조를 화면 전체 뷰포트를 장악하는 고정 레이아웃 구조로 랩핑
 			const errorHTML = `
-				<div class="nine-hook-full-overlay">
-					<div class="nine-error-container" style="padding: 40px; max-width: 1200px; margin: 40px auto; font-family: sans-serif; background: white; border-radius: 8px; box-shadow: 0 10px 25px rgba(0,0,0,0.08); text-align: left;">
-						<h3 class="nine-error-title" style="color: #C53030; margin-top: 0; font-size: 22px; font-weight: 700; border-bottom: 2px solid #FED2D2; padding-bottom: 12px;">⚠️ 시스템 예외 감지 (${this.tagName.toLowerCase()})</h3>
-						<p class="nine-error-label" style="font-weight: bold; margin: 20px 0 8px 0; color: #4A5568; font-size: 15px;">[에러 원인 로그]:</p>
-						<pre class="nine-error-log" style="background: #1A202C; color: #EDF2F7; padding: 20px; border-radius: 6px; overflow-x: auto; white-space: pre-wrap; font-family: monospace; font-size: 14px; line-height: 1.6; margin-bottom: 25px;">${errorMessage}\n\n[Stack Trace]\n${errorStack}</pre>
-						
-						<div class="nine-action-area" style="display: flex; align-items: center; gap: 20px; border-top: 1px solid #E2E8F0; padding-top: 20px;">
-							<button class="nine-ai-btn" style="background: #3182CE; color: white; border: none; padding: 14px 28px; border-radius: 6px; font-weight: bold; cursor: pointer; font-size: 16px; transition: background 0.2s;">🤖 AI에게 소스코드 수정 요청</button>
-							<div class="nine-error-footer" style="font-size: 14px; color: #718096; line-height: 1.4;">
-								버튼을 누르면 AI가 로그 및 컴포넌트 맵을 역추적하여 수정을 시작합니다.
-							</div>
+				<div class="nine-error-container" style="padding: 40px; max-width: 1200px; margin: 40px auto; font-family: sans-serif; background: white; border-radius: 8px; box-shadow: 0 10px 25px rgba(0,0,0,0.08); text-align: left;">
+					<h3 class="nine-error-title" style="color: #C53030; margin-top: 0; font-size: 22px; font-weight: 700; border-bottom: 2px solid #FED2D2; padding-bottom: 12px; font-family: sans-serif;">⚠️ 시스템 예외 감지 (nine-exception-hook)</h3>
+					<p class="nine-error-label" style="font-weight: bold; margin: 20px 0 8px 0; color: #4A5568; font-size: 15px; font-family: sans-serif;">[에러 원인 로그]:</p>
+					<pre class="nine-error-log" style="background: #1A202C; color: #EDF2F7; padding: 20px; border-radius: 6px; overflow-x: auto; white-space: pre-wrap; font-family: monospace; font-size: 14px; line-height: 1.6; margin-bottom: 25px;">${errorMessage}\n\n[Stack Trace]\n${errorStack}</pre>
+					
+					<div class="nine-action-area" style="display: flex; align-items: center; gap: 20px; border-top: 1px solid #E2E8F0; padding-top: 20px;">
+						<button class="nine-ai-btn" style="background: #3182CE; color: white; border: none; padding: 14px 28px; border-radius: 6px; font-weight: bold; cursor: pointer; font-size: 16px;">🤖 AI에게 소스코드 수정 요청</button>
+						<div class="nine-error-footer" style="font-size: 14px; color: #718096; line-height: 1.4; font-family: sans-serif;">
+							버튼을 누르면 AI가 로그 및 컴포넌트 맵을 역추적하여 수정을 시작합니다.
 						</div>
 					</div>
 				</div>
 			`;
 
-			exceptionBoard.innerHTML = errorHTML;
-			trace.log("🎨 [nine-exception-hook] Shadow DOM에 에러 UI 최종 삽입 성공");
+			externalContainer.innerHTML = errorHTML;
+			document.body.appendChild(externalContainer);
+			trace.log("🎨 [nine-exception-hook] 브라우저 Body 최상단 레이어 배정 성공");
 
-			const aiBtn = this.shadowRoot.querySelector('.nine-ai-btn');
+			const aiBtn = externalContainer.querySelector('.nine-ai-btn');
 			if (aiBtn) {
 				aiBtn.addEventListener('click', () => this.#sendToAiAction(errorMessage, errorStack));
 				trace.log("🎨 [nine-exception-hook] AI 요청 버튼 이벤트 리스너 최종 바인딩 성공");