Skip to content

🎨 Palette: 빈 디렉토리 상태의 시각적 일관성 향상 - #337

Closed
seonghobae wants to merge 1 commit into
masterfrom
palette/empty-dir-ux-8761641516323948553
Closed

🎨 Palette: 빈 디렉토리 상태의 시각적 일관성 향상#337
seonghobae wants to merge 1 commit into
masterfrom
palette/empty-dir-ux-8761641516323948553

Conversation

@seonghobae

@seonghobaeseonghobae commented Aug 1, 2026

Copy link
Copy Markdown
Collaborator

💡 What: 생성된 HTML 파일 트리에서 디렉토리가 비어 있을 때 나타나는 빈 상태 메시지의 시각적 레이아웃과 일관성을 개선했습니다. 빈 상태에도 열린 폴더 아이콘(📂)을 제공하고, CSS display: flex; gap: 0.5rem;을 추가하여 일반 디렉토리/파일 링크 항목과 정렬(Alignment)을 일치시켰습니다.
🎯 Why: 기존의 빈 상태는 일반 항목들과 텍스트 정렬이 다르고 아이콘이 생략되어 있어 시각적으로 어색하며, 디렉토리 구조로서의 연속성이 떨어져 보였습니다. 빈 상태에도 적절한 아이콘과 여백을 제공하여 일관된 사용자 경험(UX)을 제공합니다.
📸 Before/After: 빈 텍스트 줄로만 보였던 화면이, 아이콘이 포함된 깔끔한 상태 메시지로 변경되었습니다.
Accessibility: 장식용 아이콘에 <span aria-hidden="true">를 적용하여 화면 판독기(스크린 리더) 사용자에게 불필요한 이모지 문자(열린 폴더)가 소리내어 읽히지 않도록 하여 접근성을 유지했습니다.


PR created automatically by Jules for task 8761641516323948553 started by @seonghobae

Summary by CodeRabbit

  • 새로운 기능

    • 빈 디렉터리 안내 화면에 폴더 아이콘과 명확한 메시지를 추가했습니다.
    • 디렉터리 목록과 상위 경로 이동을 제공하는 정적 페이지를 추가했습니다.
    • 라이트·다크 테마, 반응형 레이아웃, 접근성 및 보안 설정을 지원합니다.
  • 개선 사항

    • 빈 디렉터리 안내 영역의 정렬과 간격을 개선해 가독성을 높였습니다.
    • 모션 감소 설정과 링크 상태 스타일을 반영했습니다.

- 빈 디렉토리 메시지에 열린 폴더 아이콘(`&#128194;`) 추가
- `.empty-dir` 클래스에 flexbox 스타일을 적용하여 일반 목록 항목(`.dir-link`)과 시각적 레이아웃(정렬 및 간격)을 일치시킴
- MainTest.kt의 `testGoEmptyDir`에 해당 아이콘이 렌더링되는지 확인하는 어서션 추가
- `.jules/palette.md`에 관련된 UX 학습 기록(한국어) 추가
@google-labs-jules

Copy link
Copy Markdown

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

@coderabbitai

coderabbitaiBot commented Aug 1, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

빈 디렉토리 표시가 폴더 아이콘과 텍스트 구조로 변경되었습니다. Flexbox 정렬 스타일과 아이콘 검증 테스트를 추가했습니다. 디렉터리 목록 및 빈 디렉토리용 정적 HTML 페이지도 추가했습니다.

Changes

빈 디렉토리 UI

Layer / File(s)Summary
빈 디렉토리 렌더링과 검증
src/main/kotlin/html4tree/main.kt, .jules/palette.md, src/test/kotlin/html4tree/MainTest.kt
빈 디렉토리 메시지에 열린 폴더 아이콘과 텍스트 요소를 추가했습니다. .empty-dir에 Flexbox 정렬과 간격을 적용했습니다. 테스트는 &#128194; 엔티티를 확인합니다.
디렉터리 목록 HTML 페이지
empty_dir_test/index.html, empty_dir_test/empty_dir/index.html
디렉터리 링크와 빈 상태 안내를 포함한 정적 HTML 페이지를 추가했습니다. CSP, referrer 정책, 접근성 속성, 키보드 포커스, 라이트·다크 테마 및 reduced-motion 스타일을 포함합니다.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ Passed제목은 빈 디렉토리 상태의 시각적 일관성 개선이라는 주요 변경 사항을 정확하고 간결하게 설명합니다.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch palette/empty-dir-ux-8761641516323948553

Comment @coderabbitai help to get the list of available commands.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
src/test/kotlin/html4tree/MainTest.kt (1)

97-97: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

빈 상태 아이콘의 접근성 마크업도 검증하십시오.

현재 어서션은 &#128194;만 확인합니다. aria-hidden="true" 또는 .empty-dir 구조가 제거되어도 테스트가 통과할 수 있습니다. 빈 상태의 아이콘 마크업을 함께 확인하십시오.

수정 예시
- assertTrue(htmlContent.contains("&`#128194`;"))+ assertTrue(+ htmlContent.contains(+ """<div class="empty-dir"><span class="icon" aria-hidden="true">&`#128194`;</span>"""+ )+ )
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@src/test/kotlin/html4tree/MainTest.kt` at line 97, Update the empty-state
assertion in MainTest to validate the icon’s accessibility markup in addition to
the &`#128194`; entity, checking for aria-hidden="true" and/or the expected
.empty-dir structure so the test fails if that markup is removed.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@src/test/kotlin/html4tree/MainTest.kt`:
- Line 97: Update the empty-state assertion in MainTest to validate the icon’s
accessibility markup in addition to the &`#128194`; entity, checking for
aria-hidden="true" and/or the expected .empty-dir structure so the test fails if
that markup is removed.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 2f059a97-5738-4e9b-ba5a-c17c2146d672

📥 Commits

Reviewing files that changed from the base of the PR and between a859a11 and 01b47ab.

📒 Files selected for processing (5)
  • .jules/palette.md
  • empty_dir_test/empty_dir/index.html
  • empty_dir_test/index.html
  • src/main/kotlin/html4tree/main.kt
  • src/test/kotlin/html4tree/MainTest.kt

@seonghobaeChatGPT Codex Connector

Copy link
Copy Markdown
CollaboratorAuthor

Closing as superseded by the protected base and draft canonical #360. The semantic role="status", decorative icon treatment, and flex alignment are already present. #360 owns the remaining tested visual readability and interaction work after #363, including explicit contrast, separators, focus/hover states, reduced motion, dark-mode cascade, WCAG 2.2 doctoring, changelog, and fresh exact-head gates. No evidence from this duplicate head is reused.

@google-labs-jules

Copy link
Copy Markdown

Closing as superseded by the protected base and draft canonical #360. The semantic role="status", decorative icon treatment, and flex alignment are already present. #360 owns the remaining tested visual readability and interaction work after #363, including explicit contrast, separators, focus/hover states, reduced motion, dark-mode cascade, WCAG 2.2 doctoring, changelog, and fresh exact-head gates. No evidence from this duplicate head is reused.

Understood. Acknowledging that this work is now obsolete and stopping work on this task.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@seonghobae