From 78edb7c9d2e1f371ef535c64c343e81a70e8021d Mon Sep 17 00:00:00 2001
From: seonghobae <8172694+seonghobae@users.noreply.github.com>
Date: Sat, 10 Oct 2026 21:00:08 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20=EC=A0=95=EC=A0=81=20?=
 =?UTF-8?q?=EB=B9=88=20=EC=83=81=ED=83=9C=20HTML=EC=97=90=EC=84=9C=20?=
 =?UTF-8?q?=EC=A0=91=EA=B7=BC=EC=84=B1=20=EC=95=88=ED=8B=B0=ED=8C=A8?=
 =?UTF-8?q?=ED=84=B4(role=3D"status")=20=EC=A0=9C=EA=B1=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

💡 What: `main.kt`의 빈 디렉토리 상태 렌더링에서 `role="status"` 속성을 제거하고 관련 테스트를 업데이트했습니다.
🎯 Why: 초기 페이지 로드 시 정적으로 렌더링되는 빈 디렉토리 메시지에 ARIA live region(`role="status"`)을 적용하는 것은 스크린 리더 사용자에게 혼란을 줄 수 있는 접근성 안티패턴입니다. 이는 동적 업데이트에 사용되어야 합니다.
♿ Accessibility: 정적 컨텐츠에서 부적절한 ARIA 라이브 리전을 제거하여 스크린 리더 경험을 개선했습니다.
---
 .jules/palette.md                                          | 3 +++
 src/main/kotlin/html4tree/main.kt                          | 2 +-
 src/test/kotlin/html4tree/GeneratedIndexReadabilityTest.kt | 2 +-
 src/test/kotlin/html4tree/MainTest.kt                      | 1 -
 4 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/.jules/palette.md b/.jules/palette.md
index 604d7810..4f61ad7b 100644
--- a/.jules/palette.md
+++ b/.jules/palette.md
@@ -73,3 +73,6 @@
 ## 2026-08-17 - 브라우저 번역과 화면 판독기의 호환성을 위한 텍스트 처리
 **Learning:** `aria-label` 속성으로 지정된 화면 판독기용 대체 텍스트는 Chrome Translate 등 브라우저 번역 도구에 의해 번역되지 않는 경우가 많습니다. 이로 인해 문서 언어가 변환되어도 스크린 리더에서는 원본 언어(예: 영어)로 읽혀 다국어 접근성이 저하됩니다.
 **Action:** 화면 판독기를 위한 숨겨진 설명 텍스트를 제공할 때 `aria-label` 대신 CSS `.visually-hidden` 클래스를 적용한 `<span>` 요소를 사용하여, 브라우저가 일반 텍스트로 인식하고 번역할 수 있도록 하여 다국어 접근성 호환성을 확보하십시오.
+## 2026-10-10 - 정적 빈 상태 HTML에서 ARIA 라이브 리전 역할 제거
+**Learning:** 초기 페이지 로드 시 정적으로 렌더링되는 빈 디렉토리 상태와 같은 HTML 콘텐츠에 `role="status"`와 같은 ARIA 라이브 리전을 적용하는 것은 접근성 안티패턴입니다. 이는 동적인 업데이트에 사용되어야 하며, 정적인 컨텐츠에 사용 시 스크린 리더가 이를 잘못 안내하거나 사용자에게 혼란을 줄 수 있습니다.
+**Action:** 정적으로 생성되는 콘텐츠에는 `role="status"`나 유사한 라이브 리전 역할(role)을 적용하지 않습니다.
diff --git a/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt
index 0972fa2c..7214e7f5 100644
--- a/src/main/kotlin/html4tree/main.kt
+++ b/src/main/kotlin/html4tree/main.kt
@@ -467,7 +467,7 @@ fun process_dir(curr_dir: File, excludeSet: Set<String>? = null, dirFiles: Array
         }
 
         if(l.isEmpty()){
-            l.append("""          <li><div class="empty-dir" role="status"><span class="icon" aria-hidden="true">&#128194;</span> <span>이 디렉토리는 비어 있습니다.</span></div></li>""")
+            l.append("""          <li><div class="empty-dir"><span class="icon" aria-hidden="true">&#128194;</span> <span>이 디렉토리는 비어 있습니다.</span></div></li>""")
             l.append('\n')
         }
 
diff --git a/src/test/kotlin/html4tree/GeneratedIndexReadabilityTest.kt b/src/test/kotlin/html4tree/GeneratedIndexReadabilityTest.kt
index 5897ce6d..b9bb203b 100644
--- a/src/test/kotlin/html4tree/GeneratedIndexReadabilityTest.kt
+++ b/src/test/kotlin/html4tree/GeneratedIndexReadabilityTest.kt
@@ -62,7 +62,7 @@ class GeneratedIndexReadabilityTest {
 
         val generatedHtml = generatedHtml()
         val expectedEmptyRow =
-            """<li><div class="empty-dir" role="status"><span class="icon" aria-hidden="true">&#128194;</span> <span>이 디렉토리는 비어 있습니다.</span></div></li>"""
+            """<li><div class="empty-dir"><span class="icon" aria-hidden="true">&#128194;</span> <span>이 디렉토리는 비어 있습니다.</span></div></li>"""
 
         assertTrue(generatedHtml.contains(expectedEmptyRow))
         assertTrue(generatedHtml.indexOf(expectedEmptyRow) == generatedHtml.lastIndexOf(expectedEmptyRow))
diff --git a/src/test/kotlin/html4tree/MainTest.kt b/src/test/kotlin/html4tree/MainTest.kt
index 5b76cc5d..16b465f6 100644
--- a/src/test/kotlin/html4tree/MainTest.kt
+++ b/src/test/kotlin/html4tree/MainTest.kt
@@ -115,7 +115,6 @@ class MainTest {
         assertTrue(htmlContent.contains("<html lang=\"ko\">"))
         assertRobotsDirective(htmlContent)
         assertTrue(htmlContent.contains("이 디렉토리는 비어 있습니다."))
-        assertTrue(htmlContent.contains("role=\"status\""))
         assertTrue(htmlContent.contains("role=\"list\""))
         assertTrue(htmlContent.contains("&#128194;"))
     }