🎨 Palette: [UX improvement] BiDi 텍스트 지원을 위한 dir="auto" 추가

[seonghobae]

💡 What (무엇을)

html4tree가 생성하는 HTML 디렉토리 목록에서 텍스트를 포함하는 <h1> 및 <span> 요소에 dir="auto" 속성을 추가했습니다.

🎯 Why (왜)

아랍어나 히브리어와 같이 오른쪽에서 왼쪽(RTL)으로 읽는 문자가 디렉토리나 파일 이름에 포함되어 있을 때, 왼쪽에서 오른쪽(LTR) 레이아웃 내에서도 문자가 올바르게 렌더링되도록 양방향(BiDi) 텍스트를 적절히 지원하기 위함입니다. 이를 통해 다국어 파일 시스템 환경에서의 사용성을 개선합니다.

📸 Before/After (이전/이후)

Before:

<h1>폴더이름</h1>
...
<span aria-hidden="true">..</span>
...
<span>파일이름.txt</span>
...
<span>이 디렉토리는 비어 있습니다.</span>

After:

<h1 dir="auto">폴더이름</h1>
...
<span aria-hidden="true" dir="auto">..</span>
...
<span dir="auto">파일이름.txt</span>
...
<span dir="auto">이 디렉토리는 비어 있습니다.</span>

♿ Accessibility (접근성)

다양한 언어와 양방향 텍스트가 섞여 있는 경우에도 파일명이 브라우저에 의해 올바르게 표시되도록 보장하여, 시각적 혼란을 방지하고 정확한 텍스트 렌더링을 지원합니다.

---

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

---

Summary by CodeRabbit

• 개선 사항

  • 오른쪽에서 왼쪽으로 작성되는 문자가 포함된 디렉터리 및 파일 이름을 올바른 방향으로 표시합니다.
  • 디렉터리 제목, 상위 디렉터리 링크, 항목 이름 및 빈 디렉터리 안내에도 텍스트 방향이 자동 적용됩니다.

• 테스트

  • 다양한 디렉터리 표시 상황에서 텍스트 방향 속성이 올바르게 적용되는지 검증하도록 테스트를 업데이트했습니다.

• 문서

  • 양방향 텍스트 지원을 위한 권장 사항을 학습 자료에 추가했습니다.

[google-labs-jules]

👋 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]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: fb84858b-7baf-49dd-a13d-f96a78c23dbe

📥 Commits

Reviewing files that changed from the base of the PR and between de82f99 and cbeb605.

📒 Files selected for processing (4)

• .jules/palette.md
• src/main/kotlin/html4tree/main.kt
• src/test/kotlin/html4tree/GeneratedIndexReadabilityTest.kt
• src/test/kotlin/html4tree/MainTest.kt

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

---

📝 Walkthrough

Walkthrough

생성된 디렉토리 목록의 제목, 링크, 항목 이름, 빈 디렉토리 메시지에 dir="auto"를 추가했습니다. 관련 테스트와 BiDi 지원 안내를 업데이트했습니다.

Changes

BiDi HTML 지원

Layer / File(s)	Summary
HTML 출력 및 회귀 검증 src/main/kotlin/html4tree/main.kt, src/test/kotlin/html4tree/*Test.kt, .jules/palette.md	HTML 텍스트 요소에 dir="auto"를 추가했습니다. 생성된 마크업을 검증하는 테스트와 BiDi 지원 안내를 갱신했습니다.

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

Merge Risk: ⚪ Minimal · up to cbeb6

This change improves BiDi text rendering in generated directory listings and is merge-ready after normal checks, with no actionable merge-blocking risk remaining.

Possibly related PRs

• ContextualWisdomLab/html4tree#447: 동일한 HTML 생성 코드와 테스트에서 BiDi 텍스트용 dir="auto"를 추가합니다.

Suggested reviewers: copilot

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 4 functions across 3 files. (1 skipped: 1 …	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	PR 제목은 생성된 HTML 요소에 dir="auto"를 추가하여 BiDi 텍스트를 지원하는 주요 변경 사항을 정확하고 구체적으로 설명합니다.

Full details: Docstring Coverage

Explanation

Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 4 functions across 3 files. (1 skipped: 1 unsupported.)

• Fix all pre-merge checks with AI

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch palette-bidi-text-support-12367038015721521754

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.