@vv0rkz/js-template 1.8.3 → 1.8.4

package/README.md

@@ -52,16 +52,16 @@ export default {
 
   // Релиз
   release: {
-    requireDemo: true,               // требовать GIF/PNG перед релизом
-    demoDir: 'docs',                 // где искать демо
-    demoFormats: ['gif', 'png'],
+    demo: {
+      enable: true,                  // требовать демо перед релизом
+      dir: 'docs',                   // где искать демо-файлы
+      formats: ['gif', 'png'],       // допустимые форматы
+      style: 'click',                // 'click' | 'side-by-side'
+    },
   },
 
   // Автообновление зависимостей
   depUpdater: false,                 // 'dependabot' | 'renovate' | false
-
-  // Репозиторий JST для report-issue
-  jstRepo: 'vv0rkz/js-template',
 }
 ```
 
@@ -219,6 +219,33 @@ npm run _ push-release
 - [Changelogen](https://github.com/unjs/changelogen) — Генерация changelog
 - [GitHub CLI](https://cli.github.com/) — Управление issues
 
+## Migration Guide
+
+### v1.9.0 — `release.demo` (breaking change)
+
+Настройки демо переехали из плоского `release.*` в объект `release.demo`:
+
+```js
+// ❌ Было (до v1.9.0)
+release: {
+  requireDemo: true,
+  demoDir: 'docs',
+  demoFormats: ['gif', 'png'],
+}
+
+// ✅ Стало
+release: {
+  demo: {
+    enable: true,
+    dir: 'docs',
+    formats: ['gif', 'png'],
+    style: 'click',   // новая опция: 'click' | 'side-by-side'
+  },
+}
+```
+
+Если в `jst.config.js` остались старые ключи, при запуске любой `jst`-команды появится предупреждение с инструкцией по миграции.
+
 ## Лицензия
 
 MIT © [vv0rkz](https://github.com/vv0rkz)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vv0rkz/js-template",
-  "version": "1.8.3",
+  "version": "1.8.4",
   "description": "Reusable setup for JS projects with husky, changelog, gh tools",
   "type": "module",
   "bin": {

package/tools-gh/config.js

@@ -100,6 +100,35 @@ function deepMerge(target, source) {
   return result
 }
 
+/**
+ * Checks for deprecated config keys and prints migration warnings.
+ * Old flat release.* keys were moved to release.demo.* in v1.9.0.
+ */
+function warnDeprecatedKeys(userConfig) {
+  const deprecated = [
+    { old: 'release.requireDemo', newKey: 'release.demo.enable' },
+    { old: 'release.demoDir',     newKey: 'release.demo.dir' },
+    { old: 'release.demoFormats', newKey: 'release.demo.formats' },
+  ]
+
+  const found = deprecated.filter(({ old }) => {
+    const [top, key] = old.split('.')
+    return userConfig[top]?.[key] !== undefined
+  })
+
+  if (found.length === 0) return
+
+  console.warn('\n⚠️  jst.config.js: устаревшие настройки (обнови конфиг)\n')
+  found.forEach(({ old, newKey }) => {
+    console.warn(`   ${old}  →  ${newKey}`)
+  })
+  console.warn('\n   Было:')
+  console.warn('     release: { requireDemo, demoDir, demoFormats }')
+  console.warn('\n   Стало (начиная с v1.9.0):')
+  console.warn('     release: { demo: { enable, dir, formats, style } }')
+  console.warn('\n   Запусти: npm run _ upgrade  — чтобы получить актуальный конфиг\n')
+}
+
 /**
  * Loads config from jst.config.js (preferred) or jst.config.json (fallback)
  * Deep-merges user config with defaults
@@ -124,5 +153,7 @@ export async function loadConfig() {
     }
   }
 
+  warnDeprecatedKeys(userConfig)
+
   return deepMerge(DEFAULTS, userConfig)
 }