From cb49ab9b9fbd2fb9af742da7024c135dda6fd50e Mon Sep 17 00:00:00 2001
From: Peter Cross <itextx@gmail.com>
Date: Mon, 30 Sep 2024 21:38:31 +0300
Subject: [PATCH 1/3] Translating whole composition-api-helpers.md and only
 available/only supported fragments allover documentation

---
 src/api/built-in-directives.md                |  2 +-
 src/api/compile-time-flags.md                 |  2 +-
 .../composition-api-dependency-injection.md   |  2 +-
 src/api/composition-api-helpers.md            | 52 +++++++++----------
 src/guide/essentials/computed.md              |  2 +-
 src/guide/essentials/template-syntax.md       |  2 +-
 src/guide/essentials/watchers.md              |  2 +-
 7 files changed, 32 insertions(+), 32 deletions(-)

diff --git a/src/api/built-in-directives.md b/src/api/built-in-directives.md
index 2a78a0b0..fca07315 100644
--- a/src/api/built-in-directives.md
+++ b/src/api/built-in-directives.md
@@ -472,7 +472,7 @@
 
 ## v-memo {#v-memo}
 
-- Only supported in 3.2+
+- Поддерживается только в версиях 3.2+
 
 - **Ожидает:** `any[]`
 
diff --git a/src/api/compile-time-flags.md b/src/api/compile-time-flags.md
index 834badb7..970314f0 100644
--- a/src/api/compile-time-flags.md
+++ b/src/api/compile-time-flags.md
@@ -32,7 +32,7 @@ Vue будет работать, даже если эти флаги не буд
 
   Включить / выключить подробные предупреждения о несоответствии гидрации в продакшн сборках. Это приведет к увеличению количества кода, включаемого в пакет, поэтому рекомендуется включать эту функцию только для целей отладки.
 
-- Only available in 3.4+
+- Доступно только в версиях 3.4+
 
 ## Руководства по настройке {#configuration-guides}
 
diff --git a/src/api/composition-api-dependency-injection.md b/src/api/composition-api-dependency-injection.md
index f3b5cc98..ef751400 100644
--- a/src/api/composition-api-dependency-injection.md
+++ b/src/api/composition-api-dependency-injection.md
@@ -109,7 +109,7 @@
 
 ## hasInjectionContext() {#has-injection-context}
 
