# 명령 및 설정
LottieFiles 명령, 미리 보기 기본값, 유효성 검사 옵션, 생성되는 개발자 파일을 확인하세요.

Command Palette를 열고 `LottieFiles`를 입력하면 확장 프로그램 명령을 찾을 수 있습니다. 특정 파일에서만 사용할 수 있는 일부 명령은 에디터, Explorer 또는 제목 표시줄 메뉴에도 나타납니다.

## 미리 보기 및 탐색 명령

| 명령                                | 결과                                   |
| --------------------------------- | ------------------------------------ |
| `LottieFiles: Open Sidebar`       | LottieFiles 사이드바로 포커스를 이동합니다.        |
| `LottieFiles: Preview in Sidebar` | 활성 에디터에서 인식된 콘텐츠를 미리 봅니다.            |
| `LottieFiles: Preview Animation`  | 지원되는 Lottie 미리 보기를 엽니다.              |
| `Explore Contents`                | dotLottie Explorer에서 `.lottie`를 엽니다. |
| `Refresh`                         | dotLottie Explorer를 새로 고칩니다.         |
| `LottieFiles: Getting Started`    | 확장 프로그램 안내 또는 사이드바 대체 화면을 엽니다.       |

## 타입 및 유효성 검사 명령

| 명령                                      | 결과                                 |
| --------------------------------------- | ---------------------------------- |
| `Generate TypeScript Types for .lottie` | 파일 하나에서 상태 머신 ID와 마커 이름 타입을 생성합니다. |
| `Generate All Lottie Types (Workspace)` | 워크스페이스 전체에서 지원되는 타입을 생성합니다.        |
| `Validate Lottie File`                  | 선택한 Lottie 파일의 유효성을 검사합니다.         |
| `Bundle as .lottie`                     | 지원되는 애니메이션을 `.lottie`로 묶습니다.       |
| `Generate .relottierc.json`             | relottie 설정을 만듭니다.                 |
| `Copy GitHub Actions Workflow`          | 유효성 검사 워크플로 템플릿을 복사합니다.            |
| `Copy Vite Config Snippet`              | Vite 연동 코드 조각을 복사합니다.              |
| `Setup Pre-commit Hook`                 | 지원되는 유효성 검사 훅 설정을 추가합니다.           |
| `Run Validation (relottie)`             | 설정된 relottie 유효성 검사를 실행합니다.        |

생성된 파일은 커밋하기 전에 확인하세요. 현재 타입 생성은 상태 머신 ID와 마커 이름을 지원하며 테마나 세그먼트 타입은 만들지 않습니다.

## 미리 보기 및 호버 설정

| 설정                                     | 용도                                                      |
| -------------------------------------- | ------------------------------------------------------- |
| `lottiefiles.directPreviewJson`        | 인식된 Lottie JSON을 자동으로 미리 볼지, 명시적으로 실행할지 정합니다.           |
| `lottiefiles.hover.enabled`            | 소스 코드의 `.lottie` 경로에 마우스를 올렸을 때 메타데이터를 표시합니다.           |
| `lottiefiles.snippet.defaultFramework` | 기본 프레임워크를 React, Vue, Angular, Svelte 또는 Vanilla로 정합니다. |
| `lottiefiles.snippet.autoplay`         | 생성 코드의 기본 자동 재생 동작을 정합니다.                               |
| `lottiefiles.snippet.loop`             | 생성 코드의 기본 반복 재생 동작을 정합니다.                               |
| `lottiefiles.snippet.speed`            | 생성 코드의 기본 재생 속도를 정합니다.                                  |
| `lottiefiles.snippet.renderer`         | 생성할 코드에 사용할 SVG 또는 ThorVG 렌더러를 선택합니다.                   |

## 유효성 검사 설정

| 설정                                            | 용도                                       |
| --------------------------------------------- | ---------------------------------------- |
| `lottiefiles.validateOnSave`                  | `.lottie` 파일을 저장할 때 유효성을 검사합니다.          |
| `lottiefiles.validateOnSave.skipAboveKb`      | 설정한 용량보다 큰 파일은 저장 시 검사를 건너뜁니다.           |
| `lottiefiles.typeGen.warnAboveSizeKb`         | 큰 파일에서 타입을 생성하기 전에 경고합니다.                |
| `lottiefiles.validation.maxFileSizeKb`        | relottie 파일 용량 규칙을 설정합니다.                |
| `lottiefiles.validation.requireAutoplayFalse` | 생성되는 접근성 규칙을 설정합니다.                      |
| `lottiefiles.validation.requireSlots`         | 생성되는 슬롯 규칙을 설정합니다.                       |
| `lottiefiles.validation.jsonGlob`             | 워크스페이스 검사에 포함할 JSON 파일을 선택합니다.           |
| `lottiefiles.schemaValidation.enabled`        | 저장할 때 공식 Lottie JSON Schema로 유효성을 검사합니다. |
| `lottiefiles.schemaValidation.severity`       | 스키마 문제를 오류, 경고 또는 힌트로 표시합니다.             |
| `lottiefiles.liveValidation.enabled`          | Lottie JSON 편집 중 실시간 진단을 표시합니다.          |
| `lottiefiles.statusBar.enabled`               | 워크스페이스 유효성 검사 요약을 표시합니다.                 |

에디터 설정과 생성된 설정 파일은 적용 범위가 다를 수 있습니다. CI에서 실제로 실행할 규칙은 생성된 `.relottierc.json`을 직접 확인하세요.

## 관련 문서

- [애니메이션 유효성 검사 및 타입 생성](/ko/integrations/vscode/05_integrate/validating-animations-and-generating-types)
- [IDE 호환성 및 문제 해결](/ko/integrations/vscode/07_reference/ide-compatibility-and-troubleshooting)