@vv0rkz/js-template 1.7.0 → 1.8.2

package/templates/.husky/post-commit

@@ -1,25 +1,3 @@
-#!/usr/bin/env sh
-
-COMMIT_MSG=$(git log -1 --pretty=%B)
-COMMIT_HASH=$(git rev-parse --short HEAD)
-REPO_URL=$(git remote get-url origin)
-
-# Исправляем URL
-if echo "$REPO_URL" | grep -q "git@github.com"; then
-    REPO_URL=$(echo "$REPO_URL" | sed 's/git@github.com:/https:\/\/github.com\//' | sed 's/\.git$//')
-else
-    REPO_URL=$(echo "$REPO_URL" | sed 's/\.git$//')
-fi
-
-# Пуш коммита
-git push origin HEAD
-
-# Закрытие issues при feat: #номер И fix: #номер
-if echo "$COMMIT_MSG" | grep -q "^\(feat\|fix\): #[0-9]"; then
-    ISSUE_NUMBER=$(echo "$COMMIT_MSG" | grep -o '#[0-9]*' | sed 's/#//')
-    echo "🔧 Закрываю issue #$ISSUE_NUMBER..."
-    
-    COMMIT_LINK="$REPO_URL/commit/$COMMIT_HASH"
-    
-    gh issue close "$ISSUE_NUMBER" --comment "✅ Завершено в коммите: [$COMMIT_HASH]($COMMIT_LINK) - $COMMIT_MSG"
-fi
+#!/usr/bin/env sh
+
+node ./node_modules/@vv0rkz/js-template/tools-gh/post-commit-hook.js

package/templates/.husky/pre-push

@@ -1,17 +1,3 @@
-#!/usr/bin/env sh
-
-CURRENT_BRANCH=$(git branch --show-current)
-if [ "$CURRENT_BRANCH" = "main" ]; then
-    echo "✅ Разрешённая ветка: $CURRENT_BRANCH"
-    exit 0
-fi
-
-# Простая проверка: начинается с v и есть дефис
-if ! echo "$CURRENT_BRANCH" | grep -q "^v.*-.*"; then
-    echo "❌ Неправильный формат ветки: $CURRENT_BRANCH"
-    echo "✅ Должен быть: vX.Y.Z-description"
-    echo "📝 Пример: v2.3.0-normalize-operators"
-    exit 1
-fi
-
-echo "✅ Формат ветки правильный: $CURRENT_BRANCH"
+#!/usr/bin/env sh
+
+node ./node_modules/@vv0rkz/js-template/tools-gh/validate-branch.js

package/templates/changelog.config.js

@@ -1,9 +1,16 @@
-export default {
-  types: {
-    feat: { title: '✨ Новые фичи', semver: 'minor' },
-    fix: { title: '🐛 Исправления', semver: 'patch' },
-    refactor: { title: '♻️ Рефакторинг', semver: 'patch' },
-    perf: { title: '⚡ Оптимизация', semver: 'patch' },
-  },
-  contributors: false,
-}
+let changelogTypes = {
+  feat: { title: '✨ Новые фичи', semver: 'minor' },
+  fix: { title: '🐛 Исправления', semver: 'patch' },
+  refactor: { title: '♻️ Рефакторинг', semver: 'patch' },
+  perf: { title: '⚡ Оптимизация', semver: 'patch' },
+}
+
+try {
+  const { default: config } = await import('./jst.config.js')
+  if (config.changelog?.types) changelogTypes = config.changelog.types
+} catch {}
+
+export default {
+  types: changelogTypes,
+  contributors: false,
+}

package/templates/commitlint.config.js

@@ -1,6 +1,13 @@
-export default {
-    extends: ["@commitlint/config-conventional"],
-    rules: {
-        "type-enum": [2, "always", ["feat", "fix", "refactor", "build", "chore", "docs"]],
-    },
-}
+let types = ['feat', 'fix', 'refactor', 'build', 'chore', 'docs', 'perf']
+
+try {
+  const { default: config } = await import('./jst.config.js')
+  if (config.commits?.types) types = config.commits.types
+} catch {}
+
+export default {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [2, 'always', types],
+  },
+}

package/templates/jst.config.js

