초벌 번역 진행

Author: narusas

ko-KR/src/api/component-instance.md

@@ -6,7 +6,7 @@
 이 페이지에 나열된 모든 속성은 읽기 전용입니다(`$data`의 중첩 속성 제외).
 :::
 
-## $data
+## $data {#data}
 
 [`data`](./options-state.html#data) 옵션에서 반환된 객체로 컴포넌트에 의해 반응형이 됩니다.
 컴포넌트 인스턴스는 데이터 객체의 속성 접근을 프락시합니다.
@@ -22,7 +22,7 @@
   }
   ```
 
-## $props
+## $props {#props}
 
 현재 컴포넌트의 처리(선언, 할당 및 초기화)된 props를 나타내는 객체입니다.
 
@@ -39,7 +39,7 @@
   [`props`](./options-state.html#props) 옵션을 통해 선언된 props만 포함됩니다.
   컴포넌트 인스턴스는 props 객체의 속성 접근을 프락시합니다.
 
-## $el
+## $el {#el}
 
 컴포넌트 인스턴스가 관리하는 루트 DOM 노드입니다.
 
@@ -67,7 +67,7 @@
   `$el`보다 [템플릿 참조](/guide/essentials/template-refs.html)를 사용하는 것이 권장됩니다.
   :::
 
-## $options
+## $options {#options}
 
 현재 컴포넌트 인스턴스를 인스턴스화하는 데 사용된, 처리된 컴포넌트 옵션입니다.
 
@@ -101,7 +101,7 @@
 
 - **참고**: [`app.config.optionMergeStrategies`](/api/application.html#app-config-optionmergestrategies)
 
-## $parent
+## $parent {#parent}
 
 현재 인스턴스에 부모 인스턴스가 있는 경우,
 부모 인스턴스를 나타냅니다.
@@ -115,7 +115,7 @@
   }
   ```
 
-## $root
+## $root {#root}
 
 현재 컴포넌트 트리의 루트 컴포넌트 인스턴스입니다.
 현재 인스턴스에 부모가 없으면, 값은 현재 인스턴스 자체가 됩니다.
