gravity-ui · github-actions · Jul 16, 2026 · Jul 16, 2026 · Jul 16, 2026 · Jul 16, 2026
@@ -1,6 +1,6 @@
 # Gravity UI Charts · [![npm package](https://img.shields.io/npm/v/@gravity-ui/charts)](https://www.npmjs.com/package/@gravity-ui/charts) [![License](https://img.shields.io/github/license/gravity-ui/charts)](LICENSE) [![CI](https://img.shields.io/github/actions/workflow/status/gravity-ui/charts/.github/workflows/ci.yml?label=CI&logo=github)](https://github.com/gravity-ui/charts/actions/workflows/ci.yml?query=branch:main) [![storybook](https://img.shields.io/badge/Storybook-deployed-ff4685)](https://preview.gravity-ui.com/charts/)
 
-React-Charting-Bibliothek mit über 10 Diagrammtypen: Fläche, Balken, Linie, Kreis, Streu, Treemap und mehr.
+React-Charting-Bibliothek mit über 10 Diagrammtypen: Fläche, Balken, Linie, Kreis, Streu, Baumkarte und mehr.
 
 ## Installation
 
@@ -65,7 +65,7 @@ Verteilt unter der MIT-Lizenz. Details finden Sie in [LICENSE](LICENSE).
 
 ## Für KI-Agenten
 
-Eine deklarative React-Charting-Bibliothek für Gravity UI-Apps – rendert Linien-, Flächen-, Balken-, Kreis-, Streu-, Treemap- und andere Diagramme aus einer einzigen `data`-Konfiguration, die passend zum Rest der App thematisiert ist.
+Eine deklarative React-Charting-Bibliothek für Gravity UI-Apps – rendert Linien-, Flächen-, Balken-, Kreis-, Streu-, Baumkarten- und andere Diagramme aus einer einzigen `data`-Konfiguration, die thematisch auf den Rest der App abgestimmt ist.
 
 ### Wann verwenden
 
@@ -75,15 +75,15 @@ Eine deklarative React-Charting-Bibliothek für Gravity UI-Apps – rendert Lini
 
 ### Wann nicht verwenden
 
