Utilities
제품 기능 자체보다 구현을 돕는 재사용 기능을 다룹니다. utility component, 함수·hook·helper class처럼 여러 화면에서 반복해 쓰는 기능을 실제 WBDS source가 있을 때만 공개합니다.
Utility components
레이아웃, focus, portal처럼 제품 도메인보다 낮은 수준에서 구현을 돕는 재사용 primitive를 다룹니다. 현재 WBDS에는 별도 공개할 utility component가 없습니다.
아직 공개된 항목이 없습니다.
여러 화면에서 실제로 재사용할 수 있는 계약이 생기기 전에는 문서용 placeholder API를 만들지 않습니다.
Web utilities
레이아웃 폭, 접근성 텍스트, 긴 기술 문자열 처리처럼 여러 화면에서 반복 사용하는 helper입니다.
현재 제공 범위
Utilities 후보를 실제 재사용 계약과 소스 소유권 기준으로 검토했습니다. 아직 구현이 없는 API나 utility component는 문서만 먼저 만들지 않습니다.
| 후보 | 소스 | 현재 근거 | 결정 |
|---|---|---|---|
| Layout measures | packages/wbds/foundation.css | .wbds-page / .wbds-workbench / .wbds-reading / .wbds-proseUsed by Showcase/fixtures; distinct page, workbench and reading measures are part of the foundation layout contract. | 공개 |
| Visually hidden | packages/wbds/foundation.css | .wbds-sr-onlyReusable accessible-name/content helper; not tied to one component family. | 공개 |
| Breakable content | packages/wbds/foundation.css + docs/language-and-writing.md | .wbds-breakableLanguage guidance explicitly reserves it for URLs, hashes, IDs and machine tokens. | 공개 |
| Semantic wrapping adapter | docs/language-and-writing.md | Optional semantic-wrap integration reference; no WBDS core runtime exists.Useful only for proven high-salience Display/Cut-in consumer needs. | 보류 |
| Toast convenience API | components Toast contract (no utility runtime yet) | Toast를 호출·제어하기 쉽게 만드는 helper/hook APIMontage의 useToast처럼 Utilities에 둘 수 있는 유형이지만, WBDS에는 현재 framework-neutral reusable runtime이 없습니다. | 보류 |
| Theme remap | packages/wbds/themes.css | data-wb-theme semantic remapCanonical home is Foundations Theme; duplicating it as a Utility would split ownership. | 제외 |
| Motion preference | packages/wbds/foundation.css + docs/motion-policy.md | data-wb-motion full/reducedCanonical home is Foundations Motion and motion-bearing component contracts. | 제외 |
| Command refinement | packages/wbds/command.css | Button run-command treatmentComponent-specific behavior owned by Text Button/command controls. | 제외 |
| Docs application runtime | apps/site/app.js | Docs menu/search/theme/copy runtimePresentation-layer behavior; not a reusable WBDS package utility. | 제외 |