@@ -128,7 +128,7 @@
   }
   ```
 
-## $slots
+## $slots {#slots}
 
 부모 컴포넌트로부터 전달된 [slots](/guide/components/slots.html)을 나타내는 객체입니다.
 
@@ -156,7 +156,7 @@
 
 - **참고**: [Render Functions - Rendering Slots](/guide/extras/render-function.html#rendering-slots)
 
-## $refs
+## $refs {#refs}
 
 [템플릿 참조](/guide/essentials/template-refs.html)를 통해 등록된,
 DOM 엘리먼트 및 컴포넌트 인스턴스 객체입니다.
@@ -174,7 +174,7 @@ DOM 엘리먼트 및 컴포넌트 인스턴스 객체입니다.
   - [가이드 - 템플릿 참조](/guide/essentials/template-refs.html)
   - [특수 속성 - ref](./built-in-special-attributes.md#ref)
 
-## $attrs
+## $attrs {#attrs}
 
 컴포넌트의 폴스루 속성이 포함된 객체입니다.
 
@@ -200,7 +200,7 @@ DOM 엘리먼트 및 컴포넌트 인스턴스 객체입니다.
 
   - [가이드 - 폴스루 속성](/guide/components/attrs.html)
 
-## $watch()
+## $watch() {#watch}
 
 감시자를 생성하기 위한 명령형 API.
 
@@ -244,7 +244,7 @@ DOM 엘리먼트 및 컴포넌트 인스턴스 객체입니다.
   - **`deep`**: 소스가 객체인 경우, 깊은 변경사항에서도 콜백이 실행되도록 합니다.
     참고: [깊은 감시자](/guide/essentials/watchers.html#deep-watchers).
   - **`flush`**: 콜백의 발생(flush) 타이밍을 조정합니다.
-    참고: [콜백 실행 타이밍](/guide/essentials/watchers.html#callback-flush-timing).
+    참고: [콜백 실행 타이밍](/guide/essentials/watchers.html#callback-flush-timing),  [`watchEffect()`](/api/reactivity-core.html#watcheffect).
   - **`onTrack / onTrigger`**: 감시자의 의존성을 디버그합니다.
     참고: [감시자 디버깅](/guide/extras/reactivity-in-depth.html#watcher-debugging).
 
@@ -288,7 +288,7 @@ DOM 엘리먼트 및 컴포넌트 인스턴스 객체입니다.
   - [옵션 - `watch`](/api/options-state.html#watch)
   - [가이드 - 감시자](/guide/essentials/watchers.html)
 
-## $emit()
+## $emit() {#emit}
 
 현재 인스턴스에서 커스텀 이벤트를 트리거합니다.
 추가적인 인자는 리스너의 콜백 함수로 전달됩니다.
@@ -319,7 +319,7 @@ DOM 엘리먼트 및 컴포넌트 인스턴스 객체입니다.
   - [가이드 - 컴포넌트 이벤트](/guide/components/events.html)
   - [옵션 - `emits`](./options-state.html#emits)
 
-## $forceUpdate()
+## $forceUpdate() {#forceupdate}
 
 컴포넌트 인스턴스를 강제로 다시 렌더링합니다.
 
@@ -338,7 +338,7 @@ DOM 엘리먼트 및 컴포넌트 인스턴스 객체입니다.
   필요할 수 있는 유일한 경우는 고급 반응형 API를 사용하여,
   비반응형 컴포넌트 상태를 명시적으로 생성하는 경우입니다.
 
-## $nextTick()
+## $nextTick() {#nexttick}
 
 전역 [`nextTick()`](./general.html#nexttick)가 인스턴스에 바인딩된 버전.
 

ko-KR/src/api/composition-api-dependency-injection.md

@@ -1,6 +1,6 @@
 # 컴포지션 API: <br>의존성 주입 {#composition-api-dependency-injection}
 
-## provide()
+## provide()  {#provide}
 
 하위 컴포넌트에 주입(Inject)할 수 있도록 값을 제공(Provide)합니다.
 
@@ -40,9 +40,9 @@
 
 - **참고**:
   - [가이드 - Provide/Inject](/guide/components/provide-inject.html)
-  - [가이드 - Provide/Inject에 타입 지정하기](/guide/typescript/composition-api.html#typing-provide-inject)
+  - [가이드 - Provide/Inject에 타입 지정하기](/guide/typescript/composition-api.html#typing-provide-inject) <sup class="vt-badge ts" />
 
-## inject()
+## inject() {#inject}
 
 상위 컴포넌트 또는 [`app.provide()`](/api/application.html#app-provide)를 통해 앱에서 제공(Provide)된 값을 주입(Inject)합니다.
 
@@ -128,4 +128,4 @@
 
 - **참고**:
   - [가이드 - Provide/Inject](/guide/components/provide-inject.html)
-  - [가이드 - Provide/Inject에 타입 지정하기](/guide/typescript/composition-api.html#typing-provide-inject)
+  - [가이드 - Provide/Inject에 타입 지정하기](/guide/typescript/composition-api.html#typing-provide-inject) <sup class="vt-badge ts" />

ko-KR/src/api/composition-api-lifecycle.md

@@ -5,7 +5,7 @@
 자세한 내용은 [가이드 - 수명주기 훅](/guide/essentials/lifecycle.html)을 참고하세요.
 :::
 
-## onMounted()
+## onMounted() {#onmounted}
 
 컴포넌트가 마운트된 후 호출될 콜백을 등록합니다.
 
@@ -49,7 +49,7 @@
   </template>
   ```
 
-## onUpdated()
+## onUpdated() {#onupdated}
 
 반응형 상태 변경으로 컴포넌트의 DOM 트리가 업데이트된 후 호출될 콜백을 등록합니다.
 
@@ -94,7 +94,7 @@
   </template>
   ```
 
-## onUnmounted()
+## onUnmounted() {#onunmounted}
 
 컴포넌트가 마운트 해제된 후 호출될 콜백을 등록합니다.
 
@@ -133,7 +133,7 @@
   </script>
   ```
 
-## onBeforeMount()
+## onBeforeMount() {#onbeforeupdate}
 
 컴포넌트가 마운트되기 직전에 호출될 훅을 등록합니다.
 
@@ -150,7 +150,7 @@
 
   **이 훅은 서버 사이드 렌더링 중에 호출되지 않습니다**.
 
