Skip to content

docs(vanilla-extract): say that style debug IDs are ignored - #950

Open
owjs3901 wants to merge 1 commit into
mainfrom
docs/vanilla-extract-debug-id
Open

owjs3901 wants to merge 1 commit into
mainfrom
docs/vanilla-extract-debug-id

Conversation

@owjs3901

Copy link
Copy Markdown
Contributor

Summary

VE-03(#690, P3): vanilla-extract style(obj, debugId)가 debugId를 받지만 무시합니다.

재검증 (main libs/extractor/src/vanilla_extract.rs)

  • debugId를 이름에 쓰는 API: createVar, createContainer, layer, fontFace, createTheme (StyleCollector::identifier(debug_id, fallback)).
  • 받지만 무시하는 API: style(첫 인자만 읽음), styleVariants, keyframes. 이들의 클래스/keyframes 이름은 Devup UI의 class naming(debug 옵션이면 읽기 쉬운 이름)에서 옵니다.

결정: 문서화

  • dev 클래스 이름에 debugId를 싣는 쪽은 Rust extractor(클래스 이름 생성과 style 등록 경로)를 바꿔야 해서 이번 범위(TS/문서)에서 제외했습니다.
  • vanilla-extract 마이그레이션 문서(영어, 한국어)의 "Stylesheet files" 절에 위 구분을 한 문단으로 적었습니다.

문서만 바꾸므로 changepack은 없습니다.

Test plan

  • bunx prettier --check (두 mdx)
  • git diff --stat: 각 파일 +2줄, 라인 엔딩 churn 없음

Refs #690

🤖 Generated with Claude Code

style(), styleVariants() and keyframes() accept a debugId and drop it;
only createVar, createContainer, layer, fontFace and createTheme use it
in the names they generate. Say so in the migration guide, in English
and Korean.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@codecov

codecov Bot commented Nov 15, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Sign up for free to 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