small fixes

Author: Denis Peshkov (CZ)

.gitignore

@@ -31,3 +31,5 @@ _NCrunch_WebCompiler
 output/
 rider/build/
 rider/.gradle/
+rider/gradle-truststore.jks
+rider/gradle-local.properties

README-RIDER.md

@@ -91,7 +91,7 @@ dotnet add package TypeScriptDefinitionGenerator.MSBuild
 ### Вариант 2: Локальный targets (для разработки в репозитории TypeScriptDefinitionGenerator)
 
 ```xml
-<Import Project="path/to/build/TypeScriptDefinitionGenerator.targets" />
+<Import Project="path/to/src/TypeScriptDefinitionGenerator.MSBuild/TypeScriptDefinitionGenerator.MSBuild.targets" />
 
 <ItemGroup>
   <TypeScriptDefinitionSource Include="base\ThirdClass.cs" />
@@ -108,34 +108,146 @@ Target использует Inputs/Outputs для инкрементальной
 
 ## Rider Plugin
 
-Плагин добавляет пункт «Generate TypeScript Definition» в контекстное меню для .cs файлов (в меню Generate и в Project View). Плагин запускает `TypeScriptDefinitionGenerator.Cli` как subprocess — без конфликтов с ReSharper SDK.
+Плагин добавляет пункт «Generate TypeScript Definition» в контекстное меню для .cs файлов (в меню Generate и в Project View). Плагин запускает `TypeScriptDefinitionGenerator.Cli` как subprocess. Плагин совместим с Rider 2024.1+ (включая Rider 2025.3).
 
 ### Сборка плагина
 
-**Требования:** .NET SDK; для контекстного меню — Java 17+.
+**Общее требование:** .NET SDK на любой ОС.
 
-```bash
-# Полная сборка (с контекстным меню Solution View)
-./build-rider-plugin.sh [Debug|Release] [версия]
-# Пример: ./build-rider-plugin.sh Release 1.0.0
-```
+Два варианта сборки:
+- **Вариант 1 (полная):** .NET backend + Kotlin frontend — контекстное меню по ПКМ по .cs в Solution View. **Kotlin устанавливать не нужно** — он подтягивается сборкой (Gradle). Нужны только **Java 17+** (JDK) и на Windows — скрипт `gradlew.bat` (см. ниже).
+- **Вариант 2 (только .NET):** только .NET backend — пункта в контекстном меню нет; генерация через **Find Action** (Ctrl+Shift+A / Cmd+Shift+A) → «Generate TypeScript Definition». Java и Kotlin не требуются.
 
-**Без Java 17:** скрипт автоматически соберёт только .NET backend (без пункта в контекстном меню). Используйте **Find Action** (Ctrl+Shift+A / Cmd+Shift+A) → «Generate TypeScript Definition». Или явно: `./build-rider-plugin.sh --dotnet-only`.
+---
 
-**С Java 17:** скрипт автоматически ищет Java 17 (Homebrew). Или задайте явно:
-```bash
-export JAVA_HOME=$(/usr/libexec/java_home -v 17)   # macOS
-./build-rider-plugin.sh Release 1.0.0
+#### Windows
+
+**Как установить предварительные требования (только для Варианта 1):**
+
+1. **Разрешить выполнение PowerShell-скриптов** (если ещё не разрешено):  
+   Откройте PowerShell и выполните:  
+   `Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned`
+
+2. **Установить Java 17+:**  
+   - Установите [Chocolatey](https://chocolatey.org/install) (если ещё нет).  
+   - В PowerShell от имени администратора: `choco install openjdk17`  
+   - Закройте и снова откройте терминал.
+
+3. **Получить `gradlew.bat`** (для полной сборки):  
+   В репозитории есть только `rider\gradlew` (Unix). Нужен `rider\gradlew.bat`:  
+   - Установите [Gradle](https://gradle.org/install/) (или через Chocolatey: `choco install gradle`).  
+   - В терминале: `cd rider`, затем `gradle wrapper`.  
+   - Должен появиться `gradlew.bat`. Если не получается — собирайте **Вариант 2** (`--dotnet-only`).
+
+| Вариант | Команда | Результат |
+|--------|---------|-----------|
+| **1 (полная)** | `.\build-rider-plugin.ps1 Release 1.0.0` | Контекстное меню + Find Action |
+| **2 (только .NET)** | `.\build-rider-plugin.ps1 --dotnet-only` | Только Find Action |
+
+Архив плагина: `output\TypeScriptDefinitionGenerator.Rider-<version>.zip`
+
+---
+
+#### macOS
+
+**Как установить предварительные требования (только для Варианта 1):**
+
+1. **Установить Java 17+:**  
+   - Через Homebrew: `brew install openjdk@17`  
+   - Или скачайте [Eclipse Temurin 17](https://adoptium.net/) / [Oracle JDK 17](https://www.oracle.com/java/technologies/downloads/#java17) и установите вручную.
+
+2. **Указать Java 17 для сборки** (если установлено несколько версий):  
+   `export JAVA_HOME=$(/usr/libexec/java_home -v 17)`  
+   Проверка: `java -version` — должна быть 17 или выше.
+
+| Вариант | Команда | Результат |
+|--------|---------|-----------|
+| **1 (полная)** | `./build-rider-plugin.sh Release 1.0.0` | Контекстное меню + Find Action |
+| **2 (только .NET)** | `./build-rider-plugin.sh --dotnet-only` | Только Find Action |
+
+Архив плагина: `output/TypeScriptDefinitionGenerator.Rider-<version>.zip`
+
+---
+
+#### Linux
+
+Скрипт `./build-rider-plugin.sh`, те же два варианта (таблица как для macOS).
+
+**Как установить предварительные требования (только для Варианта 1):**  
+Установите Java 17+ из пакетного менеджера (например `sudo apt install openjdk-17-jdk` или аналог). При нескольких версиях Java задайте `export JAVA_HOME=/path/to/jdk-17`.
+
+---
+
+### Ошибка SSL при загрузке Gradle и зависимостей (Windows / корпоративный прокси)
+
+Если при запуске `gradlew.bat` или сборке плагина появляется **SSLHandshakeException** / **PKIX path building failed: unable to find valid certification path to requested target**, значит JVM не доверяет сертификату (часто из‑за корпоративного прокси или своей CA). Та же ошибка возникает при загрузке **дистрибутива Gradle** (services.gradle.org) и при разрешении **зависимостей** (plugins.gradle.org, mavenCentral()). Сообщение «What went wrong: 25» без деталей — это та же SSL-ошибка: запустите `.\gradlew.bat buildPlugin --stacktrace`, чтобы увидеть полный текст.
+
+**Вариант 1 — добавить сертификат в хранилище Java (рекомендуется):**  
+Без этого не будут работать ни загрузка Gradle, ни разрешение зависимостей (IntelliJ plugin, Kotlin и т.д.).
+
+1. Скачайте корневой сертификат вашей сети (или экспортируйте из браузера с https://services.gradle.org или https://plugins.gradle.org) в файл, например `gradle-ca.cer`.
+
+2. **Windows** — откройте **cmd от имени администратора** (ПКМ по cmd → «Запуск от имени администратора»), перейдите в папку, где лежит `gradle-org.cer` (или укажите полный путь к файлу), и выполните (подставьте свой путь к JDK и к файлу сертификата):
+   ```bat
+   set JAVA_HOME=C:\Program Files\Eclipse Adoptium\jdk-17
+   set CER_FILE=C:\full\path\to\gradle-org.cer
+
+   rem Если alias "gradle" уже есть — удалите: keytool -delete -alias gradle -keystore "%JAVA_HOME%\lib\security\cacerts" -storepass changeit
+
+   "%JAVA_HOME%\bin\keytool" -importcert -alias gradle -file "%CER_FILE%" -keystore "%JAVA_HOME%\lib\security\cacerts" -storepass changeit
+   ```
+   **Скрипт-помощник:** в папке `rider` лежит `import-ssl-cert.bat`. Запустите **cmd от имени администратора**, задайте `JAVA_HOME` и выполните:  
+   `rider\import-ssl-cert.bat C:\full\path\to\gradle-org.cer`  
+   В **PowerShell** вызывайте так (через cmd):  
+   `cmd /c "`"rider\import-ssl-cert.bat`" `"C:\path\to\gradle-org.cer`""`  
+   Скрипт проверит пути и выведет ошибку keytool, если что-то не так.
+
+   **Если не срабатывает:** (1) Убедитесь, что `JAVA_HOME` указывает на тот же JDK, которым пользуется Gradle. (2) Пароль хранилища по умолчанию — `changeit`; если keytool пишет «Password verification failed», укажите правильный `-storepass` или пустой `-storepass ""`. (3) Файл сертификата — PEM или DER (.cer/.pem). (4) Ошибка «access denied» — запустите cmd от имени администратора.
+
+   **Сертификат импортирован, но Gradle всё равно PKIX:** Gradle может запускаться под другим JDK. Используйте **локальный truststore** в проекте:
+   1. В cmd: `cmd /c "rider\create-truststore.bat C:\path\to\gradle-org.cer"` (подставьте путь к .cer). Создадутся `rider\gradle-truststore.jks` и `rider\gradle-local.properties`.
+   2. В папке rider: `gradlew.bat --stop`, затем `gradlew.bat buildPlugin`.
+
+3. **macOS / Linux:**
+   ```bash
+   sudo "$JAVA_HOME/bin/keytool" -importcert -alias gradle -file gradle-ca.cer -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit
+   ```
+
+4. Перезапустите терминал и снова запустите `.\gradlew.bat buildPlugin` (или `./gradlew buildPlugin`).
+
+**Вариант 2 — только обойти загрузку дистрибутива Gradle (локальный zip):**  
+Это устраняет SSL только для скачивания Gradle. Разрешение зависимостей (plugins.gradle.org, Maven) по-прежнему идёт по HTTPS, поэтому при корпоративном прокси **всё равно нужен Вариант 1** (добавить CA в Java).
+
+1. На машине с рабочим HTTPS скачайте [gradle-8.13-bin.zip](https://services.gradle.org/distributions/gradle-8.13-bin.zip) и сохраните локально.
+
+2. В файле `rider\gradle\wrapper\gradle-wrapper.properties` замените `distributionUrl` на локальный путь, например:
+   ```properties
+   distributionUrl=file\:///C:/Users/YourName/gradle-8.13-bin.zip
+   ```
+
+3. Запустите снова `.\gradlew.bat buildPlugin`. Если снова появится PKIX/SSL при загрузке плагинов — добавьте CA в Java (Вариант 1).
+
+**Сборка падает с «What went wrong: 25» или другой неочевидной ошибкой:** выполните из папки `rider` команду с полным выводом стека:
+```bat
+.\gradlew.bat buildPlugin --stacktrace
 ```
+По выводу будет видно, какой именно task упал (часто это загрузка IDE SDK по сети или задача `patchPluginXml`). Убедитесь, что есть доступ в интернет и что корпоративный прокси не блокирует Maven/Central/Google (для загрузки зависимостей и IntelliJ runtime). Предупреждения про `System::load` и `--enable-native-access` устраняются через `rider/gradle.properties` (уже добавлены нужные JVM-аргументы).
+
+---
+
+### Установка плагина в Rider
 
-Скрипт собирает .NET backend и при наличии Java 17 — Kotlin frontend (контекстное меню Solution View). Плагин совместим с Rider 2024.1+ (включая Rider 2025.3).
+1. **Соберите плагин** (см. раздел «Сборка плагина» выше). После сборки в папке `output` появится архив:
+   - **Windows:** `output\TypeScriptDefinitionGenerator.Rider-<version>.zip`
+   - **macOS / Linux:** `output/TypeScriptDefinitionGenerator.Rider-<version>.zip`
 
-### Установка
+2. **Установите плагин в Rider:**  
+   - Откройте **Settings** (Ctrl+Alt+S / Cmd+,).  
+   - **Plugins** → нажмите **шестерёнку** (Gear icon) → **Install Plugin from Disk…**  
+   - Выберите файл `TypeScriptDefinitionGenerator.Rider-<version>.zip` из папки `output`.  
+   - Нажмите **OK**, затем **Restart IDE**.
 
-1. Соберите плагин (см. выше)
-2. В Rider: **Settings** → **Plugins** → **Gear icon** → **Install Plugin from Disk**
-3. Выберите `output/TypeScriptDefinitionGenerator.Rider-<version>.zip`
-4. Перезапустите Rider
+3. После перезапуска плагин готов к работе (контекстное меню по .cs или **Find Action** → «Generate TypeScript Definition»).
 
 ### Настройки
 

README.md

@@ -123,11 +123,22 @@ dotnet add package TypeScriptDefinitionGenerator.MSBuild
 
 Для использования в Rider см. [README-RIDER.md](README-RIDER.md) — плагин с контекстным меню, External Tool или dotnet tool для генерации .d.ts файлов.
 
-## Сборка расширения
+## Сборка расширения (VSIX)
 
-Расширение использует SDK-style проект (PackageReference). Сборка возможна **только на Windows** с установленной Visual Studio 2022, т.к. VSSDK требует vsct.exe для компиляции меню.
+Сборка возможна **только на Windows** с установленной Visual Studio 2022 (VSSDK требует vsct.exe и т.д.).
 
-При сборке через `dotnet build` для проекта Visual Studio Extension (VSIX) требуется **.NET 8 SDK**: `global.json` в корне репозитория привязывает сборку к SDK 8.0.x (из‑за ограничений VSSDK.BuildTools на .NET 10+). Установите [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0) или собирайте расширение из Visual Studio (Build Solution).
+**Рекомендуемый способ:** запустите скрипт в PowerShell (использует MSBuild из VS и избегает проблем с `dotnet build`):
+
+```powershell
+.\build-vsix.ps1        # Debug
+.\build-vsix.ps1 Release
+```
+
+Готовый VSIX будет в `src\TypeScriptDefinitionGenerator\bin\<Configuration>\net472\*.vsix`.
+
+**Установка VSIX на Windows:** дважды щёлкните по файлу `.vsix` или в Visual Studio: **Extensions** → **Manage Extensions** → **Install from VSIX** и укажите собранный файл.
+
+**Альтернатива:** откройте решение в Visual Studio и выполните **Build Solution**. При сборке через `dotnet build` нужен **.NET 8 SDK**: в корне репозитория задан `global.json` для SDK 8.0.x. Установите [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0) при необходимости.
 
 ## Contribute
 Check out the [contribution guidelines](.github/CONTRIBUTING.md)

TypeScriptDefinitionGenerator.slnx

@@ -18,6 +18,8 @@
     <File Path="publish-marketplace.ps1" />
     <File Path="README-RIDER.md" />
     <File Path="README.md" />
+    <File Path="rider/gradlew" />
+    <File Path="rider/gradlew.bat" />
     <File Path="vs-publish.json" />
   </Folder>
   <Project Path="src/TypeScriptDefinitionGenerator.Cli/TypeScriptDefinitionGenerator.Cli.csproj" />

gradle.org.crt

@@ -0,0 +1,22 @@
+-----BEGIN CERTIFICATE-----
+MIIDnzCCA0agAwIBAgIQPOIJVcuRvxsNB8+akoqHFjAKBggqhkjOPQQDAjA7MQsw
+CQYDVQQGEwJVUzEeMBwGA1UEChMVR29vZ2xlIFRydXN0IFNlcnZpY2VzMQwwCgYD
+VQQDEwNXRTEwHhcNMjYwMTE4MDEyNTMwWhcNMjYwNDE4MDIyNTI5WjAVMRMwEQYD
+VQQDEwpncmFkbGUub3JnMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE7pn8WiG4
+Ds1ksxs85Ux2Jt2TV7d5ZpqvLahqsmy7Lz2hQZryXPz8DZMCSrUPF/5vHWffoFLP
+d9A9Y69UNg3aTqOCAlAwggJMMA4GA1UdDwEB/wQEAwIHgDATBgNVHSUEDDAKBggr
+BgEFBQcDATAMBgNVHRMBAf8EAjAAMB0GA1UdDgQWBBRp1bHTc3Kz4UO1JK3PMvho
+3u0dQzAfBgNVHSMEGDAWgBSQd5I1Z8T/qMyp5nvZgHl7zJP5ODBeBggrBgEFBQcB
+AQRSMFAwJwYIKwYBBQUHMAGGG2h0dHA6Ly9vLnBraS5nb29nL3Mvd2UxL1BPSTAl
+BggrBgEFBQcwAoYZaHR0cDovL2kucGtpLmdvb2cvd2UxLmNydDAjBgNVHREEHDAa
+ggpncmFkbGUub3JnggwqLmdyYWRsZS5vcmcwEwYDVR0gBAwwCjAIBgZngQwBAgEw
+NgYDVR0fBC8wLTAroCmgJ4YlaHR0cDovL2MucGtpLmdvb2cvd2UxL18tNGlGd2ZD
+YWNNLmNybDCCAQMGCisGAQQB1nkCBAIEgfQEgfEA7wB1AGQRxGykEuyniRyiAi4A
+vKtPKAfUHjUnq+r+1QPJfc3wAAABm87r/sQAAAQDAEYwRAIgd0rYbkdDm/O/CXmn
+yvmjbO+eIYRB9K9gZftBb00FANACIFUMinN61Z1ZK0nZB7JJ7NZAkH/40b5pKle5
+6CvoJI/NAHYAlpdkv1VYl633Q4doNwhCd+nwOtX2pPM2bkakPw/KqcYAAAGbzuv+
+1AAABAMARzBFAiEAwYrsQtZWl4jqKmc5AlBYhHrbvJf/gSvmlnplv5TVZvwCIBSe
+P/maQprDS/kNLlYDw3TVWzT6LZAepAOzZB6v0mE8MAoGCCqGSM49BAMCA0cAMEQC
+IDrHC+4kI8wAl2ggsQH9rfagT0s+xyvogy/9tISdgbcyAiA9FppiWYCK6tUYWC4K
+5dDtapnKnrV4XcNJ/labNewE4g==
+-----END CERTIFICATE-----

rider/README.md

@@ -5,18 +5,27 @@
 ## Требования
 
 - **Java 17+** — IntelliJ Platform Gradle Plugin 2.x требует Java 17
-- Gradle 8.13+ (через `./gradlew`)
+- Gradle 8.13+ (через `./gradlew` или на Windows — `gradlew.bat`)
 
 ## Сборка
 
+**Из корня репозитория** (рекомендуется): используйте `./build-rider-plugin.sh` (macOS/Linux) или `.\build-rider-plugin.ps1` (Windows) — они соберут и .NET, и Kotlin, и упакуют плагин в `output/TypeScriptDefinitionGenerator.Rider-<version>.zip`.
+
+**Только Kotlin (из этой папки):**
+
 ```bash
 # Убедитесь, что используется Java 17+
 java -version   # должно быть 17 или выше
 
 # Если Java 8/11 — задайте JAVA_HOME:
 export JAVA_HOME=/path/to/jdk-17   # macOS: $(/usr/libexec/java_home -v 17)
+# Windows: choco install openjdk17
 
-./gradlew buildPlugin
+./gradlew buildPlugin   # macOS/Linux
+# или на Windows, если есть gradlew.bat:
+.\gradlew.bat buildPlugin
 ```
 
 Выход: `build/distributions/TypeScriptDefinitionGenerator.Rider-1.0.0.zip`
+
+**Ошибка SSL (unable to find valid certification path):** часто из‑за корпоративного прокси. Решения: добавить CA-сертификат в Java `cacerts` через `keytool` или скачать [gradle-8.13-bin.zip](https://services.gradle.org/distributions/gradle-8.13-bin.zip) вручную и в `gradle/wrapper/gradle-wrapper.properties` задать `distributionUrl=file\:///C:/path/to/gradle-8.13-bin.zip`. Подробнее — в [README-RIDER.md](../README-RIDER.md) (раздел «Ошибка SSL при первой загрузке Gradle»).