@@ -0,0 +1,120 @@
+/**
+ * JST Configuration
+ * Документация: https://github.com/vv0rkz/js-template
+ *
+ * Все значения ниже — дефолтные. Измени нужные или закомментируй.
+ */
+export default {
+  /**
+   * Правила именования веток
+   */
+  branch: {
+    /** Имя главной ветки ('main' | 'master') */
+    main: 'main',
+
+    /**
+     * Допустимые форматы веток (массив шаблонов)
+     *
+     * Плейсхолдеры:
+     *   {version}  → семвер (X.Y.Z)
+     *   {issue}    → номер issue (цифры)
+     *   {name}     → описание (буквы, цифры, дефисы, подчёркивания)
+     *   *          → что угодно
+     *
+     * Примеры наборов:
+     *
+     *   ['v{version}-{name}']
+     *     ✅ v2.3.0-normalize-operators
+     *
+     *   ['release/v{version}', 'feature/#{issue}-{name}', 'fix/#{issue}-{name}']
+     *     ✅ release/v2.3.0
+     *     ✅ feature/#12-dark-theme
+     *     ✅ fix/#7-validation-bug
+     *
+     *   ['feature/*', 'fix/*', 'release/*']
+     *     ✅ feature/anything-goes-here
+     *     ✅ fix/urgent-patch
+     *
+     *   ['*']
+     *     ✅ любое имя (без ограничений)
+     */
+    patterns: ['v{version}-{name}'],
+  },
+
+  /**
+   * GitHub Labels
+   * Используются при `jst setup-labels` и `jst create-*`
+   *
+   * Цвета — 6-символьный hex без #
+   */
+  labels: [
+    { name: 'task', color: '0E8A16', description: 'Новая фича', emoji: '✨' },
+    { name: 'bug', color: 'D73A4A', description: 'Баг', emoji: '🐛' },
+    { name: 'refactor', color: 'FEF2C0', description: 'Рефакторинг/техдолг', emoji: '♻️' },
+    { name: 'perf', color: '007bff', description: 'Оптимизация производительности', emoji: '⚡' },
+  ],
+
+  /**
+   * Правила коммитов
+   */
+  commits: {
+    /**
+     * Разрешённые типы коммитов
+     * Должны совпадать с commitlint и changelog
+     */
+    types: ['feat', 'fix', 'refactor', 'build', 'chore', 'docs', 'perf'],
+
+    /**
+     * Типы, требующие номер issue (#N)
+     * Остальные типы — свободный формат
+     */
+    requireIssue: ['feat', 'fix'],
+
+    /**
+     * Ключевое слово для закрытия issue в коммите
+     *
+     * С ним:  feat: close #9 описание  → закроет issue #9
+     * Без:    feat: #9 описание        → просто ссылка, issue остаётся открытым
+     */
+    closeKeyword: 'close',
+  },
+
+  /**
+   * Настройки релиза (`jst release`)
+   */
+  release: {
+    /** Требовать GIF/PNG демо перед релизом (true | false) */
+    requireDemo: true,
+
+    /** Директория для демо-файлов */
+    demoDir: 'docs',
+
+    /** Допустимые форматы демо-файлов */
+    demoFormats: ['gif', 'png'],
+  },
+
+  /**
+   * Настройки changelog (changelogen)
+   * title — заголовок секции в CHANGELOG.md
+   * semver — тип версионирования ('major' | 'minor' | 'patch')
+   */
+  changelog: {
+    types: {
+      feat: { title: '✨ Новые фичи', semver: 'minor' },
+      fix: { title: '🐛 Исправления', semver: 'patch' },
+      refactor: { title: '♻️ Рефакторинг', semver: 'patch' },
+      perf: { title: '⚡ Оптимизация', semver: 'patch' },
+    },
+  },
+
+  /**
+   * Автообновление зависимостей
+   * @type {'dependabot' | 'renovate' | false}
+   *
+   * 'dependabot' — создаст .github/dependabot.yml
+   * 'renovate'   — создаст renovate.json
+   * false        — отключено
+   */
+  depUpdater: false,
+
+}

package/tools-gh/check-demo-for-release.js

