gitverse-release 3.6.0 → 3.7.0

package/README.md

@@ -340,7 +340,7 @@ npx gitverse-release publish-binaries
 {
   "binaries": {
     "enabled": true,
-    "scope": "@rainypixel",           // npm scope
+    "scope": "@rainypixel",           // npm scope (опционально)
     "name": "yougile",                 // базовое имя пакетов
     "binName": "yougile",              // имя бинарника в $PATH (опционально)
     "distDir": "./dist",               // директория с бинарниками
@@ -360,9 +360,58 @@ npx gitverse-release publish-binaries
 }
 ```
 
+### Пакеты без scope
+
+`scope` опционален. Без него пакеты публикуются как `myapp-linux-x64` вместо `@org/myapp-linux-x64`:
+
+```jsonc
+{
+  "binaries": {
+    "enabled": true,
+    "name": "myapp",                   // без scope!
+    "distDir": "./dist",
+    "platforms": ["linux-x64", "darwin-arm64"]
+  }
+}
+// Результат: myapp-linux-x64, myapp-darwin-arm64
+```
+
+### Кастомный шаблон имени пакета
+
+Используйте `packageNameTemplate` для гибкой настройки имён:
+
+```jsonc
+{
+  "binaries": {
+    "name": "myapp",
+    "packageNameTemplate": "{{name}}-bin-{{platform}}"
+  }
+}
+// Результат: myapp-bin-linux-x64
+```
+
+```jsonc
+{
+  "binaries": {
+    "name": "myapp",
+    "scope": "@org",
+    "packageNameTemplate": "@{{scope}}/{{name}}-cli-{{platform}}"
+  }
+}
+// Результат: @org/myapp-cli-linux-x64
+```
+
+**Плейсхолдеры:** `{{scope}}`, `{{name}}`, `{{platform}}`
+
+**Дефолтные шаблоны:**
+- Без scope: `{{name}}-{{platform}}`
+- Со scope: `@{{scope}}/{{name}}-{{platform}}`
+
 ### Структура бинарников
 
-Бинарники должны находиться в `distDir` в формате:
+#### Формат "directory" (по умолчанию)
+
+Бинарники в директориях:
 
 ```
 dist/
@@ -374,6 +423,37 @@ dist/
     yougile.exe        # бинарник для Windows
 ```
 
+#### Формат "tar.gz"
+
+Бинарники в tar.gz архивах (удобно для CI артефактов):
+
+```jsonc
+{
+  "binaries": {
+    "inputFormat": "tar.gz",
+    "sourceBinName": "cli",            // имя бинарника внутри архива
+    "platformMap": {                    // маппинг имён архивов на платформы
+      "linux-amd64": "linux-x64",
+      "darwin-arm64": "darwin-arm64",
+      "windows-x64": "win32-x64"
+    }
+  }
+}
+```
+
+Структура архивов:
+```
+dist/
+  myapp-linux-amd64.tar.gz    # содержит cli (или cli внутри поддиректории)
+  myapp-darwin-arm64.tar.gz
+  myapp-windows-x64.tar.gz
+```
+
+**Опции для tar.gz:**
+- `inputFormat: "tar.gz"` — включает режим архивов
+- `sourceBinName` — имя бинарника внутри архива (если отличается от `name`)
+- `platformMap` — маппинг ключей в именах архивов на npm платформы
+
 ### Генерируемая структура
 
 ```