[gomminjae]

Article Highlight 리팩토링 설계(docs/architecture-review.md)의 step 1·2. 모두 동작 보존.

step 1 — JS 리소스 분리

• ArticleHighlightJS의 JS 757줄 → Resources/highlight-core.js(221) + highlight-selection.js(410)
• ArticleHighlightJS는 Bundle.module 로더로 축소
• Swift 문자열 이스케이프 4중첩(/[.*+?^${}()|[\\]\\\\]/g 등) 제거 → JS 원본 그대로

step 2 — 메시지 버스 단일화

• WKWebView messageHandler 5개 → 단일 highlightEvent 봉투({type, payload})
• HighlightEvent enum으로 디코딩, rawValue→HighlightStyle 변환을 디코드 지점으로 이동
• 죽은 getSelectedText 핸들러 제거
• 콜백 3개 + selectedText 바인딩 → ViewModel handle(_:) 단일 진입점

범위 밖 (후속 PR)

• step 3 포트(HighlightRenderable/WebViewHighlightRenderer) — SwiftUI WebView 소유권 재배치라 테스트 가능 단계와 함께
• step 4 TS 승격, step 5 HighlightLocator

검증

• Detail 빌드 통과 (BUILD SUCCEEDED)
• ⚠️ 동작 변경 리팩토링이라 머지 전 수동 스모크 필요: 텍스트 선택→색칠→재진입 시 복원, 색 변경, 삭제, 스크롤-투-하이라이트

[gemini-code-assist]

Code Review

This pull request refactors the Article Highlight feature in the Detail module by extracting inline JavaScript code from ArticleHighlightJS.swift into dedicated .js resource files (highlight-core.js and highlight-selection.js). It also simplifies the communication bridge between the WKWebView and Swift by introducing a unified HighlightEvent enum and a single message handler, cleaning up view and view model bindings. Additionally, an architecture review document has been added. The review feedback suggests adding defensive checks in the JavaScript files, specifically verifying the existence of the webkit message handler to prevent runtime errors in non-iOS environments, and adding a null guard for el.parentNode when deleting highlights to avoid potential crashes.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[gemini-code-assist]

window.webkit.messageHandlers.highlightEvent가 정의되어 있지 않은 환경(예: 일반 브라우저에서 페이지를 열거나 테스트 환경 등)에서 호출될 경우 TypeError가 발생하여 JavaScript 실행이 중단될 수 있습니다.

안전한 실행을 위해 해당 객체의 존재 여부를 먼저 확인하는 방어적 코드를 추가하는 것을 권장합니다.

function postHighlightEvent(type, payload) {
    if (window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers.highlightEvent) {
        window.webkit.messageHandlers.highlightEvent.postMessage({ type: type, payload: payload });
    }
}

[gemini-code-assist]

el.parentNode가 어떤 이유로든 null인 경우(예: DOM에서 이미 분리된 요소 등), parent.insertBefore 호출 시 에러가 발생할 수 있습니다.

parent가 유효한지 확인하는 방어적 코드(Null Guard)를 추가하는 것이 안전합니다.

Suggested change

	groupElements.forEach(function(el) {
	const parent = el.parentNode;
	while (el.firstChild) {
	parent.insertBefore(el.firstChild, el);
	}
	parent.removeChild(el);
	parent.normalize();
	});
	groupElements.forEach(function(el) {
	const parent = el.parentNode;
	if (!parent) return;
	while (el.firstChild) {
	parent.insertBefore(el.firstChild, el);
	}
	parent.removeChild(el);
	parent.normalize();
	});