-- Projekte, die noch `@gravity-ui/chartkit` verwenden – das ist der ältere, Adapter-basierte Wrapper (YAGR/Highcharts/D3); dieses Paket ist der moderne, eigenständige Renderer und kein direkter Ersatz.
+- Projekte, die noch `@gravity-ui/chartkit` verwenden – das ist der ältere Adapter-basierte Wrapper (YAGR/Highcharts/D3); dieses Paket ist der moderne eigenständige Renderer und kein direkter Ersatz.
 - Reine Tabellendaten – verwenden Sie [`@gravity-ui/table`](https://github.com/gravity-ui/table).
 - Nicht-React- oder reine Server-Rendering – `Chart` rendert React SVG und benötigt das DOM.
 
 ### Häufige Fallstricke
 
 - **Die Komponente ist `Chart`, nicht `ChartKit`.** Importieren Sie `{Chart}` aus `@gravity-ui/charts`; `ChartKit` gehört zum separaten Legacy-Paket `@gravity-ui/chartkit`.
 - **Die `data`-Prop ist `data`, strukturiert als `{series: {data: [...]}}`.** Jeder Eintrag in `series.data` ist eine Serie mit eigenem `type` und eigener `data`-Array – es gibt kein Array von Serien auf oberster Ebene.
-- **Ohne einen dimensionierten Container wird nichts gerendert.** `Chart` füllt seinen übergeordneten Container, geben Sie dem Wrapper also eine explizite Höhe.
+- **Ohne einen dimensionierten Container wird nichts gerendert.** `Chart` füllt sein übergeordnetes Element, geben Sie dem Wrapper also eine explizite Höhe.
 - **Erfordert uikit-Setup.** Umschließen Sie mit `ThemeProvider` und importieren Sie `@gravity-ui/uikit/styles/styles.css`; `@gravity-ui/uikit` ist eine erforderliche Peer-Abhängigkeit.
 
 ### Nützliche Dokumente
@@ -95,4 +95,8 @@ Eine deklarative React-Charting-Bibliothek für Gravity UI-Apps – rendert Lini
 - [HTML-Inhalt](./docs/diplodoc/pages/guides/html.md)
 - [Wertformatierung](./docs/diplodoc/pages/guides/value-formatting.md)
 - [Datenbeschriftungen](./docs/diplodoc/pages/guides/data-labels.md)
-- [Achsentypen](./docs/diplodoc/pages/guides/axis-types.md)
+- [Achsentypen](./docs/diplodoc/pages/guides/axis-types.md)
+
+## Dokumentation für KI-Agenten
+
+Agentenlesbare Dokumentation für die installierte Version befindet sich in `node_modules/@gravity-ui/charts/dist/docs/INDEX.md`.
@@ -8,7 +8,7 @@ Librería de gráficos React con más de 10 tipos de gráficos: área, barras, l
 npm install @gravity-ui/uikit @gravity-ui/charts
 ```
 
-`@gravity-ui/uikit` es una dependencia peer requerida — proporciona la tematización y los estilos de los que dependen los gráficos.
+`@gravity-ui/uikit` es una dependencia peer requerida; proporciona la tematización y los estilos de los que dependen los gráficos.
 
 ## Uso
 
@@ -61,29 +61,29 @@ export default function App() {
 
 ## Licencia
 
-Distribuido bajo la Licencia MIT. Ver [LICENSE](LICENSE) para más detalles.
+Distribuido bajo la Licencia MIT. Consulta [LICENSE](LICENSE) para más detalles.
 
 ## Para agentes de IA
 
-Una librería declarativa de gráficos React para aplicaciones Gravity UI — renderiza gráficos de línea, área, barras, pastel, dispersión, treemap y otros a partir de una única configuración `data`, tematizada para que coincida con el resto de la aplicación.
+Una librería declarativa de gráficos React para aplicaciones Gravity UI — renderiza gráficos de línea, área, barras, pastel, dispersión, treemap y otros a partir de una única configuración `data`, tematizada para coincidir con el resto de la aplicación.
 
 ### Cuándo usar
 
 - Gráficos empresariales estándar: `line`, `area`, `bar-x`/`bar-y`, `pie`, `scatter`, `treemap`, `waterfall`, `sankey`, `radar`, `heatmap`, `funnel`, `x-range`.
 - Visualizaciones que deben seguir la tematización de Gravity UI (clara/oscura) y compartir tokens con una aplicación `@gravity-ui/uikit`.
-- Renderizar un gráfico a partir de datos declarativos en lugar de dibujarlo imperativamente.
+- Renderizar un gráfico a partir de datos declarativos en lugar de dibujar imperativamente.
 
 ### Cuándo no usar
 
 - Proyectos que aún usan `@gravity-ui/chartkit` — ese es el antiguo wrapper basado en adaptadores (YAGR/Highcharts/D3); este paquete es el renderizador independiente moderno y no es un reemplazo directo.
 - Datos tabulares simples — usa [`@gravity-ui/table`](https://github.com/gravity-ui/table).
-- Renderizado no-React o solo del lado del servidor — `Chart` renderiza SVG de React y necesita el DOM.
+- Renderizado no-React o solo en servidor — `Chart` renderiza SVG de React y necesita el DOM.
 
 ### Errores comunes
 
 - **El componente es `Chart`, no `ChartKit`.** Importa `{Chart}` desde `@gravity-ui/charts`; `ChartKit` pertenece al paquete legado separado `@gravity-ui/chartkit`.
-- **La prop `data` es `data`, con la forma `{series: {data: [...]}}`.** Cada entrada en `series.data` es una serie con su propio `type` y array `data` — no hay un array de series de nivel superior.
-- **Nada se renderiza sin un contenedor con tamaño.** `Chart` llena su contenedor padre, así que dale al envoltorio una altura explícita.
+- **La prop `data` es `data`, con forma `{series: {data: [...]}}`.** Cada entrada en `series.data` es una serie con su propio `type` y array `data` — no hay un array de series de nivel superior.
+- **Nada se renderiza sin un contenedor con tamaño.** `Chart` llena su padre, así que dale al contenedor envolvente una altura explícita.
 - **Requiere configuración de uikit.** Envuelve en `ThemeProvider` e importa `@gravity-ui/uikit/styles/styles.css`; `@gravity-ui/uikit` es una dependencia peer requerida.
 
 ### Documentación útil
@@ -95,4 +95,8 @@ Una librería declarativa de gráficos React para aplicaciones Gravity UI — re
 - [Contenido HTML](./docs/diplodoc/pages/guides/html.md)
 - [Formato de valores](./docs/diplodoc/pages/guides/value-formatting.md)
 - [Etiquetas de datos](./docs/diplodoc/pages/guides/data-labels.md)
-- [Tipos de ejes](./docs/diplodoc/pages/guides/axis-types.md)
+- [Tipos de ejes](./docs/diplodoc/pages/guides/axis-types.md)
+
+## Documentación para agentes de IA
+
+La documentación legible por agentes para la versión instalada se encuentra en `node_modules/@gravity-ui/charts/dist/docs/INDEX.md`.
@@ -1,14 +1,14 @@
 # Gravity UI Charts · [![npm package](https://img.shields.io/npm/v/@gravity-ui/charts)](https://www.npmjs.com/package/@gravity-ui/charts) [![License](https://img.shields.io/github/license/gravity-ui/charts)](LICENSE) [![CI](https://img.shields.io/github/actions/workflow/status/gravity-ui/charts/.github/workflows/ci.yml?label=CI&logo=github)](https://github.com/gravity-ui/charts/actions/workflows/ci.yml?query=branch:main) [![storybook](https://img.shields.io/badge/Storybook-deployed-ff4685)](https://preview.gravity-ui.com/charts/)
 
-Bibliothèque de graphiques React avec plus de 10 types de graphiques : aire, barre, ligne, camembert, dispersion, treemap, et plus encore.
+Bibliothèque de graphiques React avec plus de 10 types de graphiques : aire, barres, ligne, camembert, nuage de points, arbre, et plus encore.
 
 ## Installation
 
 ```shell
 npm install @gravity-ui/uikit @gravity-ui/charts
 ```
 
-`@gravity-ui/uikit` est une dépendance pair requise — elle fournit le thème et les styles dont les graphiques dépendent.
+`@gravity-ui/uikit` est une dépendance pair requise — elle fournit la gestion des thèmes et les styles dont les graphiques dépendent.
 
 ## Utilisation
 
@@ -49,7 +49,7 @@ export default function App() {
 }
 ```
 
-`Chart` s'adapte à la taille de son parent, l'élément enveloppant doit donc avoir une hauteur.
+`Chart` s'adapte à la taille de son parent, donc l'élément enveloppant doit avoir une hauteur.
 
 ## Documentation
 
@@ -65,25 +65,25 @@ Distribué sous la licence MIT. Voir [LICENSE](LICENSE) pour les détails.
 
 ## Pour les agents IA
 
-Une bibliothèque de graphiques React déclarative pour les applications Gravity UI — affichez des graphiques linéaires, d'aire, à barres, circulaires, de dispersion, en arbre, et d'autres à partir d'une seule configuration `data`, thémée pour correspondre au reste de l'application.
+Une bibliothèque de graphiques déclarative pour React pour les applications Gravity UI — affichez des graphiques linéaires, en aire, à barres, en camembert, en nuage de points, en arbre, et d'autres à partir d'une seule configuration `data`, thémée pour correspondre au reste de l'application.
 
 ### Quand l'utiliser
 
-- Graphiques d'entreprise standard : `line`, `area`, `bar-x`/`bar-y`, `pie`, `scatter`, `treemap`, `waterfall`, `sankey`, `radar`, `heatmap`, `funnel`, `x-range`.
+- Graphiques commerciaux standards : `line`, `area`, `bar-x`/`bar-y`, `pie`, `scatter`, `treemap`, `waterfall`, `sankey`, `radar`, `heatmap`, `funnel`, `x-range`.
 - Visualisations qui doivent suivre le thème Gravity UI (clair/sombre) et partager des jetons avec une application `@gravity-ui/uikit`.
 - Affichage d'un graphique à partir de données déclaratives plutôt que d'un dessin impératif.
 
 ### Quand ne pas l'utiliser
 
-- Projets toujours sur `@gravity-ui/chartkit` — il s'agit de l'ancien wrapper basé sur des adaptateurs (YAGR/Highcharts/D3) ; ce package est le moteur de rendu autonome moderne et n'est pas un remplacement direct.
+- Projets toujours sur `@gravity-ui/chartkit` — il s'agit de l'ancien wrapper basé sur des adaptateurs (YAGR/Highcharts/D3) ; ce package est le nouveau moteur de rendu autonome et n'est pas un remplacement direct.
 - Données tabulaires brutes — utilisez [`@gravity-ui/table`](https://github.com/gravity-ui/table).
 - Rendu non-React ou uniquement côté serveur — `Chart` rend des SVG React et a besoin du DOM.
 
 ### Pièges courants
 
 - **Le composant est `Chart`, pas `ChartKit`.** Importez `{Chart}` depuis `@gravity-ui/charts` ; `ChartKit` appartient au package distinct hérité `@gravity-ui/chartkit`.
-- **La prop `data` est `data`, structurée `{series: {data: [...]}}`.** Chaque entrée dans `series.data` représente une série avec son propre `type` et tableau `data` — il n'y a pas de tableau de séries de niveau supérieur.
-- **Rien ne s'affiche sans un conteneur dimensionné.** `Chart` remplit son parent, donnez donc à l'élément enveloppant une hauteur explicite.
+- **La prop `data` est `data`, structurée `{series: {data: [...]}}`.** Chaque entrée dans `series.data` représente une série avec son propre `type` et son tableau `data` — il n'y a pas de tableau de séries de niveau supérieur.
+- **Rien ne s'affiche sans un conteneur dimensionné.** `Chart` remplit son parent, donc donnez à l'élément enveloppant une hauteur explicite.
 - **Nécessite une configuration uikit.** Enveloppez dans `ThemeProvider` et importez `@gravity-ui/uikit/styles/styles.css` ; `@gravity-ui/uikit` est une dépendance pair requise.
 
 ### Documentation utile
@@ -95,4 +95,8 @@ Une bibliothèque de graphiques React déclarative pour les applications Gravity
 - [Contenu HTML](./docs/diplodoc/pages/guides/html.md)
 - [Formatage des valeurs](./docs/diplodoc/pages/guides/value-formatting.md)
 - [Étiquettes de données](./docs/diplodoc/pages/guides/data-labels.md)
-- [Types d'axes](./docs/diplodoc/pages/guides/axis-types.md)
+- [Types d'axes](./docs/diplodoc/pages/guides/axis-types.md)
+
+## Documentation pour les agents IA
+
+La documentation lisible par agent pour la version installée se trouve dans `node_modules/@gravity-ui/charts/dist/docs/INDEX.md`.
@@ -1,14 +1,14 @@
 # Gravity UI Charts · [![npm package](https://img.shields.io/npm/v/@gravity-ui/charts)](https://www.npmjs.com/package/@gravity-ui/charts) [![License](https://img.shields.io/github/license/gravity-ui/charts)](LICENSE) [![CI](https://img.shields.io/github/actions/workflow/status/gravity-ui/charts/.github/workflows/ci.yml?label=CI&logo=github)](https://github.com/gravity-ui/charts/actions/workflows/ci.yml?query=branch:main) [![storybook](https://img.shields.io/badge/Storybook-deployed-ff4685)](https://preview.gravity-ui.com/charts/)
 
-Reactのチャートライブラリ。エリア、バー、ライン、パイ、散布図、ツリーマップなど10種類以上のチャートタイプを提供します。
+10種類以上のグラフ（エリア、棒、線、円、散布図、ツリーマップなど）を備えたReactのグラフ描画ライブラリです。
 
 ## インストール
 
 ```shell
 npm install @gravity-ui/uikit @gravity-ui/charts
 ```
 
-`@gravity-ui/uikit` は必須のピア依存関係です。チャートが依存するテーマ設定とスタイルを提供します。
+`@gravity-ui/uikit` は必須のピア依存関係です。グラフが依存するテーマ設定とスタイルを提供します。
 
 ## 使用方法
 
@@ -65,34 +65,38 @@ MIT License に基づいて配布されています。詳細は [LICENSE](LICENS
 
 ## AIエージェント向け
 
-Gravity UIアプリ向けの宣言的なReactチャートライブラリ。単一の`data`設定から、ライン、エリア、バー、パイ、散布図、ツリーマップなどのチャートを、アプリ全体と一致するテーマでレンダリングします。
+Gravity UI アプリケーション向けの宣言的な React グラフ描画ライブラリです。単一の `data` 設定から、線グラフ、エリアグラフ、棒グラフ、円グラフ、散布図、ツリーマップなどのグラフを、アプリの他の部分と調和するテーマでレンダリングします。
 
 ### 使用すべき場合
 
-- 標準的なビジネスチャート: `line`, `area`, `bar-x`/`bar-y`, `pie`, `scatter`, `treemap`, `waterfall`, `sankey`, `radar`, `heatmap`, `funnel`, `x-range`。
-- Gravity UIのテーマ設定（ライト/ダーク）に従い、`@gravity-ui/uikit`アプリとトークンを共有する必要があるビジュアライゼーション。
-- 命令的に描画するのではなく、宣言的なデータからチャートをレンダリングする場合。
+- 標準的なビジネスグラフ: `line`、`area`、`bar-x`/`bar-y`、`pie`、`scatter`、`treemap`、`waterfall`、`sankey`、`radar`、`heatmap`、`funnel`、`x-range`。
+- Gravity UI のテーマ設定（ライト/ダーク）に従い、`@gravity-ui/uikit` アプリとトークンを共有する必要があるビジュアライゼーション。
+- 命令的に描画するのではなく、宣言的なデータからグラフをレンダリングする場合。
 
 ### 使用すべきでない場合
 
-- まだ`@gravity-ui/chartkit`を使用しているプロジェクト。これは古いアダプターベースのラッパー（YAGR/Highcharts/D3）であり、このパッケージは最新のスタンドアロンレンダラーであり、ドロップイン置換ではありません。
-- 単純な表形式データ。[`@gravity-ui/table`](https://github.com/gravity-ui/table)を使用してください。
-- React以外またはサーバー専用のレンダリング。`Chart`はReact SVGをレンダリングし、DOMが必要です。
+- まだ `@gravity-ui/chartkit` を使用しているプロジェクト。これは古いアダプターベースのラッパー（YAGR/Highcharts/D3）です。このパッケージは最新のスタンドアロンレンダラーであり、直接的な置き換えではありません。
+- 単純な表形式データ。[`@gravity-ui/table`](https://github.com/gravity-ui/table) を使用してください。
+- React を使用しない、またはサーバーサイドのみのレンダリング。`Chart` は React SVG をレンダリングし、DOM を必要とします。
 
 ### よくある落とし穴
 
 - **コンポーネント名は `Chart` であり、`ChartKit` ではありません。** `@gravity-ui/charts` から `{Chart}` をインポートしてください。`ChartKit` は、別のレガシーパッケージである `@gravity-ui/chartkit` に属します。
-- **`data` プロップは `data` で、形状は `{series: {data: [...]}}` です。** `series.data` の各エントリは、独自の `type` と `data` 配列を持つ1つのシリーズです。シリーズのトップレベル配列はありません。
+- **`data` プロップは `{series: {data: [...]}}` という形式です。** `series.data` 内の各エントリは、独自の `type` と `data` 配列を持つ1つのシリーズです。シリーズのトップレベル配列はありません。
 - **サイズ指定のないコンテナでは何もレンダリングされません。** `Chart` は親要素を埋めるため、ラッパーに明示的な高さを指定してください。
-- **uikitの設定が必要です。** `ThemeProvider` でラップし、`@gravity-ui/uikit/styles/styles.css` をインポートしてください。`@gravity-ui/uikit` は必須のピア依存関係です。
+- **uikit のセットアップが必要です。** `ThemeProvider` でラップし、`@gravity-ui/uikit/styles/styles.css` をインポートしてください。`@gravity-ui/uikit` は必須のピア依存関係です。
 
 ### 役立つドキュメント
 
 - [はじめに](./docs/diplodoc/pages/get-started.md)
 - [テーマ設定](./docs/diplodoc/pages/guides/theming.md)
 - [ツールチップ](./docs/diplodoc/pages/guides/tooltip.md)
 - [凡例](./docs/diplodoc/pages/guides/legend.md)
-- [HTMLコンテンツ](./docs/diplodoc/pages/guides/html.md)
+- [HTML コンテンツ](./docs/diplodoc/pages/guides/html.md)
 - [値のフォーマット](./docs/diplodoc/pages/guides/value-formatting.md)
 - [データラベル](./docs/diplodoc/pages/guides/data-labels.md)
-- [軸タイプ](./docs/diplodoc/pages/guides/axis-types.md)
+- [軸の種類](./docs/diplodoc/pages/guides/axis-types.md)
+
+## AIエージェント向けドキュメント
+
+インストールされているバージョンのエージェント可読ドキュメントは、`node_modules/@gravity-ui/charts/dist/docs/INDEX.md` にあります。