wip

Author: lumirlumir

src/content/reference/react-compiler/compiling-libraries.md

@@ -1,30 +1,30 @@
 ---
-title: Compiling Libraries
+title: 라이브러리 컴파일
 ---
 
 <Intro>
-This guide helps library authors understand how to use React Compiler to ship optimized library code to their users.
+이 가이드는 라이브러리 작성자가 React 컴파일러를 사용하여 최적화된 라이브러리 코드를 사용자에게 제공하는 방법을 설명합니다.
 </Intro>
 
 <InlineToc />
 
-## Why Ship Compiled Code? {/*why-ship-compiled-code*/}
+## 컴파일된 코드를 배포해야 하는 이유 {/*why-ship-compiled-code*/}
 
-As a library author, you can compile your library code before publishing to npm. This provides several benefits:
+라이브러리 작성자는 npm에 배포하기 전에 라이브러리 코드를 컴파일할 수 있습니다. 이는 여러 가지 이점을 제공합니다.
 
-- **Performance improvements for all users** - Your library users get optimized code even if they aren't using React Compiler yet
-- **No configuration required by users** - The optimizations work out of the box
-- **Consistent behavior** - All users get the same optimized version regardless of their build setup
+- **모든 사용자를 위한 성능 향상** - 라이브러리 사용자가 아직 React 컴파일러를 사용하지 않더라도 최적화된 코드를 얻습니다.
+- **사용자에게 설정이 필요 없음** - 최적화가 바로 작동합니다.
+- **일관된 동작** - 모든 사용자가 빌드 설정에 관계없이 동일한 최적화된 버전을 얻습니다.
 
-## Setting Up Compilation {/*setting-up-compilation*/}
+## 컴파일 설정하기 {/*setting-up-compilation*/}
 
-Add React Compiler to your library's build process:
+라이브러리의 빌드 프로세스에 React 컴파일러를 추가하세요.
 
 <TerminalBlock>
 npm install -D babel-plugin-react-compiler@latest
 </TerminalBlock>
 
-Configure your build tool to compile your library. For example, with Babel:
+라이브러리를 컴파일하도록 빌드 도구를 설정하세요. Babel을 사용하는 예시입니다.
 
 ```js
 // babel.config.js
@@ -36,13 +36,13 @@ module.exports = {
 };
 ```
 
-## Backwards Compatibility {/*backwards-compatibility*/}
+## 하위 호환성 {/*backwards-compatibility*/}
 
-If your library supports React versions below 19, you'll need additional configuration:
+라이브러리가 React 19 미만 버전을 지원하는 경우 추가 설정이 필요합니다.
 
-### 1. Install the runtime package {/*install-runtime-package*/}
+### 1. 런타임 패키지 설치하기 {/*install-runtime-package*/}
 
-We recommend installing react-compiler-runtime as a direct dependency:
+`react-compiler-runtime`을 직접 의존성<sup>`dependencies`</sup>으로 설치하는 것을 권장합니다.
 
 <TerminalBlock>
 npm install react-compiler-runtime@latest
