# 한맥오렌지 최종 사용자 확정값 반영 — 2026-10-11

RESULT: PASS (요청한 Color 영역)

## 작업 기준과 결과

공식 프로젝트 `D:/디자인시스템/HMDesign-Gitea-Transfer`, `main`, origin `https://gitea.hmac.kr/b25027/HMDesign.git`에서 작업했다. 시작 Local/Remote HEAD는 모두 `7b22fe88a1142c76ad77663610a9936a6e2b7dc0`이고 Working Tree는 CLEAN이었다.

사용자가 직접 확정한 Dark 1 #BC4C00, Dark 2 #883700, Dark 3 #4F2000을 최신 기준으로 적용했다. Dark 1·2 공개 Key와 CSS 변수를 추가했다. Dark 3는 이미 일치해 값을 유지했다. Light 4~Default 및 기존 81개 입력의 Key·CSS property·type·기본값은 보존했다. 공개 입력 83개, JSON 컬러 81개다. 이전 Needs Review 검수 보고서는 수정하지 않았다.

## 한맥오렌지 8단계

| 단계 | 공개 Token | HEX | 처리 |
|---|---|---|---|
| Light 4 | color.palette.orange-light-4 | #FEBA88 | 기존 확정값 유지 |
| Light 3 | color.palette.orange-light-3 | #EC8F53 | 기존 확정값 유지 |
| Light 2 | color.palette.orange-light-2 | #F87725 | 기존 확정값 유지 |
| Light 1 | color.palette.orange-light-1 | #EB5F00 | 기존 확정값 유지 |
| Default | color.palette.orange-default | #CC5200 | 기존 확정값·기본색 강조 유지 |
| Dark 1 | color.palette.orange-dark-1 | #BC4C00 | 사용자 확정·추가 |
| Dark 2 | color.palette.orange-dark-2 | #883700 | 사용자 확정·추가 |
| Dark 3 | color.palette.orange-dark-3 | #4F2000 | 사용자 재확정·기존값 유지 |

CSS는 각 suffix의 `--hm-sem-palette-orange-*`와 `--hm-orange-*`를 연결한다. 전체 순서와 HEX는 [현재 컬러 가이드](../guidelines/brand-color-steps.md) 및 [Runtime Contract](../guidelines/runtime-theme-contract.md)에 일치한다.

## 호환성과 변경 파일

- `themes/default.json`, `packages/ui/src/theme/contract.ts`: 두 팔레트 입력만 추가.
- `scripts/theme-templates/primitives.css`, `default.css`: Primitive 및 Semantic 연결 추가. 생성된 `packages/ui/src/theme/primitives.css`, `default.css`, `default-values.generated.ts` 동기화.
- `src/foundation/color.stories.tsx`: Orange 8/8 확정 연결 및 현재 설명 갱신. Story ID `foundation-color--all`과 기존 강조 CSS 유지.
- 현재 가이드 7개: brand-color-steps, runtime-theme-contract, runtime-theme, designer-theme-guide, theme-delivery, 개발-적용-가이드, 프로젝트-지침. 확정 기준·계약 수량 정합성 갱신.
- 이 보고서: 이번 확정 결과를 이전 보고서와 분리 기록.

Legacy Orange Light #D35A00·Mid #CE5600·Dark #B44B00·Deep #783402와 Border #BC4C00을 유지했다. 실제 Button gradient 소비 CSS는 수정하지 않았고 기존 CSS 선언을 기준 커밋과 비교했다. Legacy gradient를 브랜드 번호 단계로 alias하지 않는다. 브랜드 단계의 미확정 값이나 대응 문제는 없다.

## 실제 실행한 선택 검증

- `npm run check:theme-defaults`: PASS, 81 JSON colors / 83 defaults 일치.
- `npm run build:ui`: PASS, UI JS/types/CSS 산출 정상.
- `npm run typecheck -w @hm-design/ui`, `node node_modules/typescript/bin/tsc -b`: PASS.
- `npm run build-storybook --ignore-scripts`: PASS. 기존 큰 chunk 및 plugin timing 경고만 존재.
- 기준 커밋의 81개 입력·79개 JSON 컬러·기존 CSS 선언 비교: PASS. 신규 Key는 Orange Dark 1·2만 존재. 기존 JSON과 두 신규 Key partial JSON 검증 PASS. Theme export 8개 유지.
- 실제 정적 Storybook Color 브라우저 1440px: Orange 8개 순서·표시 HEX·Computed RGB·CSS variable·Token 모두 PASS. Default는 유일한 data-base, 2px border, font-weight 700. 다른 칩 1px/400. 문서 전체 가로 overflow 없음, 콘솔 오류 0.
- 수정한 MD만 기존 링크 검사 알고리즘으로 검사: MD 8개 / 내부 링크 63개 / 오류 0건 PASS. Git 없는 폴더 검사와 전체 문서 검사는 반복하지 않음.
- AGENTS의 Guard 1회 PARTIAL/STORYBOOK: 원본 status/staticStatus NOT VERIFIED. styleEvidence STATIC PASS / RUNTIME NOT VERIFIED / DESIGN_INTENT PASS / FINAL NOT VERIFIED. Guard 자체 미검증은 실제 Color 브라우저 PASS와 별도로 보존한다.

## 재사용·미검증 구분

이전 보고서의 정상 Component·Guard·Green·Brown·LNB·Data Table·Separator·Git 없는 문서 검사 결과는 해당 구현이 변경되지 않아 재사용했다. 전체 Component 테스트, CENTER 빌드, 다른 Story의 브라우저 검수, CDN loader/Designer 전체 검증은 반복하지 않았다. 이번 검증은 사용자 확정 Orange Token과 Color Story에 한정한다. 이전 보고서의 Needs Review는 당시 상태를 기록한 과거 이력이다.

공식 Gitea 일반 Commit·Push의 최종 SHA와 Local/Remote 일치는 최종 제출 결과에 기록한다. GitHub 소스·ui_viz·기존 main 이력과 금지된 Git 작업은 건드리지 않는다.