@intlayer/docs 8.9.1 → 8.9.2

package/frequent_questions/ru/intlayerNode.md

@@ -0,0 +1,96 @@
+---
+createdAt: 2026-05-07
+updatedAt: 2026-05-07
+title: Тип IntlayerNode. Что это такое?
+description: Что такое тип IntlayerNode? Почему моя строка преобразуется в IntlayerNode<string>?
+keywords:
+  - Введение
+  - Начало работы
+  - Intlayer
+  - Приложение
+  - Пакеты
+slugs:
+  - frequent-questions
+  - intlayer-node
+history:
+  - version: 8.9.0
+    date: 2026-05-07
+    changes: "Инициализация документа"
+---
+
+# Что такое тип IntlayerNode?
+
+Тип `IntlayerNode<T>` — это специальный тип, предоставляемый пакетами intlayer, такими как `next-intlayer`, `react-intlayer`, `vue-intlayer`, `preact-intlayer`, `solid-intlayer`, `angular-intlayer`, `svelte-intlayer`, `lit-intlayer` и `vanilla-intlayer`.
+
+## Пример использования
+
+```tsx fileName="src/app.content.tsx" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+import type { ComponentChildren } from "preact";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: "Vite + Preact",
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```json fileName="src/app.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "app",
+  "content": {
+    "title": "Vite + Preact"
+  }
+}
+```
+
+<Tabs group="framework">
+  <Tab label="React / Next.js" value="react">
+
+```tsx fileName="src/App.tsx"
+import { useIntlayer } from "react-intlayer";
+
+const AppContent = () => {
+  const { title } = useIntlayer("app");
+
+  return title; // возвращает тип: IntlayerNode<string>
+};
+```
+
+  </Tab>
+
+// Todo добавить другие фреймворки в виде вкладок, как в docs/docs/ru/dictionary/markdown.md
+</Tabs>
+
+### Почему Intlayer вставляет IntlayerNode?
+
+Intlayer вставляет IntlayerNode, чтобы иметь возможность отображать селекторы визуального редактора в контексте CMS / визуального редактора.
+
+![Демо визуального редактора](https://raw.githubusercontent.com/aymericzip/intlayer/main/docs/assets/visual_editor.gif?raw=true)
+
+IntlayerNode — это расширенный узел React/Vue/Preact/Solid/Angular/Svelte/Lit/Vanilla, который также позволяет обращаться к свойствам базового примитивного узла.
+
+Например:
+
+```js
+const content = useIntlayer("app");
+
+// Случай со строкой
+content.title; // Возвращает IntlayerNode<string>
+content.title.value; // Возвращает базовое содержимое, в данном случае строку
+
+content.title.toString(); // Возвращает строку
+content.title.toLowerCase(); // Возвращает строку
+String(content.title); // Возвращает строку
+content.title.toUpperCase(); // Возвращает строку в верхнем регистре
+content.title.replace("a", "b"); // Возвращает измененную строку
+// ...
+```
+
+> Обращение к свойствам IntlayerNode будет работать, но нарушит возможность отображения селекторов в визуальном редакторе.
+
+> IntlayerNode также может оборачивать числа или другие типы, такие как `IntlayerNode<number>`.

package/frequent_questions/tr/intlayerNode.md

@@ -0,0 +1,96 @@
+---
+createdAt: 2026-05-07
+updatedAt: 2026-05-07
+title: IntlayerNode tipi. Nedir bu?
+description: IntlayerNode tipi nedir? Neden dizgim bir IntlayerNode<string> olarak dönüştürülüyor?
+keywords:
+  - Giriş
+  - Başlarken
+  - Intlayer
+  - Uygulama
+  - Paketler
+slugs:
+  - frequent-questions
+  - intlayer-node
+history:
+  - version: 8.9.0
+    date: 2026-05-07
+    changes: "Doküman başlatıldı"
+---
+
+# IntlayerNode tipi nedir?
+
+`IntlayerNode<T>` tipi, `next-intlayer`, `react-intlayer`, `vue-intlayer`, `preact-intlayer`, `solid-intlayer`, `angular-intlayer`, `svelte-intlayer`, `lit-intlayer` ve `vanilla-intlayer` gibi intlayer paketleri tarafından sağlanan özel bir tiptir.
+
+## Kullanım örneği
+
+```tsx fileName="src/app.content.tsx" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+import type { ComponentChildren } from "preact";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: "Vite + Preact",
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```json fileName="src/app.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "app",
+  "content": {
+    "title": "Vite + Preact"
+  }
+}
+```
+
+<Tabs group="framework">
+  <Tab label="React / Next.js" value="react">
+
+```tsx fileName="src/App.tsx"
+import { useIntlayer } from "react-intlayer";
+
+const AppContent = () => {
+  const { title } = useIntlayer("app");
+
+  return title; // şu tipi döndürür: IntlayerNode<string>
+};
+```
+
+  </Tab>
+
+// Todo Diğer framework'leri docs/docs/tr/dictionary/markdown.md'de olduğu gibi sekme olarak ekleyin
+</Tabs>
+
+### Intlayer neden bir IntlayerNode ekler?
+
+Intlayer, CMS / Görsel Düzenleyici bağlamında Görsel Düzenleyici Seçicilerini (Selectors) oluşturabilmek için bir IntlayerNode ekler.
+
+![Görsel Düzenleyici demosu](https://raw.githubusercontent.com/aymericzip/intlayer/main/docs/assets/visual_editor.gif?raw=true)
+
+Bir IntlayerNode; zenginleştirilmiş bir React/Vue/Preact/Solid/Angular/Svelte/Lit/Vanilla düğümüdür, ancak aynı zamanda temel ilkel (primitive) düğümün özelliklerine erişim de sağlar.
+
+Örneğin:
+
+```js
+const content = useIntlayer("app");
+
+// String Durumu
+content.title; // IntlayerNode<string> döndürür
+content.title.value; // Temel içeriği döndürür, burada bir string
+
+content.title.toString(); // String döndürür
+content.title.toLowerCase(); // String döndürür
+String(content.title); // String döndürür
+content.title.toUpperCase(); // Büyük harfe çevrilmiş string döndürür
+content.title.replace("a", "b"); // Değiştirilmiş string döndürür
+// ...
+```
+
+> Bir IntlayerNode'un özelliklerine erişmek çalışacaktır ancak Görsel Düzenleyici'de seçicileri görüntüleme yeteneğini bozacaktır.
+
+> IntlayerNode ayrıca sayıları veya `IntlayerNode<number>` gibi diğer tipleri de sarmalayabilir.

package/frequent_questions/uk/intlayerNode.md

@@ -0,0 +1,96 @@
+---
+createdAt: 2026-05-07
+updatedAt: 2026-05-07
+title: Тип IntlayerNode. Що це таке?
+description: Що таке тип IntlayerNode? Чому мій рядок перетворюється на IntlayerNode<string>?
+keywords:
+  - Вступ
+  - Початок роботи
+  - Intlayer
+  - Додаток
+  - Пакети
+slugs:
+  - frequent-questions
+  - intlayer-node
+history:
+  - version: 8.9.0
+    date: 2026-05-07
+    changes: "Ініціалізація документа"
+---
+
+# Що таке тип IntlayerNode?
+
+Тип `IntlayerNode<T>` — це спеціальний тип, що надається пакетами intlayer, такими як `next-intlayer`, `react-intlayer`, `vue-intlayer`, `preact-intlayer`, `solid-intlayer`, `angular-intlayer`, `svelte-intlayer`, `lit-intlayer` та `vanilla-intlayer`.
+
+## Приклад використання
+
+```tsx fileName="src/app.content.tsx" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+import type { ComponentChildren } from "preact";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: "Vite + Preact",
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```json fileName="src/app.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "app",
+  "content": {
+    "title": "Vite + Preact"
+  }
+}
+```
+
+<Tabs group="framework">
+  <Tab label="React / Next.js" value="react">
+
+```tsx fileName="src/App.tsx"
+import { useIntlayer } from "react-intlayer";
+
+const AppContent = () => {
+  const { title } = useIntlayer("app");
+
+  return title; // повертає тип: IntlayerNode<string>
+};
+```
+
+  </Tab>
+
+// Todo додати інші фреймворки у вигляді вкладок, як у docs/docs/uk/dictionary/markdown.md
+</Tabs>
+
+### Чому Intlayer вставляє IntlayerNode?
+
+Intlayer вставляє IntlayerNode, щоб мати можливість відображати селектори візуального редактора в контексті CMS / візуального редактора.
+
+![Демо візуального редактора](https://raw.githubusercontent.com/aymericzip/intlayer/main/docs/assets/visual_editor.gif?raw=true)
+
+IntlayerNode — це розширений вузол React/Vue/Preact/Solid/Angular/Svelte/Lit/Vanilla, який також дозволяє звертатися до властивостей базового примітивного вузла.
+
+Наприклад:
+
+```js
+const content = useIntlayer("app");
+
+// Випадок з рядком (String)
+content.title; // Повертає IntlayerNode<string>
+content.title.value; // Повертає базовий вміст, у даному випадку рядок
+
+content.title.toString(); // Повертає рядок
+content.title.toLowerCase(); // Повертає рядок
+String(content.title); // Повертає рядок
+content.title.toUpperCase(); // Повертає рядок у верхньому регістрі
+content.title.replace("a", "b"); // Повертає змінений рядок
+// ...
+```
+
+> Звернення до властивостей IntlayerNode буде працювати, але порушить можливість відображення селекторів у візуальному редакторі.
+
+> IntlayerNode також може обгортати числа або інші типи, такі як `IntlayerNode<number>`.

package/frequent_questions/vi/intlayerNode.md

@@ -0,0 +1,96 @@
+---
+createdAt: 2026-05-07
+updatedAt: 2026-05-07
+title: Kiểu IntlayerNode. Nó là gì?
+description: Kiểu IntlayerNode là gì? Tại sao chuỗi của tôi lại được chuyển đổi thành IntlayerNode<string>?
+keywords:
+  - Giới thiệu
+  - Bắt đầu
+  - Intlayer
+  - Ứng dụng
+  - Gói (Packages)
+slugs:
+  - frequent-questions
+  - intlayer-node
+history:
+  - version: 8.9.0
+    date: 2026-05-07
+    changes: "Khởi tạo tài liệu"
+---
+
+# Kiểu IntlayerNode là gì?
+
+Kiểu `IntlayerNode<T>` là một kiểu đặc biệt được cung cấp bởi các gói của intlayer như `next-intlayer`, `react-intlayer`, `vue-intlayer`, `preact-intlayer`, `solid-intlayer`, `angular-intlayer`, `svelte-intlayer`, `lit-intlayer` và `vanilla-intlayer`.
+
+## Ví dụ sử dụng
+
+```tsx fileName="src/app.content.tsx" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+import type { ComponentChildren } from "preact";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: "Vite + Preact",
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```json fileName="src/app.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "app",
+  "content": {
+    "title": "Vite + Preact"
+  }
+}
+```
+
+<Tabs group="framework">
+  <Tab label="React / Next.js" value="react">
+
+```tsx fileName="src/App.tsx"
+import { useIntlayer } from "react-intlayer";
+
+const AppContent = () => {
+  const { title } = useIntlayer("app");
+
+  return title; // trả về kiểu: IntlayerNode<string>
+};
+```
+
+  </Tab>
+
+// Todo thêm các framework khác dưới dạng tab giống như trong docs/docs/vi/dictionary/markdown.md
+</Tabs>
+
+### Tại sao Intlayer lại chèn một IntlayerNode?
+
+Intlayer chèn một IntlayerNode để có thể hiển thị các Bộ chọn (Selectors) của trình chỉnh sửa trực quan trong ngữ cảnh của CMS / Trình chỉnh sửa trực quan.
+
+![Bản demo trình chỉnh sửa trực quan](https://raw.githubusercontent.com/aymericzip/intlayer/main/docs/assets/visual_editor.gif?raw=true)
+
+Một IntlayerNode là một Node React/Vue/Preact/Solid/Angular/Svelte/Lit/Vanilla được làm phong phú, nhưng nó cũng cho phép truy cập các thuộc tính của node nguyên thủy cơ bản.
+
+Ví dụ:
+
+```js
+const content = useIntlayer("app");
+
+// Trường hợp là Chuỗi (String)
+content.title; // Trả về IntlayerNode<string>
+content.title.value; // Trả về nội dung cơ bản, ở đây là một chuỗi
+
+content.title.toString(); // Trả về chuỗi
+content.title.toLowerCase(); // Trả về chuỗi
+String(content.title); // Trả về chuỗi
+content.title.toUpperCase(); // Trả về chuỗi in hoa
+content.title.replace("a", "b"); // Trả về chuỗi đã sửa đổi
+// ...
+```
+
+> Việc truy cập các thuộc tính của một IntlayerNode sẽ vẫn hoạt động, nhưng sẽ làm mất khả năng hiển thị các bộ chọn trong Trình chỉnh sửa trực quan.
+
+> IntlayerNode cũng có thể bao bọc số, hoặc các kiểu khác như `IntlayerNode<number>`

package/frequent_questions/zh/intlayerNode.md

@@ -0,0 +1,96 @@
+---
+createdAt: 2026-05-07
+updatedAt: 2026-05-07
+title: IntlayerNode 类型。它是什么？
+description: 什么是 IntlayerNode 类型？为什么我的字符串被转换为 IntlayerNode<string>？
+keywords:
+  - 介绍
+  - 开始使用
+  - Intlayer
+  - 应用程序
+  - 软件包
+slugs:
+  - frequent-questions
+  - intlayer-node
+history:
+  - version: 8.9.0
+    date: 2026-05-07
+    changes: "初始化文档"
+---
+
+# 什么是 IntlayerNode 类型？
+
+`IntlayerNode<T>` 类型是由 intlayer 的软件包（如 `next-intlayer`、`react-intlayer`、`vue-intlayer`、`preact-intlayer`、`solid-intlayer`、`angular-intlayer`、`svelte-intlayer`、`lit-intlayer` 和 `vanilla-intlayer`）提供的特殊类型。
+
+## 使用示例
+
+```tsx fileName="src/app.content.tsx" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+import type { ComponentChildren } from "preact";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: "Vite + Preact",
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+```json fileName="src/app.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "app",
+  "content": {
+    "title": "Vite + Preact"
+  }
+}
+```
+
+<Tabs group="framework">
+  <Tab label="React / Next.js" value="react">
+
+```tsx fileName="src/App.tsx"
+import { useIntlayer } from "react-intlayer";
+
+const AppContent = () => {
+  const { title } = useIntlayer("app");
+
+  return title; // 返回类型：IntlayerNode<string>
+};
+```
+
+  </Tab>
+
+// Todo 像 docs/docs/zh/dictionary/markdown.md 一样添加其他框架作为标签
+</Tabs>
+
+### 为什么 Intlayer 插入 IntlayerNode？
+
+Intlayer 插入 IntlayerNode 是为了能够在 CMS / 可视化编辑器的上下文中渲染可视化编辑器的选择器（Selectors）。
+
+![可视化编辑器演示](https://raw.githubusercontent.com/aymericzip/intlayer/main/docs/assets/visual_editor.gif?raw=true)
+
+IntlayerNode 是一个增强的 React/Vue/Preact/Solid/Angular/Svelte/Lit/Vanilla 节点，但也可以访问基础原始节点的属性。
+
+例如：
+
+```js
+const content = useIntlayer("app");
+
+// 字符串的情况
+content.title; // 返回 IntlayerNode<string>
+content.title.value; // 返回基础内容，这里是一个字符串
+
+content.title.toString(); // 返回字符串
+content.title.toLowerCase(); // 返回字符串
+String(content.title); // 返回字符串
+content.title.toUpperCase(); // 返回大写字符串
+content.title.replace("a", "b"); // 返回修改后的字符串
+// ...
+```
+
+> 访问 IntlayerNode 的属性是可行的，但会破坏在可视化编辑器中显示选择器的能力。
+
+> IntlayerNode 也可以包装数字或其他类型，如 `IntlayerNode<number>`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "8.9.1",
+  "version": "8.9.2",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -72,13 +72,13 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "8.9.1",
-    "@intlayer/core": "8.9.1",
-    "@intlayer/types": "8.9.1"
+    "@intlayer/config": "8.9.2",
+    "@intlayer/core": "8.9.2",
+    "@intlayer/types": "8.9.2"
   },
   "devDependencies": {
-    "@intlayer/api": "8.9.1",
-    "@intlayer/cli": "8.9.1",
+    "@intlayer/api": "8.9.2",
+    "@intlayer/cli": "8.9.2",
     "@types/node": "25.6.0",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",

package/src/generated/frequentQuestions.entry.ts

@@ -259,6 +259,26 @@ export const frequentQuestionsEntry = {
     vi: readLocale('get_locale_cookie.md', 'vi'),
     uk: readLocale('get_locale_cookie.md', 'uk'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './frequent_questions/en/intlayerNode.md': {
+    en: readLocale('intlayerNode.md', 'en'),
+    ru: readLocale('intlayerNode.md', 'ru'),
+    ja: readLocale('intlayerNode.md', 'ja'),
+    fr: readLocale('intlayerNode.md', 'fr'),
+    ko: readLocale('intlayerNode.md', 'ko'),
+    zh: readLocale('intlayerNode.md', 'zh'),
+    es: readLocale('intlayerNode.md', 'es'),
+    de: readLocale('intlayerNode.md', 'de'),
+    ar: readLocale('intlayerNode.md', 'ar'),
+    it: readLocale('intlayerNode.md', 'it'),
+    'en-GB': readLocale('intlayerNode.md', 'en-GB'),
+    pt: readLocale('intlayerNode.md', 'pt'),
+    hi: readLocale('intlayerNode.md', 'hi'),
+    tr: readLocale('intlayerNode.md', 'tr'),
+    pl: readLocale('intlayerNode.md', 'pl'),
+    id: readLocale('intlayerNode.md', 'id'),
+    vi: readLocale('intlayerNode.md', 'vi'),
+    uk: readLocale('intlayerNode.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/intlayer_command_undefined.md': {
     en: readLocale('intlayer_command_undefined.md', 'en'),
     ru: readLocale('intlayer_command_undefined.md', 'ru'),