@@ -1,30 +1,36 @@
-#!/usr/bin/env node
-import { readFileSync, existsSync } from "fs"
-import { execSync } from "child_process"
-
-// Читаем текущую версию
-const packageJson = JSON.parse(readFileSync("package.json", "utf8"))
-const [major, minor, patch] = packageJson.version.split(".").map(Number)
-
-// Анализируем коммиты чтобы определить тип версии
-const commitMessages = execSync("git log --oneline -10", { encoding: "utf8" })
-
-let nextVersion
-if (commitMessages.includes("feat:")) {
-    nextVersion = `v${major}.${minor + 1}.0` // minor release
-} else {
-    nextVersion = `v${major}.${minor}.${patch + 1}` // patch release
-}
-
-console.log(`📦 Предполагаемая следующая версия: ${nextVersion}`)
-
-// Проверяем демо
-const hasDemo = existsSync(`docs/${nextVersion}.gif`) || existsSync(`docs/${nextVersion}.png`)
-
-if (!hasDemo) {
-    console.log(`❌ Релиз ${nextVersion} требует демо!`)
-    console.log(`📸 Создай: docs/${nextVersion}.gif`)
-    process.exit(1)
-}
-
-console.log(`✅ Демо для ${nextVersion} готово!`)
+#!/usr/bin/env node
+import { existsSync, readFileSync } from 'fs'
+import { execSync } from 'child_process'
+import { loadConfig } from './config.js'
+
+const config = await loadConfig()
+
+if (!config.release.requireDemo) {
+  console.log('⏭️  Проверка демо отключена')
+  process.exit(0)
+}
+
+const packageJson = JSON.parse(readFileSync('package.json', 'utf8'))
+const [major, minor, patch] = packageJson.version.split('.').map(Number)
+
+const commitMessages = execSync('git log --oneline -10', { encoding: 'utf8' })
+
+let nextVersion
+if (commitMessages.includes('feat:')) {
+  nextVersion = `v${major}.${minor + 1}.0`
+} else {
+  nextVersion = `v${major}.${minor}.${patch + 1}`
+}
+
+console.log(`📦 Предполагаемая следующая версия: ${nextVersion}`)
+
+const { demoDir, demoFormats } = config.release
+const hasDemo = demoFormats.some((fmt) => existsSync(`${demoDir}/${nextVersion}.${fmt}`))
+
+if (!hasDemo) {
+  console.log(`❌ Релиз ${nextVersion} требует демо!`)
+  console.log(`📸 Создай: ${demoDir}/${nextVersion}.${demoFormats[0]}`)
+  process.exit(1)
+}
+
+console.log(`✅ Демо для ${nextVersion} готово!`)

package/tools-gh/config.js

