From 4089a281a0d0b93f68ec2cf51fa58b19df75c0a2 Mon Sep 17 00:00:00 2001
From: seonghobae <8172694+seonghobae@users.noreply.github.com>
Date: Fri, 3 Jul 2026 20:39:58 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20=EC=83=9D=EC=84=B1?=
 =?UTF-8?q?=EB=90=9C=20HTML=20=EB=A7=81=ED=81=AC=EC=97=90=20CSS=20?=
 =?UTF-8?q?=ED=8A=B8=EB=9E=9C=EC=A7=80=EC=85=98=20=EB=B0=8F=20=EC=A0=91?=
 =?UTF-8?q?=EA=B7=BC=EC=84=B1=20=EB=AF=B8=EB=94=94=EC=96=B4=20=EC=BF=BC?=
 =?UTF-8?q?=EB=A6=AC=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* `src/main/kotlin/html4tree/main.kt`에 호버 및 포커스 시 부드러운 전환을 위해 `a` 태그에 CSS 트랜지션 추가
* 접근성을 위해 `@media (prefers-reduced-motion: reduce)` 구문을 추가하여 트랜지션을 비활성화
* `src/test/kotlin/html4tree/MainTest.kt`에 관련 단위 테스트 추가
* `.jules/palette.md`에 관련된 UX 학습 기록 추가
---
 .jules/palette.md                     | 4 ++++
 src/main/kotlin/html4tree/main.kt     | 6 ++++++
 src/test/kotlin/html4tree/MainTest.kt | 2 ++
 3 files changed, 12 insertions(+)

diff --git a/.jules/palette.md b/.jules/palette.md
index b8df5bd..95b6333 100644
--- a/.jules/palette.md
+++ b/.jules/palette.md
@@ -13,3 +13,7 @@
 ## 2024-06-25 - Directory Listing Navigation Landmark
 **Learning:** Generated directory listings act as navigation regions, and screen readers benefit when the listing is announced separately from the page's main content.
 **Action:** Wrap generated directory listing `<ul>` elements in `<nav aria-label="Directory listing">` while keeping the surrounding semantic `<main>` structure.
+
+## 2024-07-03 - Smooth Micro-Interactions in Generated HTML
+**Learning:** Adding CSS transitions to interactive elements (like anchor tags) in raw generated HTML enhances the perceived quality and smoothness of the interface. However, using `transition: all` is inefficient, and not accommodating users who prefer reduced motion is an accessibility violation.
+**Action:** When adding transitions, specify the exact properties (e.g., `background-color`, `outline-color`) and always include a `@media (prefers-reduced-motion: reduce)` block to disable transitions (`transition: none`) for users who have requested it at the OS level.
diff --git a/src/main/kotlin/html4tree/main.kt b/src/main/kotlin/html4tree/main.kt
index 2e2809f..c70438c 100644
--- a/src/main/kotlin/html4tree/main.kt
+++ b/src/main/kotlin/html4tree/main.kt
@@ -143,6 +143,7 @@ fun process_dir(curr_dir: File){
                 text-decoration: none;
                 color: #0366d6;
                 border-radius: 4px;
+                transition: background-color 0.2s ease, outline-color 0.2s ease;
               }
               a:hover, a:focus-visible {
                 background-color: #f6f8fa;
@@ -150,6 +151,11 @@ fun process_dir(curr_dir: File){
                 outline: 2px solid #0366d6;
                 outline-offset: -2px;
               }
+              @media (prefers-reduced-motion: reduce) {
+                a {
+                  transition: none;
+                }
+              }
               </style>
               """
 
diff --git a/src/test/kotlin/html4tree/MainTest.kt b/src/test/kotlin/html4tree/MainTest.kt
index e8a3082..cc6a934 100644
--- a/src/test/kotlin/html4tree/MainTest.kt
+++ b/src/test/kotlin/html4tree/MainTest.kt
@@ -160,6 +160,8 @@ class MainTest {
         assertFalse(htmlContent.contains("test.ignore"))
         assertTrue(htmlContent.contains("Content-Security-Policy"))
         assertTrue(htmlContent.contains("default-src 'none'; style-src 'unsafe-inline';"))
+        assertTrue(htmlContent.contains("transition: background-color 0.2s ease, outline-color 0.2s ease;"))
+        assertTrue(htmlContent.contains("@media (prefers-reduced-motion: reduce)"))
     }
 
     @Test