// scripts/ci/check-ds-contract.mjs // TDD v2.0 Phase 2 — @d3ro/ui 디자인 시스템(DS) 컴포넌트 역할·ARIA·토큰·테스트 커버리지 계약 게이트. // // 검증 규칙: // 1. packages/ui/src/components/ds/index.ts 에 export 된 모든 컴포넌트 소스 파일이 존재해야 한다. // 2. DS 컴포넌트 소스에 하드코딩 hex 색상(#RGB / #RRGGBB)이 없어야 한다. // 3. 대화형 컴포넌트(PhysicalButton, SegmentControl, TactileBadge)는 명시적 시맨틱/ARIA 계약을 포함해야 한다. // 4. 장식 지표 컴포넌트(Led, StatRing)는 aria-hidden 을 포함해야 한다. // 5. packages/ui/__tests__/ds-contract.test.tsx 가 export 된 모든 DS 컴포넌트를 참조해야 하며, // 스냅샷 단정(toMatchSnapshot / toMatchInlineSnapshot)은 금지한다. import { existsSync, readFileSync } from 'node:fs' import { dirname, join } from 'node:path' import { fileURLToPath } from 'node:url' const root = join(dirname(fileURLToPath(import.meta.url)), '..', '..') const dsDir = join(root, 'packages', 'ui', 'src', 'components', 'ds') const testPath = join(root, 'packages', 'ui', '__tests__', 'ds-contract.test.tsx') const HEX_COLOR_RE = /#[0-9a-fA-F]{3,8}\b/ const INTERACTIVE_CONTRACTS = { PhysicalButton: [' 0) { throw new Error(`ds_contract_invalid:${errors.join(',')}`) } return { ok: true, exportedComponents: entries.length } } function expectRejected(baseSurfaces, mutate, expectedCode) { const clone = structuredClone(baseSurfaces) mutate(clone) try { validateDsContract(clone) } catch (err) { if (err instanceof Error && err.message.includes(expectedCode)) return throw err } throw new Error(`ds_contract_self_test_failed:${expectedCode}`) } const surfaces = loadSurfaces() const result = validateDsContract(surfaces) if (process.argv.includes('--self-test')) { expectRejected( surfaces, (s) => { s.components.Led = `${s.components.Led}\nconst BAD = '#ff00aa'\n` }, 'ds_hardcoded_hex:Led' ) expectRejected( surfaces, (s) => { s.components.SegmentControl = s.components.SegmentControl.replace('aria-selected', 'data-selected') }, 'ds_interactive_aria_missing:SegmentControl:aria-selected' ) expectRejected( surfaces, (s) => { s.components.Led = s.components.Led.replace('aria-hidden', 'data-led') }, 'ds_indicator_aria_hidden_missing:Led' ) expectRejected( surfaces, (s) => { s.testContent = s.testContent.replaceAll('DoubleBezelCard', 'OtherCard') }, 'ds_contract_test_missing:DoubleBezelCard' ) expectRejected( surfaces, (s) => { s.testContent = `${s.testContent}\nexpect(html).toMatchSnapshot()\n` }, 'ds_snapshot_forbidden' ) expectRejected( surfaces, (s) => { s.components.StatRing = null }, 'ds_component_missing:StatRing' ) result.negativeCases = 6 } process.stdout.write(`[check:ds-contract] GREEN (${result.exportedComponents} components${result.negativeCases ? `, ${result.negativeCases} self-test cases` : ''})\n`)