🎨 Palette: [UX improvement] 다국어 파일명 및 양방향(BiDi) 텍스트 지원을 위한 렌더링 개선 by seonghobae · Pull Request #507 · ContextualWisdomLab/html4tree

seonghobae · 2026-08-21T21:13:06Z

💡 What: 생성된 HTML에서 디렉토리 이름(<h1>)과 파일 이름(<span>)을 렌더링하는 태그에 dir="auto" 속성을 추가하여 다국어 양방향(BiDi) 텍스트 지원을 구현했습니다.
🎯 Why: 아랍어(Arabic)나 히브리어(Hebrew)와 같이 Right-to-Left (RTL)로 작성되는 언어가 기본 Left-to-Right (LTR) 환경에서 렌더링될 때, 텍스트 방향이 올바르게 표시되지 않아 글자가 깨지거나 가독성이 현저히 저하되는 문제가 발생하기 때문입니다.
📸 Before/After: RTL 언어로 된 파일명들이 LTR 방향에서 표시될 때 레이아웃이 어색하게 깨지던 문제가 해결되어 원어민에게 더 자연스럽고 읽기 쉬운 레이아웃으로 변경되었습니다.
♿ Accessibility: dir="auto"를 사용하여 브라우저가 콘텐츠 자체를 기반으로 방향을 추론하게 만들었으므로 화면 판독기나 기타 보조 기술이 RTL 언어를 더 정확하게 처리할 수 있도록 돕습니다. 테스트 코드(MainTest.kt) 업데이트 및 .jules/palette.md에 이와 관련된 UX 규칙을 새로 기록했습니다.

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

Summary by CodeRabbit

새로운 기능
- 생성되는 디렉터리 목록 페이지가 이름의 언어를 자동으로 감지해 왼쪽에서 오른쪽 또는 오른쪽에서 왼쪽으로 올바르게 표시합니다.
테스트
- 디렉터리 제목과 파일 이름에 텍스트 방향 자동 감지가 적용되는지 검증을 추가했습니다.
문서
- 텍스트 방향 자동 감지 기능에 대한 변경 사항을 기록했습니다.

google-labs-jules · 2026-08-21T21:13:08Z

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

devin-ai-integration

Note

This report is out of date. Scroll down for Devin Review's latest report on this PR.

✅ Devin Review: No Issues Found

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

coderabbitai · 2026-08-21T21:14:48Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: f5e4363a-505d-48b1-a456-3caa300d2a31

📥 Commits

Reviewing files that changed from the base of the PR and between 89d143f and ebd251d.

📒 Files selected for processing (1)

src/test/kotlin/html4tree/BidiDirectionTest.kt

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

📝 Walkthrough

Walkthrough

process_dir가 생성하는 디렉토리 제목과 파일명 요소에 dir="auto"를 추가했습니다. 관련 테스트와 변경 기록도 갱신했습니다.

Changes

HTML 텍스트 방향 자동 감지

Layer / File(s)	Summary
HTML 렌더링 및 검증 `src/main/kotlin/html4tree/main.kt`, `src/test/kotlin/html4tree/MainTest.kt`, `src/test/kotlin/html4tree/BidiDirectionTest.kt`, `.jules/palette.md`	디렉토리 제목과 파일명에 `dir="auto"`를 추가했습니다. 테스트는 제목과 파일명 마크업을 검증합니다. 변경 기록에 해당 내용을 추가했습니다.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Merge Risk: ⚪ Minimal · up to ebd25

This localized change adds automatic text-direction handling for generated directory and file labels and includes regression coverage. No actionable merge-blocking risk remains after normal checks and review.

Possibly related PRs

ContextualWisdomLab/html4tree#300: process_dir의 생성 <h1> 요소와 관련 테스트를 수정한 변경입니다.
ContextualWisdomLab/html4tree#447: process_dir와 관련 테스트에 dir="auto"를 추가한 변경입니다.
ContextualWisdomLab/html4tree#496: 디렉토리 제목과 파일명 요소의 dir="auto"를 검증한 변경입니다.

