added X-ray page

Author: dg

tools/bg/@home.texy

@@ -16,6 +16,7 @@
 - [Code Checker |code-checker] проверява изходните ви файлове за формални недостатъци като невидим BOM, контролни знаци, повредено кодиране или невалиден синтаксис на PHP, Latte, NEON, JSON и YAML файлове и може да ги поправи автоматично.
 - [Coding Standard |en:coding-standard] автоматично форматира вашия PHP код според Nette coding standard, от отстъпите и скобите до интервалите и подреждането на импортите.
 - [PHPStan Rules |en:phpstan-rules] учат PHPStan да разбира кода на Nette, така че статичният анализ извежда точни типове и докладва по-малко фалшиви сигнали.
+- [X-Ray |en:xray] показва ви точно как проектът ви използва екосистемата на Nette: кои методи, Latte филтри и конфигурационни ключове реално използвате.
 
 
 Изкуствен интелект

tools/cs/@home.texy

@@ -16,6 +16,7 @@ Kvalita kódu
 - [Code Checker |code-checker] zkontroluje vaše zdrojové soubory a najde v nich formální nedostatky, jako je neviditelný BOM, kontrolní znaky, chybné kódování nebo neplatná syntaxe souborů PHP, Latte, NEON, JSON a YAML, a umí je automaticky opravit.
 - [Coding Standard |coding-standard] automaticky naformátuje váš PHP kód podle Nette coding standardu, od odsazení a závorek až po mezery a řazení importů.
 - [PHPStan Rules |phpstan-rules] naučí PHPStan rozumět Nette kódu, takže statická analýza odvozuje přesné typy a hlásí méně falešných chyb.
+- [X-Ray |xray] vám ukáže, jak přesně váš projekt využívá ekosystém Nette: které metody, Latte filtry i konfigurační klíče doopravdy používáte.
 
 
 Umělá inteligence

tools/cs/xray.texy