-- Only supported in 3.3+
+- Поддерживается только в версиях 3.3+
 
 Возвращает `true`, если [inject()](#inject) можно использовать без предупреждения о вызове в неправильном месте (например, вне `setup()`). Этот метод предназначен для библиотек, которые хотят использовать `inject()` внутри себя без предупреждения для конечного пользователя.
 
diff --git a/src/api/composition-api-helpers.md b/src/api/composition-api-helpers.md
index 47ba1afc..d6cc5fba 100644
--- a/src/api/composition-api-helpers.md
+++ b/src/api/composition-api-helpers.md
@@ -1,10 +1,10 @@
-# Composition API: Helpers {#composition-api-helpers}
+# Composition API: Хэлперы {#composition-api-helpers}
 
 ## useAttrs() {#useattrs}
 
-Returns the `attrs` object from the [Setup Context](/api/composition-api-setup#setup-context), which includes the [fallthrough attributes](/guide/components/attrs#fallthrough-attributes) of the current component. This is intended to be used in `<script setup>` where the setup context object is not available.
+Возвращает из [Setup контекста](/api/composition-api-setup#setup-context) объект `attrs`, который включает в себя [обычные атрибуты](/guide/components/attrs#fallthrough-attributes) переданные текущему компоненту. Это предназначено для использования в `<script setup>`, где объект Setup контекст недоступен.
 
-- **Type**
+- **Тип**
 
   ```ts
   function useAttrs(): Record<string, unknown>
@@ -12,11 +12,11 @@ Returns the `attrs` object from the [Setup Context](/api/composition-api-setup#s
 
 ## useSlots() {#useslots}
 
-Returns the `slots` object from the [Setup Context](/api/composition-api-setup#setup-context), which includes parent passed slots as callable functions that return Virtual DOM nodes. This is intended to be used in `<script setup>` where the setup context object is not available.
+Возвращает из [Setup контекста](/api/composition-api-setup#setup-context) объект `slots`, включаещий переданные родителю слоты в виде вызываемых функции, возвращающих виртуальные узлы DOM. Это предназначено для использования в `<script setup>`, где объект Setup контекст недоступен.
 
-If using TypeScript, [`defineSlots()`](/api/sfc-script-setup#defineslots) should be preferred instead.
+При использовании TypeScript, вместо этого следует использовать [`defineSlots()`](/api/sfc-script-setup#defineslots).
 
-- **Type**
+- **Тип**
 
   ```ts
   function useSlots(): Record<string, (...args: any[]) => VNode[]>
@@ -24,11 +24,11 @@ If using TypeScript, [`defineSlots()`](/api/sfc-script-setup#defineslots) should
 
 ## useModel() {#usemodel}
 
-This is the underlying helper that powers [`defineModel()`](/api/sfc-script-setup#definemodel). If using `<script setup>`, `defineModel()` should be preferred instead.
+Это базовый хэлпер, который обеспечивает работу [`defineModel()`](/api/sfc-script-setup#definemodel). Если вы используете `<script setup>`, вместо него следует предпочесть `defineModel()`.
 
-- Only available in 3.4+
+- Доступно только в версиях 3.4+
 
-- **Type**
+- **Тип**
 
   ```ts
   function useModel(
@@ -48,7 +48,7 @@ This is the underlying helper that powers [`defineModel()`](/api/sfc-script-setu
 ]
   ```
 
-- **Example**
+- **Пример**
 
   ```js
   export default {
@@ -61,21 +61,21 @@ This is the underlying helper that powers [`defineModel()`](/api/sfc-script-setu
   }
   ```
 
-- **Details**
+- **Подробности**
 
-  `useModel()` can be used in non-SFC components, e.g. when using raw `setup()` function. It expects the `props` object as the first argument, and the model name as the second argument. The optional third argument can be used to declare custom getter and setter for the resulting model ref. Note that unlike `defineModel()`, you are responsible for declaring the props and emits yourself.
+  `useModel()` может использоваться в компонентах, не относящихся к SFC, например, при использовании необработанной функции `setup()`. В качестве первого аргумента она принимает объект `props`, а в качестве второго - имя модели. Необязательный третий аргумент может быть использован для объявления пользовательских геттеров и сеттеров для получившейся ref модели. Обратите внимание, что в отличие от `defineModel()`, вы сами должны объявить входные параметры(`props`) и эмиттеры.
 
 ## useTemplateRef() <sup class="vt-badge" data-text="3.5+" /> {#usetemplateref}
 
-Returns a shallow ref whose value will be synced with the template element or component with a matching ref attribute.
+Возвращает неглубокую ref ссылку, значение которой будет синхронизировано с  `<tempalate>` элементом или компонентом с соответствующим атрибутом ref.
 
-- **Type**
+- **Тип**
 
   ```ts
   function useTemplateRef<T>(key: string): Readonly<ShallowRef<T | null>>
   ```
 
-- **Example**
+- **Пример**
 
   ```vue
   <script setup>
@@ -93,22 +93,22 @@ Returns a shallow ref whose value will be synced with the template element or co
   </template>
   ```
 
-- **See also**
-  - [Guide - Template Refs](/guide/essentials/template-refs)
-  - [Guide - Typing Template Refs](/guide/typescript/composition-api#typing-template-refs) <sup class="vt-badge ts" />
-  - [Guide - Typing Component Template Refs](/guide/typescript/composition-api#typing-component-template-refs) <sup class="vt-badge ts" />
+- **См. также**
+  - [Руководство - Ссылки на элементы шаблона](/guide/essentials/template-refs)
+  - [Руководство - Типизация ссылок на шаблоны](/guide/typescript/composition-api#typing-template-refs) <sup class="vt-badge ts" />
+  - [Руководство - Типизация ссылок на шаблоны компонентов](/guide/typescript/composition-api#typing-component-template-refs) <sup class="vt-badge ts" />
 
 ## useId() <sup class="vt-badge" data-text="3.5+" /> {#useid}
 
-Used to generate unique-per-application IDs for accessibility attributes or form elements.
+Используется для генерации уникальных для каждого приложения идентификаторов для атрибутов доступности или элементов формы.
 
-- **Type**
+- **Тип**
 
   ```ts
   function useId(): string
   ```
 
-- **Example**
+- **Пример**
 
   ```vue
   <script setup>
@@ -125,10 +125,10 @@ Used to generate unique-per-application IDs for accessibility attributes or form
   </template>
   ```
 
-- **Details**
+- **Подробности**
 
-  IDs generated by `useId()` are unique-per-application. It can be used to generate IDs for form elements and accessibility attributes. Multiple calls in the same component will generate different IDs; multiple instances of the same component calling `useId()` will also have different IDs.
+  Идентификаторы, генерируемые с помощью `useId()`, уникальны для каждого приложения. Этот хэлпер можно использовать для генерации идентификаторов для элементов формы и атрибутов доступности. Несколько вызовов в одном и том же компоненте будут генерировать разные идентификаторы; несколько экземпляров одного и того же компонента, вызывающих `useId()`, также будут иметь разные идентификаторы.
 
-  IDs generated by `useId()` are also guaranteed to be stable across the server and client renders, so they can be used in SSR applications without leading to hydration mismatches.
+  Идентификаторы, сгенерированные с помощью `useId()`, также гарантированно стабильны и для серверного и для клиентского рендеринга, поэтому их использование в SSR приложениях не приведёт к несоответствию гидратации.
 
-  If you have more than one Vue application instance of the same page, you can avoid ID conflicts by giving each app an ID prefix via [`app.config.idPrefix`](/api/application#app-config-idprefix).
+  Если у вас есть несколько экземпляров Vue-приложения для одной и той же страницы, вы можете избежать конфликтов идентификаторов, задав каждому приложению свой ID-префикс через [`app.config.idPrefix`](/api/application#app-config-idprefix).
diff --git a/src/guide/essentials/computed.md b/src/guide/essentials/computed.md
index 9c1d8412..a915e8a1 100644
--- a/src/guide/essentials/computed.md
+++ b/src/guide/essentials/computed.md
@@ -263,7 +263,7 @@ const fullName = computed({
 
 ## Getting the previous value {#previous}
 
-- Only supported in 3.4+
+- Поддерживается только в версиях 3.4+
 
 In case you need it, you can get the previous value returned by the computed property accessing
 the first argument of the getter:
diff --git a/src/guide/essentials/template-syntax.md b/src/guide/essentials/template-syntax.md
index b9c6544c..3d08da6e 100644
--- a/src/guide/essentials/template-syntax.md
+++ b/src/guide/essentials/template-syntax.md
@@ -66,7 +66,7 @@ Vue использует синтаксис шаблонов, основанны
 
 ### Одноименное сокращение {#same-name-shorthand}
 
-- Only supported in 3.4+
+- Поддерживается только в версиях 3.4+
 
 Если атрибут имеет то же имя, что и связываемое значение JavaScript, синтаксис можно еще больше сократить, опустив значение атрибута:
 
diff --git a/src/guide/essentials/watchers.md b/src/guide/essentials/watchers.md
index a2254945..f90c8b8c 100644
--- a/src/guide/essentials/watchers.md
+++ b/src/guide/essentials/watchers.md
@@ -276,7 +276,7 @@ watch(
 
 ## Once Watchers {#once-watchers}
 
-- Only supported in 3.4+
+- Поддерживается только в версиях 3.4+
 
 Обратный вызов наблюдателя будет выполняться всякий раз, когда изменяется отслеживаемый источник. Если вы хотите, чтобы обратный вызов запускался только один раз при изменении источника, используйте параметр `once: true`.
 

From 641f32daa987a06ea6c39900b674d186e3f93c0c Mon Sep 17 00:00:00 2001
From: Bochkarev Ivan <ivanx86@gmail.com>
Date: Tue, 1 Oct 2024 00:55:27 +0600
Subject: [PATCH 2/3] Update src/api/composition-api-helpers.md

---
 src/api/composition-api-helpers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/composition-api-helpers.md b/src/api/composition-api-helpers.md
index d6cc5fba..8599c02a 100644
--- a/src/api/composition-api-helpers.md
+++ b/src/api/composition-api-helpers.md
@@ -67,7 +67,7 @@
 
 ## useTemplateRef() <sup class="vt-badge" data-text="3.5+" /> {#usetemplateref}
 
-Возвращает неглубокую ref ссылку, значение которой будет синхронизировано с  `<tempalate>` элементом или компонентом с соответствующим атрибутом ref.
+Возвращает неглубокую ref ссылку, значение которой будет синхронизировано с  `<template>` элементом или компонентом с соответствующим атрибутом ref.
 
 - **Тип**
 

From 7852c3737eacc6b21bc1c8772981f0bd6584cb33 Mon Sep 17 00:00:00 2001
From: Bochkarev Ivan <ivanx86@gmail.com>
Date: Tue, 1 Oct 2024 00:56:53 +0600
Subject: [PATCH 3/3] Apply suggestions from code review

---
 src/api/composition-api-helpers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/api/composition-api-helpers.md b/src/api/composition-api-helpers.md
index 8599c02a..894297d2 100644
--- a/src/api/composition-api-helpers.md
+++ b/src/api/composition-api-helpers.md
@@ -127,7 +127,7 @@
 
 - **Подробности**
 
-  Идентификаторы, генерируемые с помощью `useId()`, уникальны для каждого приложения. Этот хэлпер можно использовать для генерации идентификаторов для элементов формы и атрибутов доступности. Несколько вызовов в одном и том же компоненте будут генерировать разные идентификаторы; несколько экземпляров одного и того же компонента, вызывающих `useId()`, также будут иметь разные идентификаторы.
+  Идентификаторы, генерируемые с помощью `useId()`, уникальны для каждого приложения. Этот хэлпер можно использовать для генерации идентификаторов для элементов формы и атрибутов доступности. Несколько вызовов в одном и том же компоненте будут генерировать разные идентификаторы, несколько экземпляров одного и того же компонента, вызывающих `useId()`, также будут иметь разные идентификаторы.
 
   Идентификаторы, сгенерированные с помощью `useId()`, также гарантированно стабильны и для серверного и для клиентского рендеринга, поэтому их использование в SSR приложениях не приведёт к несоответствию гидратации.