# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.4.11] - 2026-01-24

### Fixed

- 빌드 출력(.d.ts)에서 JSDoc 주석이 제거되던 문제 수정
  - `@attr`, `@csspart`, `@slot` 등 문서화 주석이 타입 정의 파일에 보존됨
  - IDE 자동완성 및 API 문서 생성 시 주석 활용 가능

## [0.4.10] - 2026-01-24

### Added

- screen 컴포넌트에 `@attr` JSDoc 어노테이션 추가
  - tc-error-screen, tc-loading-screen, tc-success-screen 대상
  - API 문서 자동 생성 및 IDE 자동완성 지원 향상

### Changed

- **tc-success-screen**: 누락된 `reflect: true` 옵션 추가 (다른 컴포넌트와 일관성 유지)

## [0.4.9] - 2026-01-24

### Added

- 모든 primitive 컴포넌트에 `@attr` JSDoc 어노테이션 추가
  - API 문서 자동 생성 및 IDE 자동완성 지원 향상
  - tc-button, tc-callout, tc-card, tc-chip, tc-container, tc-divider, tc-error-message, tc-form-header, tc-icon, tc-input, tc-input-with-chip, tc-item-button, tc-otp-input, tc-page-decoration, tc-spinner, tc-text, tc-toast 대상

## [0.4.8] - 2026-01-24

### Changed

- 모든 컴포넌트의 `@property` 데코레이터에 `reflect: true` 옵션 추가
  - 속성 값이 DOM 어트리뷰트에 자동으로 반영되어 CSS 어트리뷰트 선택자로 스타일링 가능
  - 외부에서 컴포넌트 상태를 쿼리하거나 디버깅이 용이해짐
  - tc-button, tc-callout, tc-card, tc-chip, tc-container, tc-divider, tc-error-message, tc-form-header, tc-icon, tc-input, tc-input-with-chip, tc-item-button, tc-otp-input, tc-page-decoration, tc-spinner, tc-text, tc-toast, tc-error-screen, tc-loading-screen 대상

### Added

- **tc-loading-screen**: `submessage` 속성 추가

## [0.4.7] - 2026-01-13

### Fixed

- **tc-text**: Shadow DOM 환경에서 `for` 속성이 정상 작동하도록 수정
  - Shadow DOM의 label[for]는 Light DOM input을 참조할 수 없는 웹 표준 제약 해결
  - JavaScript로 커스텀 구현: label 클릭 시 자동으로 target input에 포커스
  - checkbox/radio는 자동 클릭도 지원하여 네이티브 HTML과 동일한 UX 제공
  - 사용자 API는 변경 없음 (`<tc-text tag="label" for="id">` 그대로 사용)

## [0.4.6] - 2026-01-13

### Added

- **tc-text**: `for` 속성 지원 추가 (label 접근성 개선)
  - `tag="label"`일 때 `for` 속성으로 form control과 연결 가능
  - 스크린 리더 및 키보드 네비게이션 접근성 향상
  - Storybook `LabelWithFor` 스토리 추가

## [0.4.5] - 2025-12-23

### Fixed

- **tc-success-screen**: 아이콘 배경색 복구 (`background: var(--alpha-primary10)`)

## [0.4.4] - 2025-12-23

### Added

- `prepublishOnly` 스크립트 추가: npm publish 시 자동으로 clean → build 수행

## [0.4.3] - 2025-12-23

### Changed

- 빌드 파일 최신화를 위한 재배포 (코드 변경 없음)

## [0.4.2] - 2025-12-23

### Removed

- **Screen 컴포넌트**: 모든 스크린 컴포넌트에서 `background: var(--paper-white)` 제거
  - tc-error-screen, tc-loading-screen, tc-success-screen
  - 부모 컨테이너의 배경색을 따르도록 변경

## [0.4.1] - 2025-12-23

### Changed

- **tc-chip**: 텍스트에 `text-transform: uppercase` 적용
- **tc-success-screen**: 아이콘 색상을 `--accent-primary` 기반으로 변경
  - 외부에서 `--accent-primary` 커스텀 시 아이콘 배경/색상 변경 가능
  - `--alpha-success10` → `--alpha-primary10`
  - `--accent-success` → `--accent-primary`

### Removed

- **tc-success-screen**: `.icon-container` 배경색 제거 (tc-loading-screen과 일관성 유지)

## [0.4.0] - 2025-12-17

### Changed

- **인터페이스 통합**: 모든 컴포넌트의 스타일 커스터마이징을 `sx` prop으로 일원화
  - Raw CSS props 제거 (tc-box, tc-container, tc-icon 등)
  - SxProps 타입의 일관된 적용
- 문서 간소화 및 API Reference 강화

### Removed

- **Raw CSS props 제거** (Breaking Change):
  - tc-box: `width`, `height`, `padding`, `margin`, `background`, `border-radius`, `box-shadow`, `display`, `flex-direction`, `align-items`, `justify-content`, `gap`
  - tc-container: `padding`
  - tc-icon: `size`, `color`
  - tc-section: `gap`
  - tc-divider: `color`, `thickness`, `margin`

**Migration**: Raw CSS props를 사용하던 코드는 `.sx` prop으로 변경하세요.
```typescript
// Before
<tc-box padding="2rem" background="var(--paper-warm)">

// After
<tc-box .sx=${{ padding: '2rem', background: 'var(--paper-warm)' }}>
```

## [0.3.6] - 2025-12-17