@@ -0,0 +1,90 @@
+Nette X-Ray
+***********
+
+.[perex]
+[X-Ray |https://github.com/nette/xray] vám ukáže, jak přesně váš projekt využívá ekosystém Nette: které metody, Latte filtry i konfigurační klíče doopravdy používáte.
+
+Přemýšleli jste někdy, které Nette metody voláte nejčastěji? Které Latte filtry vlastně používáte? Sahá ještě někdo na ten starý konfigurační klíč? X-Ray prohledá váš kód statickou analýzou a odpoví vám přehledným HTML reportem.
+
+
+Co se analyzuje
+===============
+
+Místo regulárních výrazů a odhadů používá X-Ray statickou analýzu: rozliší typy skrz dědičnost, pozná deklarující třídy a sleduje vzory argumentů. Výsledkem je přesný obrázek o tom, jak váš projekt interaguje s Nette.
+
+| PHP a PHPT | Latte šablony | NEON konfigurace |
+|------------|---------------|------------------|
+| volání metod a funkcí | značky a n:atributy | vzory DI služeb |
+| argumenty (poziční, pojmenované) | filtry a jejich argumenty | registrace rozšíření |
+| použití návratových hodnot | funkce a konstanty | použité sekce |
+| přístup k properties | varianty syntaxe | konfigurační klíče |
+| dědičnost tříd a traity | | |
+| přepisy metod | | |
+
+
+Instalace
+=========
+
+Nainstalujte ho přes Composer jako vývojovou závislost:
+
+```shell
+composer require --dev nette/xray
+```
+
+Vyžaduje PHP 8.2 nebo vyšší a běží na PHPStanu 2.1. Funguje s libovolným projektem, který používá Nette, Latte, Tracy, Dibi nebo Texy.
+
+
+Použití
+=======
+
+Spusťte ho nad svými zdrojovými adresáři:
+
+```shell
+vendor/bin/xray app/ src/
+```
+
+Během chvíle získáte interaktivní HTML report (`xray-report.html`), který stačí otevřít v prohlížeči, a strojově čitelná data (`xray-report.json`):
+
+```
+
+
+Nette X-Ray
+===========
+
+Scanning PHP files ... 142/142 done
+Scanning NEON files ... 4/4 done
+Scanning Latte files ... 87/87 done
+
+Reports saved to:
+  xray-report.json
+  xray-report.html
+```
+
+
+Konfigurace
+===========
+
+Chování upravíte souborem `nette-xray.neon` v kořeni projektu:
+
+```neon
+# Výchozí cesty k analýze (použijí se, když neuvedete argumenty na příkazové řádce)
+paths:
+	- app
+	- src
+
+# Další adresáře k vyloučení (vendor, temp, node_modules, .git jsou vyloučeny automaticky)
+excludeDirs:
+	- generated
+
+# Automatické odeslání bez ptaní
+upload: false
+```
+
+/--comment
+
+
+Pomozte vývoji Nette
+====================
+
+Po analýze můžete report dobrovolně odeslat a pomoct tak směřovat vývoj frameworku – reálná data o používání jsou spolehlivější než ankety. Odesílají se jen agregovaná čísla: kolikrát se které API zavolá a jaké vzory používáte. Žádný kód, žádné cesty k souborům, žádné hodnoty proměnných. Data se odešlou jen tehdy, když to výslovně potvrdíte, a JSON report se vždy nejdřív uloží lokálně, takže si ho můžete v klidu prohlédnout.
+\--

tools/de/@home.texy

@@ -16,6 +16,7 @@ Code-Qualität
 - [Code Checker |code-checker] überprüft Ihre Quelldateien auf formale Mängel wie ein unsichtbares BOM, Steuerzeichen, fehlerhafte Kodierung oder ungültige Syntax von PHP-, Latte-, NEON-, JSON- und YAML-Dateien und kann diese automatisch beheben.
 - [Coding Standard |en:coding-standard] formatiert Ihren PHP-Code automatisch gemäß dem Nette Coding Standard, von der Einrückung und den Klammern bis hin zu Abständen und der Reihenfolge der Imports.
 - [PHPStan Rules |en:phpstan-rules] bringen PHPStan bei, Nette-Code zu verstehen, sodass die statische Analyse präzise Typen ableitet und weniger Fehlalarme meldet.
+- [X-Ray |en:xray] zeigt Ihnen genau, wie Ihr Projekt das Nette-Ökosystem nutzt: welche Methoden, Latte-Filter und Konfigurationsschlüssel Sie tatsächlich verwenden.
 
 
 Künstliche Intelligenz

tools/el/@home.texy

@@ -16,6 +16,7 @@
 - [Code Checker |code-checker] ελέγχει τα πηγαία αρχεία σας για τυπικά σφάλματα, όπως ένα αόρατο BOM, χαρακτήρες ελέγχου, κατεστραμμένη κωδικοποίηση ή μη έγκυρη σύνταξη αρχείων PHP, Latte, NEON, JSON και YAML, και μπορεί να τα διορθώσει αυτόματα.
 - [Coding Standard |en:coding-standard] μορφοποιεί αυτόματα τον κώδικα PHP σας σύμφωνα με το πρότυπο κωδικοποίησης του Nette, από τη στοίχιση και τα άγκιστρα μέχρι τα κενά και τη σειρά των imports.
 - [PHPStan Rules |en:phpstan-rules] μαθαίνουν στο PHPStan να κατανοεί τον κώδικα Nette, ώστε η στατική ανάλυση να συμπεραίνει ακριβείς τύπους και να αναφέρει λιγότερα ψευδώς θετικά.
+- [X-Ray |en:xray] σας δείχνει ακριβώς πώς το έργο σας χρησιμοποιεί το οικοσύστημα Nette: ποιες μεθόδους, φίλτρα Latte και κλειδιά ρυθμίσεων χρησιμοποιείτε πραγματικά.
 
 
 Τεχνητή νοημοσύνη

tools/en/@home.texy

@@ -16,6 +16,7 @@ Code Quality
 - [Code Checker |code-checker] checks your source files for formal flaws such as an invisible BOM, control characters, broken encoding, or invalid syntax of PHP, Latte, NEON, JSON and YAML files, and can fix them automatically.
 - [Coding Standard |coding-standard] automatically formats your PHP code according to the Nette coding standard, from indentation and braces to spacing and the ordering of imports.
 - [PHPStan Rules |phpstan-rules] teach PHPStan to understand Nette code, so static analysis infers precise types and reports fewer false positives.
+- [X-Ray |xray] shows you exactly how your project uses the Nette ecosystem: which methods, Latte filters and configuration keys you actually use.
 
 
 Artificial Intelligence

tools/en/xray.texy

@@ -0,0 +1,90 @@
+Nette X-Ray
+***********
+
+.[perex]
+[X-Ray |https://github.com/nette/xray] shows you exactly how your project uses the Nette ecosystem: which methods, Latte filters and configuration keys you actually use.
+
+Ever wondered which Nette methods you call the most? Which Latte filters you actually use? Whether anyone still touches that old configuration key? X-Ray scans your code with static analysis and answers that with a clear HTML report.
+
+
+What Gets Analyzed
+==================
+
+Instead of regex or guessing, X-Ray uses static analysis: it resolves types through inheritance, detects declaring classes and tracks argument patterns. The result is an accurate picture of how your project interacts with Nette.
+
+| PHP and PHPT | Latte templates | NEON configuration |
+|--------------|-----------------|--------------------|
+| method & function calls | tags & n:attributes | DI service patterns |
+| arguments (positional, named) | filters & their arguments | extension registration |
+| return value usage | functions & constants | section usage |
+| property access | syntax variants | configuration keys |
+| class inheritance & traits | | |
+| method overrides | | |
+
+
+Installation
+============
+
+Install it via Composer as a dev dependency:
+
+```shell
+composer require --dev nette/xray
+```
+
+It requires PHP 8.2 or higher and runs on PHPStan 2.1. It works with any project using Nette, Latte, Tracy, Dibi or Texy.
+
+
+Usage
+=====
+
+Point it at your source directories:
+
+```shell
+vendor/bin/xray app/ src/
+```
+
+Within moments you get an interactive HTML report (`xray-report.html`) you can open in your browser, plus machine-readable data (`xray-report.json`):
+
+```
+
+
+Nette X-Ray
+===========
+
+Scanning PHP files ... 142/142 done
+Scanning NEON files ... 4/4 done
+Scanning Latte files ... 87/87 done
+
+Reports saved to:
+  xray-report.json
+  xray-report.html
+```
+
+
+Configuration
+=============
+
+Create a `nette-xray.neon` file in your project root to customize the behavior:
+
+```neon
+# Default analysis paths (used when no CLI arguments are given)
+paths:
+	- app
+	- src
+
+# Additional directories to exclude (vendor, temp, node_modules, .git are excluded by default)
+excludeDirs:
+	- generated
+
+# Auto-upload without asking
+upload: false
+```
+
+/--comment
+
+
+Help Improve Nette
+==================
+
+After the analysis, you can optionally send the report to help guide the framework's development – real usage data is far more reliable than surveys. Only aggregated numbers are sent: how many times each API is called and which patterns you use. No code, no file paths, no variable values. Data is sent only if you explicitly confirm, and the JSON report is always saved locally first, so you can review it at your leisure.
+\--

tools/es/@home.texy

@@ -16,6 +16,7 @@ Calidad del código
 - [Code Checker |code-checker] comprueba sus archivos fuente en busca de defectos formales como un BOM invisible, caracteres de control, codificación dañada o sintaxis inválida de archivos PHP, Latte, NEON, JSON y YAML, y puede corregirlos automáticamente.
 - [Coding Standard |en:coding-standard] formatea automáticamente su código PHP según el estándar de codificación de Nette, desde la sangría y las llaves hasta los espacios y la ordenación de las importaciones.
 - [PHPStan Rules |en:phpstan-rules] enseñan a PHPStan a entender el código de Nette, de modo que el análisis estático infiere tipos precisos y notifica menos falsos positivos.
+- [X-Ray |en:xray] le muestra exactamente cómo usa su proyecto el ecosistema de Nette: qué métodos, filtros de Latte y claves de configuración utiliza realmente.
 
 
 Inteligencia artificial

tools/fr/@home.texy

@@ -16,6 +16,7 @@ Qualité du code
 - [Code Checker |code-checker] vérifie vos fichiers sources et y détecte des défauts formels tels qu'un BOM invisible, des caractères de contrôle, un encodage incorrect ou une syntaxe invalide des fichiers PHP, Latte, NEON, JSON et YAML, et peut les corriger automatiquement.
 - [Coding Standard |en:coding-standard] formate automatiquement votre code PHP selon le standard de codage Nette, de l'indentation et des accolades jusqu'aux espaces et à l'ordre des imports.
 - [PHPStan Rules |en:phpstan-rules] apprennent à PHPStan à comprendre le code Nette, pour que l'analyse statique déduise des types précis et signale moins de faux positifs.
+- [X-Ray |en:xray] vous montre exactement comment votre projet utilise l'écosystème Nette : quelles méthodes, filtres Latte et clés de configuration vous utilisez réellement.
 
 
 Intelligence artificielle

tools/hu/@home.texy

@@ -16,6 +16,7 @@ Kódminőség
 - [Code Checker |code-checker] ellenőrzi a forrásfájljaidat, és olyan formai hibákat keres bennük, mint a láthatatlan BOM, a vezérlő karakterek, a hibás kódolás vagy a PHP, Latte, NEON, JSON és YAML fájlok érvénytelen szintaxisa, és képes automatikusan kijavítani őket.
 - [Coding Standard |en:coding-standard] automatikusan formázza a PHP kódodat a Nette coding standard szerint, a behúzástól és a zárójelektől kezdve a szóközökön át az importok rendezéséig.
 - [PHPStan Rules |en:phpstan-rules] megtanítják a PHPStan-t a Nette-kód megértésére, így a statikus elemzés pontos típusokat következtet ki és kevesebb téves riasztást jelez.
+- [X-Ray |en:xray] pontosan megmutatja, hogyan használja a projekted a Nette ökoszisztémát: mely metódusokat, Latte szűrőket és konfigurációs kulcsokat használsz ténylegesen.
 
 
 Mesterséges intelligencia