🚥 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 3 functions across 3 files.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	제목은 다국어 파일명과 양방향 텍스트 렌더링 개선을 명확히 설명하며, 변경 내용의 주요 목적과 일치합니다.
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.

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-6806216931577145038

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

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

devin-ai-integration

Devin Review found 1 new potential issue.

devin-ai-integration · 2026-08-31T11:27:02Z

                  val typeLabel = if (isLinkedDirectory) { "디렉토리" } else { "파일" }
                  val icon = if (isLinkedDirectory) { "&#128193;" } else { "&#128196;" }
-                  l.append("""          <li><a class="dir-link" href="${encodedHref}" title="${ariaLabel}"><span class="icon" aria-hidden="true">${icon}</span> <span>${fileName.escapeHtml()}</span> <span class="visually-hidden">${typeLabel}</span></a></li>""")
+                  l.append("""          <li><a class="dir-link" href="${encodedHref}" title="${ariaLabel}"><span class="icon" aria-hidden="true">${icon}</span> <span dir="auto">${fileName.escapeHtml()}</span> <span class="visually-hidden">${typeLabel}</span></a></li>""")


🔍 Filename direction lacks regression coverage

The final test suite checks dir="auto" on headings only. A later filename-template regression can pass without detecting broken BiDi rendering.

Was this helpful? React with 👍 or 👎 to provide feedback.

feat(ui): add bidi text support using dir="auto"

2cdf489

devin-ai-integration Bot reviewed Aug 21, 2026

View reviewed changes

feat(ui): add bidi text support using dir="auto"

89d143f

This comment was marked as resolved.

Sign in to view

opencode-agent Bot added priority: medium Normal-priority or P2 work status: needs-review Open pull request requiring current-head review or checks type: feature New or expanded product capability labels Aug 22, 2026

seonghobae and others added 2 commits August 31, 2026 20:03

test(ui): cover bidi filename direction

ebd251d

feat(ui): add bidi text support using dir="auto"

ef867b2

devin-ai-integration Bot reviewed Aug 31, 2026

View reviewed changes

seonghobae added 6 commits August 31, 2026 11:55

feat(ui): add bidi text support using dir="auto"

13b0113

feat(ui): add bidi text support using dir="auto"

4dba6b8

feat(ui): add bidi text support using dir="auto"

574b126

feat(ui): add bidi text support using dir="auto"

759eb03

feat(ui): add bidi text support using dir="auto"

1b93de0

feat(ui): add bidi text support using dir="auto"

b179fe4

Navigation Menu

Uh oh!

🎨 Palette: [UX improvement] 다국어 파일명 및 양방향(BiDi) 텍스트 지원을 위한 렌더링 개선 - #507

🎨 Palette: [UX improvement] 다국어 파일명 및 양방향(BiDi) 텍스트 지원을 위한 렌더링 개선#507
seonghobae wants to merge 10 commits into
masterfrom
palette-bidi-text-support-6806216931577145038

seonghobae commented Aug 21, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

google-labs-jules Bot commented Aug 21, 2026

Uh oh!

devin-ai-integration Bot left a comment •

edited

Loading

Uh oh!

coderabbitai Bot commented Aug 21, 2026 •

edited

Loading

Walkthrough

Changes

❌ Failed checks (1 warning)

Uh oh!

This comment was marked as resolved.

Uh oh!

devin-ai-integration Bot left a comment

Uh oh!

devin-ai-integration Bot Aug 31, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

seonghobae commented Aug 21, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary by CodeRabbit

Uh oh!

google-labs-jules Bot commented Aug 21, 2026

Uh oh!

devin-ai-integration Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

✅ Devin Review: No Issues Found

Uh oh!

coderabbitai Bot commented Aug 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

❌ Failed checks (1 warning)

Uh oh!

This comment was marked as resolved.

Uh oh!

devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

Uh oh!

devin-ai-integration Bot Aug 31, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

seonghobae commented Aug 21, 2026 •

edited by coderabbitai Bot

Loading

devin-ai-integration Bot left a comment •

edited

Loading

coderabbitai Bot commented Aug 21, 2026 •

edited

Loading