### Changed

- CSS 토큰 활용 강화: 하드코딩된 값을 design-tokens CSS 변수로 교체
  - tc-error-screen, tc-success-screen: 애니메이션 오프셋 토큰화
  - tc-input, tc-input-with-chip: focus ring, slideDown 애니메이션 토큰화
  - tc-item-button, tc-error-message: 아이콘 크기 토큰화
  - tc-page-decoration, tc-spinner: `border-radius: 50%` → `var(--radius-full)`
- `:host` 스타일 일관성 통일 및 reset.css 통합
- Storybook 설정 역할 분리 및 중복 제거

### Removed

- **widgets 레이어 제거**: 미사용 복합 컴포넌트 삭제
  - tc-authenticator-card, tc-floating-button, tc-iframe-modal
  - tc-installation-banner, tc-ios-installation-guide
  - tc-notification-modal, tc-offline-modal
- FormValidationController 제거 (미사용)
- 컨트롤러 Storybook 스토리 제거 (내부 구현 세부사항)

### Fixed

- Storybook: sideEffects, storybookAliases, isStorybook 감지 로직 수정

**Note**: 이 버전은 `@transcodes/design-tokens@^0.3.6`과 함께 사용해야 합니다.

## [0.3.5] - 2025-12-11

### Fixed

- TypeScript 타입 정의 파일(.d.ts) 누락 문제 수정
  - `rollupTypes: false`로 변경하여 모든 컴포넌트의 개별 .d.ts 생성
  - primitives, widgets, screens 모든 컴포넌트에 타입 정의 포함

## [0.3.4] - 2025-12-11

### Changed

- design-tokens 버전 동기화: ^0.3.4 (다크모드 수동 제어만 지원)

## [0.3.3] - 2025-12-11

### Fixed

- **CRITICAL**: `sideEffects: false` 설정으로 웹 컴포넌트가 등록되지 않는 문제 수정
  - `sideEffects: ["dist/**/*.js"]`로 변경하여 `customElements.define()` 부작용 보존
  - esbuild 경고 해결: "Ignoring this import because ... was marked as having no side effects"

## [0.3.2] - 2025-12-11

### Fixed

- Vite 빌드 설정: multiple entries 추가로 하위 폴더 index.js 파일 생성
- package.json exports의 실제 파일 경로 문제 해결

## [0.3.1] - 2025-12-11

### Added

- Tree-shaking 지원: preserveModules 빌드로 사용하는 컴포넌트만 번들에 포함
- package.json exports 개선: 계층별 subpath exports 추가 (`/primitives`, `/widgets`, `/screens`, `/controllers`)
- esbuild minification 및 적극적 tree-shaking 설정

### Changed

- design-tokens CSS import 제거 (design-tokens에서 자동 로드)
- package.json `sideEffects: false` 설정으로 더 나은 tree-shaking 지원
- Vite 빌드 최적화: constBindings, compact, es2020 target

### Fixed

- vite.config.ts 타입 에러 수정: esbuild 옵션을 최상위 레벨로 이동

## [0.3.0] - 2025-12-11

### Added

- **tc-error-message**: 에러/경고/정보 메시지 컴포넌트 (tc-callout 래퍼)
- **tc-input-with-chip**: 칩 인디케이터가 붙은 입력 필드
- **tc-authenticator-card**: 인증기 정보 카드 (passkey, TOTP, USB 등)
- 누락된 primitives 스토리 추가 (tc-item, tc-item-button, tc-symbol, tc-toast)
- 스크린 컴포넌트에 FlexibleHeight 스토리 추가

### Changed

- 스크린 컴포넌트 `min-height` 개선: `100vh/100dvh` → `inherit` (유연한 컨테이너 크기 지원)
- design-tokens import 경로 변경: `@transcodes/design-tokens/css` 사용
- Stories 폴더 구조 재편성 (primitives, widgets, screens, controllers 분리)

### Fixed

- Vercel 배포를 위한 public/ 폴더 구조 수정

## [0.2.0] - 2025-12-10

### Added

- npm publish 준비 완료 (package.json 메타데이터, README 개선)
- Storybook 개선 및 design-tokens 통합
- tc-callout: `icon` 슬롯 추가, CSS parts 확장 (icon, content)
- tc-divider: `text` prop 추가 (텍스트 구분선 지원)
- tc-icon: 브랜드/인증 아이콘 추가 (apple, google, windows, samsung, totp, qrcode 등)
- tc-input: `tc-keydown`, `tc-paste` 이벤트 추가

### Fixed

- Storybook 빌드 시 vite-plugin-dts 비활성화 문제 해결
- Vercel 빌드 시 workspace 의존성 해결

## [0.1.0] - 2025-12-10

### Added

- Initial release of Lit 3.x component library
- **Primitives**: tc-button, tc-input, tc-text, tc-icon, tc-divider, tc-callout, tc-chip, tc-spinner, tc-otp-input, tc-box, tc-container, tc-item, tc-item-button
- **Widgets**: tc-modal, tc-fab, tc-toast, tc-floating-button
- **Controllers**: BaseController, MatchMediaController, FormSubmissionController
- tc-input: `tc-keydown`, `tc-paste` events
- tc-callout: `icon` named slot
- tc-divider: `text` prop for divider with text
- tc-icon: 32 icons including brand icons (apple, google, windows, samsung)
- Storybook documentation
- Vercel deployment support
- TypeScript type definitions