@@ -0,0 +1,125 @@
+import { existsSync, readFileSync } from 'fs'
+import { join } from 'path'
+import { pathToFileURL } from 'url'
+
+const DEFAULTS = {
+  branch: {
+    main: 'main',
+    patterns: ['v{version}-{name}'],
+  },
+  labels: [
+    { name: 'task', color: '0E8A16', description: 'Новая фича', emoji: '✨' },
+    { name: 'bug', color: 'D73A4A', description: 'Баг', emoji: '🐛' },
+    { name: 'refactor', color: 'FEF2C0', description: 'Рефакторинг/техдолг', emoji: '♻️' },
+    { name: 'perf', color: '007bff', description: 'Оптимизация производительности', emoji: '⚡' },
+  ],
+  commits: {
+    types: ['feat', 'fix', 'refactor', 'build', 'chore', 'docs', 'perf'],
+    requireIssue: ['feat', 'fix'],
+    closeKeyword: 'close',
+  },
+  release: {
+    requireDemo: true,
+    demoDir: 'docs',
+    demoFormats: ['gif', 'png'],
+  },
+  changelog: {
+    types: {
+      feat: { title: '✨ Новые фичи', semver: 'minor' },
+      fix: { title: '🐛 Исправления', semver: 'patch' },
+      refactor: { title: '♻️ Рефакторинг', semver: 'patch' },
+      perf: { title: '⚡ Оптимизация', semver: 'patch' },
+    },
+  },
+  depUpdater: false,
+}
+
+// --- Branch pattern template engine ---
+
+const BRANCH_PLACEHOLDERS = {
+  '{version}': '\\d+\\.\\d+\\.\\d+',
+  '{issue}': '\\d+',
+  '{name}': '[a-zA-Z0-9_-]+',
+}
+
+function compileTemplate(template) {
+  const parts = template.split(/(\{[a-z]+\}|\*)/g)
+  return parts
+    .map((part) => {
+      if (BRANCH_PLACEHOLDERS[part]) return BRANCH_PLACEHOLDERS[part]
+      if (part === '*') return '.+'
+      return part.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+    })
+    .join('')
+}
+
+/**
+ * Compiles branch config into a RegExp.
+ * Supports template patterns (new) and raw regex (legacy).
+ *
+ * Templates:
+ *   {version}  → X.Y.Z (semver)
+ *   {issue}    → issue number (digits)
+ *   {name}     → branch description (letters, digits, hyphens, underscores)
+ *   *          → anything
+ */
+export function compileBranchRegex(branchConfig) {
+  if (branchConfig.patterns && Array.isArray(branchConfig.patterns)) {
+    const compiled = branchConfig.patterns.map(compileTemplate)
+    return new RegExp(`^(${compiled.join('|')})$`)
+  }
+
+  if (branchConfig.pattern) {
+    return new RegExp(branchConfig.pattern)
+  }
+
+  return new RegExp('^v.*-.*')
+}
+
+// --- Deep merge ---
+
+function deepMerge(target, source) {
+  const result = { ...target }
+  for (const key of Object.keys(source)) {
+    if (
+      source[key] &&
+      typeof source[key] === 'object' &&
+      !Array.isArray(source[key]) &&
+      target[key] &&
+      typeof target[key] === 'object' &&
+      !Array.isArray(target[key])
+    ) {
+      result[key] = deepMerge(target[key], source[key])
+    } else {
+      result[key] = source[key]
+    }
+  }
+  return result
+}
+
+/**
+ * Loads config from jst.config.js (preferred) or jst.config.json (fallback)
+ * Deep-merges user config with defaults
+ */
+export async function loadConfig() {
+  const jsPath = join(process.cwd(), 'jst.config.js')
+  const jsonPath = join(process.cwd(), 'jst.config.json')
+  let userConfig = {}
+
+  if (existsSync(jsPath)) {
+    try {
+      const mod = await import(pathToFileURL(jsPath).href)
+      userConfig = mod.default || {}
+    } catch (e) {
+      console.warn('⚠️  Ошибка чтения jst.config.js:', e.message)
+    }
+  } else if (existsSync(jsonPath)) {
+    try {
+      userConfig = JSON.parse(readFileSync(jsonPath, 'utf8'))
+    } catch (e) {
+      console.warn('⚠️  Ошибка чтения jst.config.json:', e.message)
+    }
+  }
+
+  return deepMerge(DEFAULTS, userConfig)
+}

package/tools-gh/post-commit-hook.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { execSync } from 'child_process'
+import { loadConfig } from './config.js'
+
+const config = await loadConfig()
+const { closeKeyword, requireIssue } = config.commits
+
+const commitMsg = execSync('git log -1 --pretty=%B', { encoding: 'utf8' }).trim()
+const commitHash = execSync('git rev-parse --short HEAD', { encoding: 'utf8' }).trim()
+
+let repoUrl = execSync('git remote get-url origin', { encoding: 'utf8' }).trim()
+if (repoUrl.startsWith('git@github.com:')) {
+  repoUrl = repoUrl.replace('git@github.com:', 'https://github.com/').replace(/\.git$/, '')
+} else {
+  repoUrl = repoUrl.replace(/\.git$/, '')
+}
+
+execSync('git push origin HEAD', { stdio: 'inherit' })
+
+const escClose = closeKeyword.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+const typesGroup = requireIssue.join('|')
+const closePattern = new RegExp(`^(${typesGroup})(\\(.+\\))?: ${escClose} #(\\d+)`)
+const match = commitMsg.match(closePattern)
+
+if (match) {
+  const issueNumber = match[3]
+  const commitLink = `${repoUrl}/commit/${commitHash}`
+  const firstLine = commitMsg.split('\n')[0]
+
+  console.log(`🔧 Закрываю issue #${issueNumber}...`)
+
+  try {
+    execSync(
+      `gh issue close "${issueNumber}" --comment "✅ Завершено в коммите: [${commitHash}](${commitLink}) - ${firstLine}"`,
+      { stdio: 'inherit' },
+    )
+  } catch {
+    console.log(`⚠️  Не удалось закрыть issue #${issueNumber}`)
+  }
+}