@@ -59,48 +59,48 @@ npm install react-compiler-runtime@latest
 }
 ```
 
-### 2. Configure the target version {/*configure-target-version*/}
+### 2. `target` 버전 설정하기 {/*configure-target-version*/}
 
-Set the minimum React version your library supports:
+라이브러리가 지원하는 최소 React 버전을 설정하세요.
 
 ```js
 {
-  target: '17', // Minimum supported React version
+  target: '17', // 지원하는 최소 React 버전
 }
 ```
 
-## Testing Strategy {/*testing-strategy*/}
+## 테스트 전략 {/*testing-strategy*/}
 
-Test your library both with and without compilation to ensure compatibility. Run your existing test suite against the compiled code, and also create a separate test configuration that bypasses the compiler. This helps catch any issues that might arise from the compilation process and ensures your library works correctly in all scenarios.
+호환성을 보장하기 위해 컴파일 유무에 관계없이 라이브러리를 테스트하세요. 컴파일된 코드에 대해 기존 테스트를 실행하고 컴파일러를 우회하는 별도의 테스트 설정도 만드세요. 이렇게 하면 컴파일 과정에서 발생할 수 있는 문제를 발견하고 모든 시나리오에서 라이브러리가 올바르게 작동하는지 확인할 수 있습니다.
 
-## Troubleshooting {/*troubleshooting*/}
+## 문제 해결 {/*troubleshooting*/}
 
-### Library doesn't work with older React versions {/*library-doesnt-work-with-older-react-versions*/}
+### 라이브러리가 이전 React 버전에서 작동하지 않는 경우 {/*library-doesnt-work-with-older-react-versions*/}
 
-If your compiled library throws errors in React 17 or 18:
+컴파일된 라이브러리가 React 17 또는 18에서 오류를 발생시키는 경우입니다.
 
-1. Verify you've installed `react-compiler-runtime` as a dependency
-2. Check that your `target` configuration matches your minimum supported React version
-3. Ensure the runtime package is included in your published bundle
+1. `react-compiler-runtime`이 의존성으로 설치되어 있는지 확인하세요.
+2. `target` 설정이 지원하는 최소 React 버전과 일치하는지 확인하세요.
+3. 런타임 패키지가 배포된 번들에 포함되어 있는지 확인하세요.
 
-### Compilation conflicts with other Babel plugins {/*compilation-conflicts-with-other-babel-plugins*/}
+### 다른 Babel 플러그인과의 컴파일 충돌 {/*compilation-conflicts-with-other-babel-plugins*/}
 
-Some Babel plugins may conflict with React Compiler:
+일부 Babel 플러그인은 React 컴파일러와 충돌할 수 있습니다.
 
-1. Place `babel-plugin-react-compiler` early in your plugin list
-2. Disable conflicting optimizations in other plugins
-3. Test your build output thoroughly
+1. `babel-plugin-react-compiler`를 플러그인 목록의 앞쪽에 배치하세요.
+2. 다른 플러그인에서 충돌하는 최적화를 비활성화하세요.
+3. 빌드 출력을 철저히 테스트하세요.
 
-### Runtime module not found {/*runtime-module-not-found*/}
+### 런타임 모듈을 찾을 수 없는 경우 {/*runtime-module-not-found*/}
 
-If users see "Cannot find module 'react-compiler-runtime'":
+사용자가 "Cannot find module 'react-compiler-runtime'" 오류를 보는 경우입니다.
 
-1. Ensure the runtime is listed in `dependencies`, not `devDependencies`
-2. Check that your bundler includes the runtime in the output
-3. Verify the package is published to npm with your library
+1. 런타임이 `devDependencies`가 아닌 `dependencies`에 나열되어 있는지 확인하세요.
+2. 번들러가 출력에 런타임을 포함하는지 확인하세요.
+3. 패키지가 라이브러리와 함께 npm에 배포되었는지 확인하세요.
 
-## Next Steps {/*next-steps*/}
+## 다음 단계 {/*next-steps*/}
 
-- Learn about [debugging techniques](/learn/react-compiler/debugging) for compiled code
-- Check the [configuration options](/reference/react-compiler/configuration) for all compiler options
-- Explore [compilation modes](/reference/react-compiler/compilationMode) for selective optimization
+- 컴파일된 코드를 위한 [디버깅 기법](/learn/react-compiler/debugging)에 대해 알아보세요.
+- 모든 컴파일러 옵션을 위한 [설정 옵션](/reference/react-compiler/configuration)을 확인하세요.
+- 선택적 최적화를 위한 [컴파일 모드](/reference/react-compiler/compilationMode)를 살펴보세요.

src/content/reference/react/index.md

@@ -35,7 +35,7 @@ The React Compiler is a build-time optimization tool that automatically memoizes
 
 * [Configuration](/reference/react-compiler/configuration) - Configuration options for React Compiler.
 * [Directives](/reference/react-compiler/directives) - Function-level directives to control compilation.
-* [Compiling Libraries](/reference/react-compiler/compiling-libraries) - Guide for shipping pre-compiled library code.
+* [라이브러리 컴파일](/reference/react-compiler/compiling-libraries) - Guide for shipping pre-compiled library code.
 
 ## ESLint Plugin React Hooks {/*eslint-plugin-react-hooks*/}
 

src/sidebarReference.json

@@ -393,7 +393,7 @@
       ]
     },
     {
-      "title": "Compiling Libraries",
+      "title": "라이브러리 컴파일",
       "path": "/reference/react-compiler/compiling-libraries"
     },
     {