-## onBeforeUpdate()
+## onBeforeUpdate() {#onbeforeupdate}
 
 반응형 상태 변경으로 컴포넌트의 DOM 트리를 업데이트하기 직전에 호출될 콜백을 등록합니다.
 
@@ -167,7 +167,7 @@
 
   **이 훅은 서버 사이드 렌더링 중에 호출되지 않습니다**.
 
-## onBeforeUnmount()
+## onBeforeUnmount() {#onbeforeunmount}
 
 컴포넌트 인스턴스가 마운트 해제되기 직전에 호출될 콜백을 등록합니다.
 
@@ -183,7 +183,7 @@
 
   **이 훅은 서버 사이드 렌더링 중에 호출되지 않습니다**.
 
-## onErrorCaptured()
+## onErrorCaptured() {#onerrorcaptured}
 
 자식 컴포넌트에서 전파된 에러가 캡쳐되었을 때 호출될 콜백을 등록합니다.
 
@@ -226,8 +226,7 @@
     [`app.config.errorHandler`](/api/application.html#app-config-errorhandler)가 정의된 경우,
     최종적으로 이곳으로 전파되므로 한 곳에서 서비스 분석 및 보고 작업을 할 수 있습니다.
 
-  - 컴포넌트의 상속 또는 부모 체인에 `errorCaptured` 훅이 여러 개 있는 경우,
-    모두 동일한 에러를 호출합니다.
+  - 컴포넌트의 상속 체인 또는 부모 체인에 여러 개의 `errorCaptured` 후크가 존재하는 경우, 모든 후크는 동일한 오류에 대해 아래에서 위로 순서대로 호출됩니다. 이는 네이티브 DOM 이벤트의 버블링 메커니즘과 유사합니다.
 
   - `errorCaptured` 훅 자체에서 에러가 발생하면,
     이 에러와 원래 캡처된 에러가 모두 `app.config.errorHandler`로 전송됩니다.
@@ -236,7 +235,7 @@
     이것은 본질적으로 "이 에러는 처리되었으므로 무시되어야 합니다."를 의미합니다.
     따라서 이후 단계적으로 전파되어야 할 `errorCaptured` 훅 또는 `app.config.errorHandler`에 이 에러로 인한 호출 동작은 없습니다.
 
-## onRenderTracked() <sup class="vt-badge dev-only" />
+## onRenderTracked() <sup class="vt-badge dev-only" /> {#onrendertracked}
 
 컴포넌트의 렌더 이펙트에 의해 반응형 의존성이 추적됐을 때, 호출될 디버그 콜백을 등록합니다.
 
@@ -259,7 +258,7 @@
 
 - **참고**: [반응형 심화](/guide/extras/reactivity-in-depth.html)
 
-## onRenderTriggered() <sup class="vt-badge dev-only" />
+## onRenderTriggered() <sup class="vt-badge dev-only" /> {#onrendertriggered}
 
 컴포넌트의 렌더 이펙트가 반응형 의존성에 의해 다시 실행되도록 트리거된 경우, 호출될 디버그 콜백을 등록합니다.
 
@@ -285,7 +284,7 @@
 
 - **참고**: [반응형 심화](/guide/extras/reactivity-in-depth.html)
 
-## onActivated()
+## onActivated() {#onactivated}
 
 [`<KeepAlive>`](/api/built-in-components.html#keepalive)로 캐시된 컴포넌트 인스턴스가 DOM 트리의 일부로 삽입된 후 호출될 콜백을 등록합니다.
 
@@ -299,7 +298,7 @@
 
 - **참고**: [가이드 - 캐시된 인스턴스의 수명 주기](/guide/built-ins/keep-alive.html#lifecycle-of-cached-instance)
 
-## onDeactivated()
+## onDeactivated()  {#ondeactivated}
 
 [`<KeepAlive>`](/api/built-in-components.html#keepalive)로 캐시된 컴포넌트 인스턴스가 DOM 트리에서 제거된 후 호출될 콜백을 등록합니다.
 
@@ -313,7 +312,7 @@
 
 - **참고**: [가이드 - 캐시된 인스턴스의 수명 주기](/guide/built-ins/keep-alive.html#lifecycle-of-cached-instance)
 
-## onServerPrefetch() <sup class="vt-badge" data-text="SSR 전용" />
+## onServerPrefetch() <sup class="vt-badge" data-text="SSR 전용" /> {#onserverprefetch}
 
 컴포넌트 인스턴스가 서버에서 렌더링 되기 전에 완료(resolve)되어야 하는 비동기 함수를 등록합니다.
 

ko-KR/src/api/composition-api-setup.md

@@ -45,11 +45,7 @@ export default {
 [자동으로 얕은 언래핑](/guide/essentials/reactivity-fundamentals.html#deep-reactivity)되므로, 접근할 때 `.value`를 사용할 필요가 없습니다.
 또한 `this`에서 접근할 때, 같은 방식으로 언래핑 됩니다.
 
-:::tip
-`setup()` 자체에는 컴포넌트 인스턴스에 대한 접근 권한이 없습니다.
-`setup()` 내부에서 `this`의 값은 `undefined`입니다.
-Composition API에서 노출한 값은 Options API에서 접근할 수 있지만, 그 반대는 불가능합니다.
-:::
+`setup()`은 객체를 _동기적으로_ 반환해야 합니다. `async setup()`을 사용할 수 있는 유일한 경우는 컴포넌트가 [Suspense](../guide/built-in/suspense.html) 컴포넌트의 자손인 경우입니다.
 
 ## Props에 접근하기 {#accessing-props}
 
@@ -89,7 +85,7 @@ export default {
 }
 ```
 
-## Setup Context
+## Setup Context {#setup-context}
 
 `setup` 함수에 전달되는 두 번째 인자는 **Setup Context** 객체입니다.
 컨텍스트 객체는 `setup` 내부에서 유용할 수 있는 다른 값을 노출합니다:

ko-KR/src/api/custom-renderer.md

@@ -1,9 +1,12 @@
 :::warning 현재 이 문서는 번역 작업이 진행중입니다
 :::
 
-# Custom Renderer API
+# 사용자 정의 렌더러 API {#custom-renderer-api}
 
-## createRenderer()
+
+## createRenderer() {#createrenderer}
+
+사용자 정의 렌더러를 생성합니다. 플랫폼별 노드 생성 및 조작 API를 제공함으로써 Vue의 핵심 런타임을 활용하여 비 DOM 환경을 타겟팅할 수 있습니다.
 
 Creates a custom renderer. By providing platform-specific node creation and manipulation APIs, you can leverage Vue's core runtime to target non-DOM environments.
 
@@ -25,7 +28,7 @@ Creates a custom renderer. By providing platform-specific node creation and mani
       key: string,
       prevValue: any,
       nextValue: any,
-      // the rest is unused for most custom renderers
+      // 나머지는 대부분의 커스텀 렌더러에 사용되지 않습니다.
       isSVG?: boolean,
       prevChildren?: VNode<HostNode, HostElement>[],
       parentComponent?: ComponentInternalInstance | null,
@@ -77,12 +80,13 @@ Creates a custom renderer. By providing platform-specific node creation and mani
     // ...
   })
 
-  // `render` is the low-level API
-  // `createApp` returns an app instance
+  // `render`는 로우레벨 API입니다.
+  // `createApp`은 앱 인스턴스를 반환합니다.
   export { render, createApp }
 
   // re-export Vue core APIs
   export * from '@vue/runtime-core'
   ```
-
+  Vue의 자체 `@vue/runtime-dom`은 [동일한 API를 사용하여 구현](https://github.com/vuejs/core/blob/main/packages/runtime-dom/src/index.ts)됩니다. 더 간단한 구현을 원한다면, Vue의 자체 단위 테스트를 위한 비공개 패키지인 [`@vue/runtime-test`](https://github.com/vuejs/core/blob/main/packages/runtime-test/src/index.ts)를 확인하세요.
+  
   Vue's own `@vue/runtime-dom` is [implemented using the same API](https://github.com/vuejs/core/blob/main/packages/runtime-dom/src/index.ts). For a simpler implementation, check out [`@vue/runtime-test`](https://github.com/vuejs/core/blob/main/packages/runtime-test/src/index.ts) which is a private package for Vue's own unit testing.