style(admin): unify text color hierarchy with foundation gray

2026-11-11 14:33:58 +09:00
1 parent 5ffe56a9aa
commit 0486cecd5c
@@ -1,6 +1,6 @@
 # Combobox

-> 현재 접근성 보완(2026-10-10): 흰 Trigger의 빈 값 안내는 기존 `--hm-sem-fg-secondary`를 사용한다. 기본 Theme에서 #6e6759/흰색이며 공통 placeholder Token과 Disabled opacity는 보존한다. 아래 과거 검증의 #999 실측은 당시 기록이다.
+> 현재 기준(2026-11-11 Admin 텍스트 위계): 흰 Trigger의 빈 값 안내는 공통 `--hm-sem-fg-placeholder`(#757575, 흰색 대비 4.61:1)를 사용한다. 2026-10-10 접근성 보완의 `--hm-sem-fg-secondary`(#6e6759) 적용은 당시 Placeholder #999 대비 부족 때문이었고, Placeholder 기본값이 4.5:1을 넘으면서 공통 Token으로 되돌렸다. Disabled opacity는 보존한다. 아래 과거 검증의 #999 실측은 당시 기록이다.

 > 2026-10-10 추가 수정 요청 기준: 현재 구현의 연결형 Popup을 기준으로 문서를 통일. 팝업 dialog 이름은 aria-label → aria-labelledby → 고유 trigger ID 순으로 연결. Command 검색·listbox 이름과 인스턴스 ID는 독립. 과거 검증 기록은 당시 결과이며 현재 검증은 [추가 수정 보고서](../guidelines/publisher-additional-review-2026-10-10.md)를 따릅니다.

@@ -39,7 +39,7 @@
 |---|---|
 | Size | `large`(기본, 44px, 16 / 24), `medium`(34px, 14 / 20) — Select와 같은 두 크기 |
 | Trigger | 폭 100%(부모 폭), padding-x 12px, 1px `--hm-sem-stroke-input-default`, radius 4px, 흰 면, 오른쪽 chevron 18px |
-| 값 / placeholder | 선택된 option의 label, 없으면 placeholder("선택", `--hm-sem-fg-secondary`), 길면 말줄임 |
+| 값 / placeholder | 선택된 option의 label, 없으면 placeholder("선택", `--hm-sem-fg-placeholder`), 길면 말줄임 |
 | Popup | padding 0, 폭 = trigger 폭(`--radix-popover-trigger-width`), sideOffset=-1로 1px 연결 경계 공유. Focus border, 안쪽 두 모서리 radius는 기존 Input token, shadow `0 2px 24px black 12%` |
 | 검색 | Command Input(placeholder 기본 "검색...") |
 | 목록 | Command List(최대 280px), Item 높이 36px·padding-x 12px·radius 0·weight 400. Large 16/24, Medium 14/20. 선택 check 16px, 긴 label은 말줄임 |
@@ -1,6 +1,6 @@
 # Date Picker

-> 현재 접근성 보완(2026-10-10): 흰 Trigger의 빈 값 안내는 기존 `--hm-sem-fg-secondary`를 사용한다. 기본 Theme에서 #6e6759/흰색이며 공통 placeholder Token과 Disabled opacity는 보존한다. 아래 과거 검증의 #999 실측은 당시 기록이다.
+> 현재 기준(2026-11-11 Admin 텍스트 위계): 흰 Trigger의 빈 값 안내는 공통 `--hm-sem-fg-placeholder`(#757575, 흰색 대비 4.61:1)를 사용한다. 2026-10-10 접근성 보완의 `--hm-sem-fg-secondary`(#6e6759) 적용은 당시 Placeholder #999 대비 부족 때문이었고, Placeholder 기본값이 4.5:1을 넘으면서 공통 Token으로 되돌렸다. Disabled opacity는 보존한다. 아래 과거 검증의 #999 실측은 당시 기록이다.

 현재 HM 구현의 기준 문서. 공통 원칙은 `docs/guidelines/프로젝트-지침.md`(§6, §7), Token 구조 원칙은 `테마-토큰-가이드.md`를 따른다. 이 문서는 Date Picker 고유의 API·Token·상태·결정만 기록한다.

@@ -29,7 +29,7 @@
 |---|---|
 | Size | `large`(기본, 안쪽 42px + 1px border = 44px, 16 / 24), `medium`(안쪽 32px = 34px, 14 / 20) — Select와 같은 두 크기 |
 | Trigger | 폭 100%(부모 폭), padding-x 12px, 1px `--hm-sem-stroke-input-default`, radius 4px, 흰 면, 오른쪽 달력 아이콘 18px `--hm-sem-fg-secondary` |
-| 값 / placeholder | 선택값은 `--hm-sem-fg-primary`, placeholder("날짜 선택")는 `--hm-sem-fg-secondary`, 길면 말줄임 |
+| 값 / placeholder | 선택값은 `--hm-sem-fg-primary`, placeholder("날짜 선택")는 `--hm-sem-fg-placeholder`, 길면 말줄임 |
 | 날짜 표시 | 로컬 `Date`의 연·월·일 → `YYYY.MM.DD` (예: `2026.01.09`, `2026.10.06`). `format` prop으로 교체 |
 | Popup | Popover 면(흰 면, 1px pale border, 4px radius, 그림자)에 Popover padding 0, 폭 `auto`로 Calendar에 맞춤 |

@@ -30,7 +30,7 @@

 - 높이는 `min-height`, 한 줄 텍스트는 가운데.
 - Border 1px(`--hm-sem-stroke-input-default`), radius `--hm-radius-input`, face `--hm-sem-bg-surface`, 글자색 `--hm-sem-fg-primary`, weight 400.
- Placeholder: `--hm-sem-fg-placeholder`, `opacity: 1`.
+- Placeholder: `--hm-sem-fg-placeholder`(#757575), `opacity: 1`. readonly는 면이 투명해 베이지 콘텐츠 면에서 4.5:1 미만이 되므로 `--hm-sem-fg-secondary`(#616161)를 쓴다(2026-11-11).

 ## 4. 상태 규격

@@ -93,9 +93,9 @@ native `<input>` 동작 전체(`type`, `file:` 스타일 class, `placeholder`),

 **2026-10-11 최종 사용자 결정 — Disabled Input Label**

- Input Story 소비 조합(`src/components/input.stories.tsx`의 `Specimen`)의 Disabled Label은 기존 `text-muted-foreground` → `--muted-foreground` → `--hm-sem-fg-secondary` 색(`#6E6759`)을 유지하고, `input.disabled`일 때만 `opacity-60`을 적용한다. HEX·Semantic Token·공개 Input API는 변경하지 않는다.
+- Input Story 소비 조합(`src/components/input.stories.tsx`의 `Specimen`)의 Disabled Label은 기존 `text-muted-foreground` → `--muted-foreground` → `--hm-sem-fg-secondary` 색(2026-11-11부터 `#616161`, 당시 `#6E6759`)을 유지하고, `input.disabled`일 때만 `opacity-60`을 적용한다. HEX·Semantic Token·공개 Input API는 변경하지 않는다.
 - Disabled Input 컨트롤 `0.6`, 소비 Label `0.6`, 부모 Field `1`이다. 형제 요소에 각각 적용하여 중첩 opacity를 만들지 않는다. 기본·readOnly·Error Label은 기존 `1`을 유지한다(Disabled가 아닌 경우).
- 공통 [Label Component](label.md#4-상태-규격)의 Disabled `0.5`는 유지한다. Helper Text(`#6E6759`)와 Error Message(`#D32F2F`)도 기존 구현을 유지하며 이번 변경 대상이 아니다.
+- 공통 [Label Component](label.md#4-상태-규격)의 Disabled `0.5`는 유지한다. Helper Text(`--hm-sem-fg-secondary`, 2026-11-11부터 `#616161`)와 Error Message(`#D32F2F`)도 기존 구현을 유지하며 이번 변경 대상이 아니다.
 - 이전 검토의 “Label 100% 유지”는 당시 선택이며 현재 최종 결정은 Disabled Input Story Label `60%`다. 아래 2026-10-02 승인과 2026-10-06 검증은 당시 기록으로 보존하며, 이번 Label 정책의 현재 검증을 대신하지 않는다.
 - 실제 소비 화면은 자동으로 확대 수정하지 않는다. 신규 화면의 공개 Label 재사용·control 연결 계약은 유지하며, 공통 Label의 Disabled 정책을 이 Story 결정으로 대체하지 않는다.

@@ -24,7 +24,7 @@
 | 항목 | 값 |
 |---|---|
 | Typography | 14 / 20 / 500 |
-| 색 | `--hm-sem-fg-secondary` (`#6E6759`) |
+| 색 | `--hm-sem-fg-secondary` (`#616161`, 2026-11-11 Admin 텍스트 위계 전 `#6E6759`) |
 | 배치 | `flex w-fit items-center gap-2` (shadcn 기본, 부모 grid에서 시작 정렬) |

 Label ↔ Control 간격 8px(`input.field.gap`)은 Field 조합의 값이며 Label이 소유하지 않는다.
@@ -6,9 +6,9 @@
 |---|---|---|---|---|---|
 | `color.bg.content` | `--hm-sem-bg-content` | `#f5f0e5` | 콘텐츠 면 | Yes | gnb, lnb |
 | `color.bg.surface` | `--hm-sem-bg-surface` | `#ffffff` | 기본/카드/입력 면 | Yes | checkbox, radio, switch, slider, badge, table, input, select, button, gnb |
-| `color.fg.primary` | `--hm-sem-fg-primary` | `#11372d` | 주요 텍스트 | Yes | calendar, pagination, badge, table, input, select, gnb |
-| `color.fg.secondary` | `--hm-sem-fg-secondary` | `#6e6759` | 보조 텍스트 | Yes | calendar, pagination, badge, table, gnb |
-| `color.fg.placeholder` | `--hm-sem-fg-placeholder` | `#999999` | Placeholder | Yes | input, select |
+| `color.fg.primary` | `--hm-sem-fg-primary` | `#212121` | 주요 텍스트 | Yes | calendar, pagination, badge, table, input, select, gnb |
+| `color.fg.secondary` | `--hm-sem-fg-secondary` | `#616161` | 보조 텍스트 | Yes | calendar, pagination, badge, table, gnb |
+| `color.fg.placeholder` | `--hm-sem-fg-placeholder` | `#757575` | Placeholder | Yes | input, textarea, select, combobox, date-picker, command |
 | `color.action.primary` | `--hm-sem-action-primary` | `#164434` | Strong / Primary ink | Yes | checkbox/radio hover, slider Hover/Drag halo, pagination current, badge default, button outline, navigation current ink |
 | `color.action.cancel` | `--hm-sem-action-cancel` | `#6e6759` | 공개 취소 역할 | Yes | Button `variant="cancel"` + `appearance="outline"` |
 | `color.action.destructive` | `--hm-sem-action-destructive` | `#d32f2f` | 오류/위험 역할 | Yes | checkbox, radio, badge, input, button |
@@ -51,7 +51,7 @@
 | `color.palette.green-light-2` | `--hm-sem-palette-green-light-2` | `#266651` | 선택적 Theme 팔레트: green-light-2 | Yes | checkbox, radio, switch, slider, progress, calendar, table, input, select, gnb, lnb |
 | `color.palette.green-light-1` | `--hm-sem-palette-green-light-1` | `#205241` | 선택적 Theme 팔레트: green-light-1 | Yes | table, button, lnb |
 | `color.palette.green-default` | `--hm-sem-palette-green-default` | `#164434` | 선택적 Theme 팔레트: green-default | Yes | checkbox, radio, slider, calendar, pagination, badge, select, button, gnb, lnb |
-| `color.palette.green-dark-1` | `--hm-sem-palette-green-dark-1` | `#11372d` | 선택적 Theme 팔레트: green-dark-1 | Yes | calendar, pagination, badge, table, input, select, button, gnb |
+| `color.palette.green-dark-1` | `--hm-sem-palette-green-dark-1` | `#11372d` | 선택적 Theme 팔레트: green-dark-1 | Yes | brand gradient stop, button border, tabs arrow (2026-11-11부터 텍스트 기본값 아님) |
 | `color.palette.green-dark-2` | `--hm-sem-palette-green-dark-2` | `#0b2b23` | 선택적 Theme 팔레트: green-dark-2 | Yes | Theme palette / adapter |
 | `color.palette.brown-light-2` | `--hm-sem-palette-brown-light-2` | `#897445` | 선택적 Theme 팔레트: brown-light-2 | Yes | button |
 | `color.palette.brown-light-1` | `--hm-sem-palette-brown-light-1` | `#604f32` | 선택적 Theme 팔레트: brown-light-1 | Yes | button |
@@ -62,12 +62,12 @@
 | `color.palette.orange-default` | `--hm-sem-palette-orange-default` | `#cc5200` | 선택적 Theme 팔레트: orange-default | Yes | button |
 | `color.palette.warm-neutral-light` | `--hm-sem-palette-warm-neutral-light` | `#e0dace` | 선택적 Theme 팔레트: warm-neutral-light | Yes | slider, progress |
 | `color.palette.warm-neutral-mid` | `--hm-sem-palette-warm-neutral-mid` | `#9a9284` | 선택적 Theme 팔레트: warm-neutral-mid | Yes | checkbox, radio, switch, badge |
-| `color.palette.warm-neutral-dark` | `--hm-sem-palette-warm-neutral-dark` | `#6e6759` | 선택적 Theme 팔레트: warm-neutral-dark | Yes | calendar, pagination, badge, table, gnb |
+| `color.palette.warm-neutral-dark` | `--hm-sem-palette-warm-neutral-dark` | `#6e6759` | 선택적 Theme 팔레트: warm-neutral-dark | Yes | action cancel, chart series side (2026-11-11부터 텍스트 기본값 아님) |
 | `color.palette.beige-light` | `--hm-sem-palette-beige-light` | `#f5f0e5` | 선택적 Theme 팔레트: beige-light | Yes | gnb, lnb |
 | `color.palette.red-danger` | `--hm-sem-palette-red-danger` | `#d32f2f` | 선택적 Theme 팔레트: red-danger | Yes | checkbox, radio, badge, input, button |
 | `color.palette.white` | `--hm-sem-palette-white` | `#ffffff` | 선택적 Theme 팔레트: white | Yes | checkbox, radio, switch, slider, calendar, pagination, badge, table, input, select, button, gnb, lnb |
 | `color.palette.black` | `--hm-sem-palette-black` | `#000000` | 선택적 Theme 팔레트: black | Yes | checkbox, switch, select, button, gnb, lnb |
-| `color.palette.neutral-gray-500` | `--hm-sem-palette-neutral-gray-500` | `#999999` | 선택적 Theme 팔레트: neutral-gray-500 | Yes | input, select |
+| `color.palette.neutral-gray-500` | `--hm-sem-palette-neutral-gray-500` | `#999999` | 선택적 Theme 팔레트: neutral-gray-500 | Yes | 호환 유지(2026-11-11부터 Placeholder 기본 연결 없음) |
 | `color.palette.green-tone-1` | `--hm-sem-palette-green-tone-1` | `#1f8265` | 선택적 Theme 팔레트: green-tone-1 | Yes | button, gnb |
 | `color.palette.green-tone-2` | `--hm-sem-palette-green-tone-2` | `#165c47` | 선택적 Theme 팔레트: green-tone-2 | Yes | button, gnb |
 | `color.palette.green-tone-3` | `--hm-sem-palette-green-tone-3` | `#114838` | 선택적 Theme 팔레트: green-tone-3 | Yes | button, gnb |
@@ -99,8 +99,13 @@
 | `color.palette.orange-dark-1` | `--hm-sem-palette-orange-dark-1` | `#bc4c00` | 2026-10-11 사용자 확정 브랜드 단계 | Yes | Color Reference / 선택적 Theme palette |
 | `color.palette.orange-dark-2` | `--hm-sem-palette-orange-dark-2` | `#883700` | 2026-10-11 사용자 확정 브랜드 단계 | Yes | Color Reference / 선택적 Theme palette |
 | `color.palette.orange-dark-3` | `--hm-sem-palette-orange-dark-3` | `#4f2000` | 2026-10-11 사용자 재확정 브랜드 단계 | Yes | Color Reference / 선택적 Theme palette |
+| `color.palette.gray-900` | `--hm-sem-palette-gray-900` | `#212121` | Foundation Gray 텍스트 단계 (2026-11-11) | Yes | fg-primary 기본 |
+| `color.palette.gray-800` | `--hm-sem-palette-gray-800` | `#424242` | Foundation Gray 텍스트 단계 (2026-11-11) | Yes | 기본 연결 없음(Strong Secondary 예약) |
+| `color.palette.gray-700` | `--hm-sem-palette-gray-700` | `#616161` | Foundation Gray 텍스트 단계 (2026-11-11) | Yes | fg-secondary 기본 |
+| `color.palette.gray-600` | `--hm-sem-palette-gray-600` | `#757575` | Foundation Gray 텍스트 단계 (2026-11-11) | Yes | fg-placeholder 기본 |
+| `color.palette.gray-500` | `--hm-sem-palette-gray-500` | `#9e9e9e` | Foundation Gray 텍스트 단계 (2026-11-11) | Yes | 기본 연결 없음(Disabled는 opacity 정책 유지) |

-총 94개. 기존 25개 + 핵심 역할 6개 + 선택적 팔레트 52개(2026-10-11 ui_viz 확정 단계 8개 및 사용자 확정 Orange Dark 1·2 추가) + Provisional Generic Status Error 1개 + Brown·Orange Background Stop 10개. 팔레트는 컴포넌트별 계약이 아니며 Primary / Active / Focus를 개별 지정하면 팔레트 alias보다 우선한다. Focus와 Active, Primary와 On Accent는 각각 sibling이며 서로 alias하지 않는다.
+총 99개(2026-11-11 Foundation Gray 텍스트 단계 5개 추가 전 94개). 기존 25개 + 핵심 역할 6개 + 선택적 팔레트 52개(2026-10-11 ui_viz 확정 단계 8개 및 사용자 확정 Orange Dark 1·2 추가) + Provisional Generic Status Error 1개 + Brown·Orange Background Stop 10개. 팔레트는 컴포넌트별 계약이 아니며 Primary / Active / Focus를 개별 지정하면 팔레트 alias보다 우선한다. Focus와 Active, Primary와 On Accent는 각각 sibling이며 서로 alias하지 않는다.

 ## Generic Status Error — Provisional · 2026-10-11

@@ -113,7 +118,7 @@ Input Error와 Generic Status Error는 별도 역할이다. Input / Alert destru

 기존 v1 입력 73개와 이전 팔레트 보강 이후 81개의 Key·CSS property·type·Default를 유지한다. Orange Dark 1·2는 최신 사용자 확정값으로 공개 입력에 추가하며 Dark 3는 기존 값을 유지한다. 과거 Needs Review 기록은 이력으로 보존하고 현재 기준은 [브랜드 컬러 단계](brand-color-steps.md)를 따른다. 공개 API `isRuntimeTheme(unknown): value is RuntimeTheme`를 제공한다. 이 사전 검증은 DOM을 변경하지 않는다. 기존 `applyRuntimeTheme`의 invalid 입력 시 reset 정책은 유지한다. 편집기는 사전 검증으로 invalid Import를 차단해 마지막 유효 Theme를 보존한다.

-Default 컬러의 운영 원본은 `themes/default.json`(92개 컬러)이다. `scripts/theme-defaults.mjs`가 JSON과 컬러 literal 없는 alias/geometry template에서 package `primitives.css`, `default.css`, `default-values.generated.ts`를 생성한다. `contract.ts`의 defaultValue와 `defaultRuntimeTheme`는 생성 데이터를 읽는다. 2개 radius/geometry는 template에서 유지한다. CSS fallback/현재 색을 유지하고 세 가지 최종 명령의 pre hook에서 stale 생성 데이터를 검사한다. Theme-only 산출은 `npm run build:themes`로 분리한다.
+Default 컬러의 운영 원본은 `themes/default.json`(97개 컬러, 2026-11-11 Gray 5개 추가 전 92개)이다. `scripts/theme-defaults.mjs`가 JSON과 컬러 literal 없는 alias/geometry template에서 package `primitives.css`, `default.css`, `default-values.generated.ts`를 생성한다. `contract.ts`의 defaultValue와 `defaultRuntimeTheme`는 생성 데이터를 읽는다. 2개 radius/geometry는 template에서 유지한다. CSS fallback/현재 색을 유지하고 세 가지 최종 명령의 pre hook에서 stale 생성 데이터를 검사한다. Theme-only 산출은 `npm run build:themes`로 분리한다.

 Storybook `Theme/Designer Playground/Editor`는 17개 상위 컬러 역할과 JSON URL/파일 Preview를 제공하는 소비자다. Global decorator에서 `resolveRuntimeTheme(theme, defaultJson)` 후 Production `applyRuntimeTheme(document.documentElement, theme)` → CSS Custom Properties → 기존 Mapping으로 적용한다. JSON Export/Import는 동일 v1 계약이다. 컬러 artifact/편집기만 radius를 거부한다. Production API의 기존 radius/gradient 계약은 유지한다.

@@ -132,3 +137,18 @@ Dashboard의 `active / hold / done / issue` 업무 상태 계약은 `packages/ui
 조합 변수 `--hm-sem-bg-brown` / `--hm-sem-bg-orange`는 내부 Derived CSS이며 전체 Gradient 문자열·방향·위치를 Runtime JSON 입력으로 받지 않는다. Runtime에서 한 stop을 바꾸려면 해당 브랜드의 5개 stop을 모두 전달한다. Brown·Orange 두 그룹은 서로 독립적이며 미지정 그룹은 기존 fallback을 따른다. 부분 그룹은 atomic validation으로 거부한다. Global / Scoped 적용과 Reset은 [Runtime Theme](runtime-theme.md)의 기존 계약을 사용한다.

 공통 Background는 기존 Green·Brown/Orange Button·Dashboard 배경에 자동 연결하지 않는다. 2026-10-11 최종 표시 요청으로 [Foundation Color](../../src/foundation/color.stories.tsx)의 기존 `foundation-color--all`은 [브랜드 3개 그룹·24개 컬러칩](brand-color-steps.md#호환성과-storybook)만 표시하며 모든 Gradient 미리보기와 개발용 설명을 제거한다. 실제 공통 Background·Button·Dashboard Gradient의 CSS·Theme·Token과 Runtime 계약은 유지한다. 과거 미정의 및 Gradient 추가 검증 보고서는 당시 이력으로 유지한다.
+
+## Admin 텍스트 위계 — Foundation Gray · 2026-11-11
+
+Web·Chart 공통 텍스트 기본값을 Foundation Gray로 바꿨다. 공개 Key·CSS property·type은 그대로이고 기본값만 바뀌었으므로, `color.fg.*`를 지정한 외부 Theme JSON은 이전과 같이 우선한다.
+
+| 역할 | 공개 Key | 기본값 | 이전 기본값 |
+|---|---|---|---|
+| Primary — 제목·본문 | `color.fg.primary` | `#212121` (gray-900) | `#11372d` (green-dark-1) |
+| Secondary — 설명·보조·캡션 | `color.fg.secondary` | `#616161` (gray-700) | `#6e6759` (warm-neutral-dark) |
+| Placeholder | `color.fg.placeholder` | `#757575` (gray-600) | `#999999` (neutral-gray-500) |
+
+- 브랜드 Primitive(`green-dark-1`, `warm-neutral-dark`, `neutral-gray-500`)의 값은 바꾸지 않았다. 텍스트 alias만 Gray를 가리킨다.
+- Strong Secondary(`gray-800`)·Tertiary·Disabled(`gray-500`) Semantic은 만들지 않았다. Disabled는 기존 opacity 정책을 유지한다.
+- 대비(흰 면 / 베이지 `#f5f0e5`): #212121 16.10 / 14.17, #616161 6.19 / 5.45, #757575 4.61 / **4.05**. Placeholder는 흰 입력 면에서만 쓰며, 투명 면인 readonly Input은 Secondary를 쓴다(`input.css`).
+- SW(`--hm-sw-*`)·CENTER·OrgChart Core는 이 기본값을 참조하지 않는다. OrgChart는 자체 `--hm-orgchart-fg-*` 기본값을 같은 값으로 맞췄다([OrgChart 승인 기록 §8](../org-chart/design-approval.md#8-2026-11-11-admin-텍스트-위계-적용)).
@@ -321,3 +321,19 @@ HMDesign의 Font Weight는 400(Regular), 500(Medium), 700(Bold)의 3단계만
 - 신규 컴포넌트·Storybook·AI 생성 코드에 같은 정책을 적용한다. Tailwind `font-normal` / `font-medium` / `font-bold`만 사용하며 `font-semibold`나 750·800 등 추가 단계는 사용하지 않는다.
 - 폰트 패밀리·크기·행간·자간은 변경하지 않는다. `@font-face`의 100–900은 가변 폰트의 지원 범위이며 UI 사용 단계가 아니다. 폰트 파일과 라이선스는 보존한다.
 - Typography는 Runtime Theme JSON 공개 allowlist 입력이 아니다. 공개 API·외부 CSS 커스터마이징 계약은 유지하며 과거 보고서의 600 실측값은 당시 검증 기록으로 보존한다.
+
+## Admin Text Hierarchy — 2026-11-11
+
+Web / Chart / OrgChart가 공유하는 Admin 텍스트 위계다. SW는 적용 대상이 아니다. 원본 값은 `themes/default.json`, Primitive는 `--hm-gray-900|800|700|600|500`(텍스트용 5단계만), 공개 Runtime Key는 `color.palette.gray-*`다. 상세 계약은 [Runtime Theme Contract](runtime-theme-contract.md#admin-텍스트-위계--foundation-gray--2026-11-11).
+
+| 역할 | 값 | 연결 | 사용 |
+|---|---|---|---|
+| Primary | `#212121` | `--hm-sem-fg-primary` (`--foreground`) | 페이지·카드·Dialog 제목, 본문, 입력값, 테이블 셀, 툴팁 값 |
+| Strong Secondary | `#424242` | Primitive만 (`--hm-gray-800`) | 현재 Semantic 없음 |
+| Secondary | `#616161` | `--hm-sem-fg-secondary` (`--muted-foreground`) | 설명, Label, 캡션·요약·빈 상태, 축·범례 |
+| Tertiary | `#757575` | `--hm-sem-fg-placeholder` | Placeholder 전용. 흰 면에서만 4.5:1 이상(베이지 4.05:1) |
+| Disabled | `#9e9e9e` | Primitive만 (`--hm-gray-500`) | 색으로 쓰지 않음. Disabled는 opacity 정책 유지 |
+
+- 유지: 브랜드·액션·상태·반전 텍스트(Button, Link `text-primary`, Tabs, GNB/LNB, Tooltip, Badge default, Destructive), 테이블 헤더 Green(`--hm-table-header-text`).
+- Placeholder는 Input·Textarea·Select·Command·Combobox·Date Picker 모두 `--hm-sem-fg-placeholder`를 쓴다. 투명 면 readonly Input만 Secondary를 쓴다.
+- 새 텍스트 역할은 위 Semantic을 쓰고 Gray Primitive를 컴포넌트에서 직접 참조하지 않는다.
@@ -149,3 +149,26 @@ Cell Border Only 디자인 실험은 사용자 결정으로 정식 적용에서
 Guard는 [P11.1 기록](consistency-review-p11-1.md)과 기존 로컬 `test-results/org-chart-p11-1/guard-actual.json`을 확인한 결과이며 이번 문서 작업에서 재실행하지 않는다. P10 당시 실제 FAIL 5건 등 과거 원본은 보존한다. 정적 PASS·디자인 승인·별도 브라우저 증거로 원본 Runtime NOT VERIFIED를 덮어쓰지 않는다.

 남은 승인과 운영 확인은 [정식 통합 승인 준비 문서](release-readiness-p10-7.md)를 따른다. 이번 P11.2는 문서화 단계이며 제품 코드·디자인 변경, 제품 전체 회귀, Commit·Push·main Merge·배포 실행을 포함하지 않는다.
+
+## 8. 2026-11-11 Admin 텍스트 위계 적용
+
+사용자가 Web / Chart / OrgChart 공통 Admin 텍스트 위계(Foundation Gray) 적용을 승인했다(2026-11-11, 결정 D8). §6-4의 사전 확인에 해당하는 승인이며, 아래 범위의 기본값만 바뀐다. OrgChart의 독립 구조는 유지한다. Web `--hm-sem-*` 토큰을 조직도에 연결하지 않고 `--hm-orgchart-*` 기본값만 같은 값으로 맞췄다. 공개 CSS 입력 이름은 바뀌지 않으며, 외부 테마가 지정한 값이 계속 우선한다.
+
+| 대상 | 이전 | 현재 | 이유 |
+|---|---|---|---|
+| `fg-primary` 기본값(제목·본문·카드 이름·테이블·툴바) | `#10243B` | `#212121` | 공통 Primary |
+| `fg-secondary` 기본값(설명·직위·캡션·빈 상태) | `#596575` | `#616161` | 공통 Secondary |
+| SVG·compact 카드 직위 | `#797979` (카드 면 `#E0E6F4` 대비 3.48:1) | `fg-secondary` `#616161` (4.95:1) | 대비 4.5:1 미달 보정 |
+| SVG 카드 이름 fallback, 이름 툴팁 | `#071D3A` / `#323232` | `fg-primary` | 중복 하드코딩 정리(`card-color` 입력 우선은 유지) |
+| readOnly·Overview 인원 패널·Workdesk 표·소속 막대 | `#18253A` / `#223149` / `#1C2534` / `#071D3A` | `fg-primary` | 중복 하드코딩 정리 |
+| Core 팝업 닫기 아이콘 마지막 fallback | `#0A221D` | `#212121` | HM 기본값 변경에 맞춤(`--foreground` 체인 유지) |
+
+유지한 항목: 브랜드 블루(대표자 직위·테이블 헤더·on-accent `#224387`, action `#45639F`), 6개 부서 Gradient·Role tag 색, 7개 회사 컬러와 흰색 그룹 제목, 파견·휴직 전용 회색(`#555F6A` / `#3E4650`, 대비 5.04 / 7.41), 인원 패널 제목의 흰 글자, 노드 배경, 연결선, Hub 라벨 artwork, Department Colors의 미승인 후보 `#10243B` 표본(진단용, 기본값 아님). React `HMEmployeeDialog`는 HM Dialog 토큰을 쓰므로 Core 팝업과 같은 `#212121` / `#616161`이 되었다.
+
+| 접근성 항목 | 상태 |
+|---|---|
+| 카드 직위 `#797979` 대비 미달 | 수정함 |
+| 비readOnly 상태 그룹 제목(15px Bold, `#87909C → #68727E` 그라데이션) | **보류.** 텍스트 `#212121`은 4.98 → 3.29:1, 흰색은 3.23 → 4.89:1이라 글자색만으로 전 구간 4.5:1을 확보할 수 없다. 배경(상태색)이나 글자 크기를 바꿔야 하므로 별도 결정이다. readOnly 제목은 20px Bold 대형 텍스트라 흰색 3.23:1 이상(대형 기준 3:1)이다. |
+| 삼안·장헌산업 흰색 그룹 제목(§4) | 미해결 유지 |
+
+대비는 선언색 기준 계산값이다. 2026-11-11 Storybook(전체 구성·개요·확장 조직도·Cards·Status Summary)에서 계산된 글자색이 위 값과 일치함을 확인했다. SVG 카드 artwork 위 픽셀 대비는 측정하지 않았다.