create-nadvan-app 1.0.0

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "create-nadvan-app",
+  "version": "1.0.0",
+  "description": "Официальный scaffolder для frontend-проектов Nadvan",
+  "type": "module",
+  "bin": {
+    "create-nadvan-app": "./src/index.js"
+  },
+  "files": [
+    "src"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": ["nadvan", "create", "frontend", "fsd", "vite", "react"],
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "fs-extra": "^11.2.0",
+    "prompts": "^2.4.2"
+  }
+}

package/src/index.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+
+import { execSync } from 'child_process';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import prompts from 'prompts';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATE_DIR = path.join(__dirname, 'template');
+
+function step(msg)    { console.log(chalk.blue(`\n  → ${msg}`)); }
+function success(msg) { console.log(chalk.green(`  ✓ ${msg}`)); }
+function warn(msg)    { console.log(chalk.yellow(`  ⚠ ${msg}`)); }
+
+async function main() {
+  console.log(chalk.bold('\n┌─────────────────────────────────────────┐'));
+  console.log(chalk.bold('│      Nadvan Frontend Scaffolder         │'));
+  console.log(chalk.bold('└─────────────────────────────────────────┘\n'));
+
+  // Парсим аргументы
+  // Использование: create-nadvan-app my-project [--yes] [--pm=pnpm] [--no-install]
+  const args = process.argv.slice(2);
+  const argName      = args.find((a) => !a.startsWith('-'));
+  const flagYes      = args.includes('--yes') || args.includes('-y');
+  const flagNoInstall = args.includes('--no-install');
+  const flagPm       = (args.find((a) => a.startsWith('--pm=')) ?? '').replace('--pm=', '') || null;
+
+  if (flagYes && !argName) {
+    console.log(chalk.red('  При --yes укажи имя: create-nadvan-app my-project --yes'));
+    process.exit(1);
+  }
+
+  // В неинтерактивном режиме (--yes) пропускаем prompts
+  let answers;
+  if (flagYes) {
+    answers = { pkgManager: flagPm ?? 'npm', install: !flagNoInstall };
+  } else {
+    answers = await prompts(
+      [
+        {
+          type: argName ? null : 'text',
+          name: 'projectName',
+          message: 'Название проекта:',
+          initial: 'my-project',
+          validate: (v) =>
+            /^[a-z0-9][a-z0-9-]*$/.test(v) ||
+            'Только строчные буквы, цифры и дефис',
+        },
+        {
+          type: 'select',
+          name: 'pkgManager',
+          message: 'Менеджер пакетов:',
+          choices: [
+            { title: 'npm',  value: 'npm'  },
+            { title: 'pnpm', value: 'pnpm' },
+            { title: 'yarn', value: 'yarn' },
+          ],
+          initial: 0,
+        },
+        {
+          type: 'confirm',
+          name: 'install',
+          message: 'Установить зависимости сейчас?',
+          initial: true,
+        },
+      ],
+      {
+        onCancel: () => {
+          console.log(chalk.red('\n  Отменено.'));
+          process.exit(1);
+        },
+      },
+    );
+  }
+
+  const projectName  = argName ?? answers.projectName;
+  const { pkgManager, install } = answers;
+  const targetDir = path.resolve(process.cwd(), projectName);
+
+  if (fs.existsSync(targetDir)) {
+    console.log(chalk.red(`\n  Ошибка: папка "${projectName}" уже существует.`));
+    process.exit(1);
+  }
+
+  // ─── 1. Копируем шаблон ──────────────────────────────────────────────────
+  step('Копируем шаблон...');
+  await fs.copy(TEMPLATE_DIR, targetDir);
+  success('Шаблон скопирован');
+
+  // ─── 2. Переименовываем служебные файлы ──────────────────────────────────
+  step('Настраиваем файлы проекта...');
+
+  await fs.move(
+    path.join(targetDir, '_package.json'),
+    path.join(targetDir, 'package.json'),
+  );
+
+  await fs.move(
+    path.join(targetDir, 'gitignore'),
+    path.join(targetDir, '.gitignore'),
+  );
+
+  // ─── 3. Подставляем имя проекта ──────────────────────────────────────────
+  const pkgPath = path.join(targetDir, 'package.json');
+  const pkg = await fs.readJson(pkgPath);
+  pkg.name = projectName;
+  await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+  success(`package.json → name: "${projectName}"`);
+
+  // ─── 4. Права на husky-хуки ──────────────────────────────────────────────
+  try {
+    fs.chmodSync(path.join(targetDir, '.husky', 'pre-commit'), 0o755);
+    fs.chmodSync(path.join(targetDir, '.husky', 'commit-msg'), 0o755);
+  } catch { /* не критично */ }
+
+  // ─── 5. npm install ──────────────────────────────────────────────────────
+  if (install) {
+    step(`Устанавливаем зависимости (${pkgManager} install)...`);
+    try {
+      execSync(`${pkgManager} install`, { cwd: targetDir, stdio: 'inherit' });
+      execSync(`${pkgManager} run prepare`, { cwd: targetDir, stdio: 'inherit' });
+      success('Зависимости установлены');
+    } catch {
+      warn(`${pkgManager} install завершился с ошибкой. Запусти вручную.`);
+    }
+  }
+
+  // ─── Итог ────────────────────────────────────────────────────────────────
+  console.log(chalk.bold.green(`\n  ✅  Проект "${projectName}" создан!\n`));
+  console.log('  Следующие шаги:\n');
+  console.log(chalk.cyan(`    cd ${projectName}`));
+  if (!install) console.log(chalk.cyan(`    ${pkgManager} install`));
+  console.log(chalk.cyan(`    ${pkgManager} run dev\n`));
+  console.log('  Полезные команды:\n');
+  console.log(`    ${chalk.cyan(`${pkgManager} run lint`)}          — ESLint`);
+  console.log(`    ${chalk.cyan(`${pkgManager} run lint:styles`)}   — Stylelint`);
+  console.log(`    ${chalk.cyan(`${pkgManager} run typecheck`)}     — TypeScript`);
+  console.log(`    ${chalk.cyan(`${pkgManager} run test`)}          — Тесты`);
+  console.log(`    ${chalk.cyan(`${pkgManager} run storybook`)}     — Storybook\n`);
+}
+
+main().catch((e) => {
+  console.error(chalk.red('\nОшибка:'), e.message);
+  process.exit(1);
+});

package/src/template/.husky/commit-msg

@@ -0,0 +1,2 @@
+#!/bin/sh
+npx --no-install commitlint --edit "$1"

package/src/template/.husky/pre-commit

@@ -0,0 +1,2 @@
+#!/bin/sh
+npx lint-staged

package/src/template/.prettierrc

@@ -0,0 +1,20 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "overrides": [
+    {
+      "files": "*.scss",
+      "options": {
+        "singleQuote": false
+      }
+    }
+  ]
+}

package/src/template/.stylelintrc.json

@@ -0,0 +1,93 @@
+{
+  "extends": ["stylelint-config-standard-scss"],
+  "plugins": ["stylelint-order"],
+  "rules": {
+    // ─── Порядок свойств (Box Model → Visual → Typography → Animation) ────────
+    "order/properties-order": [
+      [
+        "content",
+
+        "position", "top", "right", "bottom", "left", "z-index",
+
+        "display",
+        "flex-direction", "flex-wrap", "flex-flow",
+        "justify-content", "justify-items", "justify-self",
+        "align-content", "align-items", "align-self",
+        "gap", "row-gap", "column-gap",
+        "grid-template-columns", "grid-template-rows", "grid-template-areas",
+        "grid-column", "grid-row", "grid-area",
+
+        "width", "min-width", "max-width",
+        "height", "min-height", "max-height",
+
+        "padding", "padding-top", "padding-right", "padding-bottom", "padding-left",
+        "padding-block", "padding-inline",
+        "margin", "margin-top", "margin-right", "margin-bottom", "margin-left",
+        "margin-block", "margin-inline",
+
+        "overflow", "overflow-x", "overflow-y",
+
+        "background", "background-color", "background-image",
+        "background-size", "background-position", "background-repeat",
+        "border", "border-width", "border-style", "border-color",
+        "border-top", "border-right", "border-bottom", "border-left",
+        "border-radius",
+        "box-shadow",
+        "outline", "outline-offset",
+        "opacity", "visibility",
+        "cursor", "pointer-events",
+
+        "font-family", "font-size", "font-weight", "font-style",
+        "line-height", "letter-spacing",
+        "text-align", "text-decoration", "text-transform",
+        "white-space", "word-break", "overflow-wrap",
+        "color",
+        "list-style",
+
+        "transition", "animation", "transform", "will-change"
+      ]
+    ],
+
+    // ─── Запрет магических значений — цвета, размеры должны быть из переменных ─
+    "color-named": "never",
+    "color-no-invalid-hex": true,
+    "scss/dollar-variable-pattern": "^[a-z][a-z0-9-]*$",
+
+    // ─── BEM-нейминг классов ──────────────────────────────────────────────────
+    "selector-class-pattern": [
+      "^[a-z][a-z0-9]*(-[a-z0-9]+)*(__[a-z][a-z0-9]*(-[a-z0-9]+)*)?(--[a-z][a-z0-9]*(-[a-z0-9]+)*)?$",
+      { "message": "Используй BEM: block__element--modifier" }
+    ],
+
+    // ─── Единицы и значения ───────────────────────────────────────────────────
+    "length-zero-no-unit": true,
+    "number-max-precision": 4,
+    "alpha-value-notation": "number",
+
+    // ─── Вложенность ─────────────────────────────────────────────────────────
+    "max-nesting-depth": [3, {
+      "ignore": ["blockless-at-rules", "pseudo-classes"]
+    }],
+
+    // ─── SCSS ─────────────────────────────────────────────────────────────────
+    "scss/no-global-function-names": true,
+    "scss/at-import-no-partial-leading-underscore": true,
+    "scss/at-rule-no-unknown": true,
+    "scss/selector-no-redundant-nesting-selector": true,
+    "scss/no-duplicate-dollar-variables": true,
+
+    // ─── Запрет !important ────────────────────────────────────────────────────
+    "declaration-no-important": [true, {
+      "message": "Не используй !important. Реши проблему специфичности иначе."
+    }],
+
+    // ─── Пустые строки и форматирование ──────────────────────────────────────
+    "rule-empty-line-before": ["always", {
+      "except": ["first-nested"],
+      "ignore": ["after-comment"]
+    }],
+    "comment-empty-line-before": ["always", {
+      "except": ["first-nested"]
+    }]
+  }
+}

package/src/template/_package.json

@@ -0,0 +1,71 @@
+{
+  "name": "project-name",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview",
+    "lint": "eslint src --max-warnings 0",
+    "lint:fix": "eslint src --fix",
+    "lint:styles": "stylelint 'src/**/*.scss'",
+    "lint:styles:fix": "stylelint 'src/**/*.scss' --fix",
+    "format": "prettier --write 'src/**/*.{ts,tsx,scss,json}'",
+    "format:check": "prettier --check 'src/**/*.{ts,tsx,scss,json}'",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build",
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "@nadvan/ui": "latest",
+    "@nadvan/fonts": "latest",
+    "@nadvan/grid": "latest",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^6.27.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.5.0",
+    "@commitlint/config-conventional": "^19.5.0",
+    "@storybook/addon-a11y": "^8.3.6",
+    "@storybook/addon-essentials": "^8.3.6",
+    "@storybook/react-vite": "^8.3.6",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.0.1",
+    "@testing-library/user-event": "^14.5.2",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "@typescript-eslint/eslint-plugin": "^8.12.2",
+    "@typescript-eslint/parser": "^8.12.2",
+    "@vitejs/plugin-react": "^4.3.3",
+    "@vitest/coverage-v8": "^2.1.4",
+    "@vitest/ui": "^2.1.4",
+    "eslint": "^9.13.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-boundaries": "^4.3.1",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jsx-a11y": "^6.10.1",
+    "eslint-plugin-react": "^7.37.2",
+    "eslint-plugin-react-hooks": "^5.0.0",
+    "husky": "^9.1.6",
+    "lint-staged": "^15.2.10",
+    "prettier": "^3.3.3",
+    "sass": "^1.80.6",
+    "stylelint": "^16.10.0",
+    "stylelint-config-standard-scss": "^13.1.0",
+    "stylelint-order": "^6.0.4",
+    "typescript": "^5.6.3",
+    "vite": "^5.4.11",
+    "vite-tsconfig-paths": "^5.1.2",
+    "vitest": "^2.1.4"
+  }
+}

package/src/template/commitlint.config.js

@@ -0,0 +1,62 @@
+export default {
+  extends: ['@commitlint/config-conventional'],
+
+  rules: {
+    // Тип коммита обязателен
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat',     // Новая функциональность
+        'fix',      // Исправление бага
+        'style',    // Только стили/вёрстка (не логика)
+        'refactor', // Рефакторинг без изменения поведения
+        'perf',     // Улучшение производительности
+        'test',     // Тесты
+        'docs',     // Документация
+        'chore',    // Конфигурация, зависимости, инфраструктура
+        'ci',       // CI/CD
+        'revert',   // Откат коммита
+        'wip',      // Work in progress (не в main)
+      ],
+    ],
+
+    // Область (scope) — название FSD-слоя или модуля
+    'scope-enum': [
+      1, // warn, не error — scope свободный, но рекомендованные значения:
+      'always',
+      [
+        'app',
+        'pages',
+        'widgets',
+        'features',
+        'entities',
+        'shared',
+        'ui',
+        'api',
+        'config',
+        'styles',
+        'deps',
+        'ci',
+      ],
+    ],
+
+    // Длина заголовка
+    'header-max-length': [2, 'always', 100],
+    'subject-min-length': [2, 'always', 5],
+
+    // Не требуем lowercase — русский язык это нарушает
+    'subject-case': [0],
+    'type-case': [2, 'always', 'lower-case'],
+  },
+};
+
+/*
+  Примеры правильных коммитов:
+  feat(features): добавить авторизацию через OAuth
+  fix(shared): исправить padding в компоненте Button
+  style(widgets): обновить вёрстку Header под мобайл
+  refactor(entities): переименовать поля в модели User
+  chore(deps): обновить @nadvan/ui до 2.1.0
+  docs: добавить описание компонентов в Storybook
+*/

package/src/template/eslint.config.js

@@ -0,0 +1,154 @@
+import tsParser from '@typescript-eslint/parser';
+import tsPlugin from '@typescript-eslint/eslint-plugin';
+import reactPlugin from 'eslint-plugin-react';
+import reactHooksPlugin from 'eslint-plugin-react-hooks';
+import jsxA11yPlugin from 'eslint-plugin-jsx-a11y';
+import importPlugin from 'eslint-plugin-import';
+import boundariesPlugin from 'eslint-plugin-boundaries';
+import prettierConfig from 'eslint-config-prettier';
+
+export default [
+  // Игнорируемые файлы
+  {
+    ignores: ['dist/**', 'node_modules/**', 'storybook-static/**', '*.config.js'],
+  },
+
+  // Основные правила для src
+  {
+    files: ['src/**/*.{ts,tsx}'],
+
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        project: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+
+    plugins: {
+      '@typescript-eslint': tsPlugin,
+      react: reactPlugin,
+      'react-hooks': reactHooksPlugin,
+      'jsx-a11y': jsxA11yPlugin,
+      import: importPlugin,
+      boundaries: boundariesPlugin,
+    },
+
+    settings: {
+      react: { version: 'detect' },
+      'import/resolver': { typescript: true },
+
+      // FSD слои для проверки границ
+      'boundaries/elements': [
+        { type: 'app',      pattern: 'src/app/*' },
+        { type: 'pages',    pattern: 'src/pages/*' },
+        { type: 'widgets',  pattern: 'src/widgets/*' },
+        { type: 'features', pattern: 'src/features/*' },
+        { type: 'entities', pattern: 'src/entities/*' },
+        { type: 'shared',   pattern: 'src/shared/*' },
+      ],
+      'boundaries/ignore': ['**/*.test.*', '**/*.spec.*', '**/*.stories.*'],
+    },
+
+    rules: {
+      // ─── TypeScript ───────────────────────────────────────────────────────────
+      ...tsPlugin.configs['recommended'].rules,
+      ...tsPlugin.configs['recommended-requiring-type-checking'].rules,
+
+      '@typescript-eslint/no-explicit-any': 'error',
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/consistent-type-imports': ['error', { prefer: 'type-imports' }],
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/no-misused-promises': 'error',
+      '@typescript-eslint/strict-boolean-expressions': 'error',
+      '@typescript-eslint/no-non-null-assertion': 'error',
+      '@typescript-eslint/prefer-nullish-coalescing': 'error',
+      '@typescript-eslint/prefer-optional-chain': 'error',
+
+      // ─── React ────────────────────────────────────────────────────────────────
+      ...reactPlugin.configs.recommended.rules,
+      ...reactPlugin.configs['jsx-runtime'].rules,
+
+      'react/prop-types': 'off', // TypeScript заменяет это
+      'react/self-closing-comp': 'error',
+      'react/jsx-boolean-value': ['error', 'never'],
+      'react/jsx-curly-brace-presence': ['error', { props: 'never', children: 'never' }],
+      'react/jsx-no-useless-fragment': 'error',
+      'react/no-array-index-key': 'warn',
+
+      // ─── React Hooks ─────────────────────────────────────────────────────────
+      ...reactHooksPlugin.configs.recommended.rules,
+
+      // ─── Доступность (a11y) ───────────────────────────────────────────────────
+      ...jsxA11yPlugin.configs.recommended.rules,
+
+      // ─── Импорты ──────────────────────────────────────────────────────────────
+      'import/order': [
+        'error',
+        {
+          groups: ['builtin', 'external', 'internal', ['parent', 'sibling', 'index']],
+          pathGroups: [
+            { pattern: '@app/**',      group: 'internal', position: 'before' },
+            { pattern: '@pages/**',    group: 'internal', position: 'before' },
+            { pattern: '@widgets/**',  group: 'internal', position: 'before' },
+            { pattern: '@features/**', group: 'internal', position: 'before' },
+            { pattern: '@entities/**', group: 'internal', position: 'before' },
+            { pattern: '@shared/**',   group: 'internal', position: 'before' },
+          ],
+          pathGroupsExcludedImportTypes: ['builtin'],
+          'newlines-between': 'always',
+          alphabetize: { order: 'asc', caseInsensitive: true },
+        },
+      ],
+      'import/no-duplicates': 'error',
+      // Запрет default export — используем named; исключения ниже
+      'import/no-default-export': 'error',
+
+      // ─── FSD — границы слоёв ─────────────────────────────────────────────────
+      // Нижний слой не может импортировать из верхнего
+      'boundaries/element-types': [
+        'error',
+        {
+          default: 'disallow',
+          rules: [
+            { from: 'app',      allow: ['pages', 'widgets', 'features', 'entities', 'shared'] },
+            { from: 'pages',    allow: ['widgets', 'features', 'entities', 'shared'] },
+            { from: 'widgets',  allow: ['features', 'entities', 'shared'] },
+            { from: 'features', allow: ['entities', 'shared'] },
+            { from: 'entities', allow: ['shared'] },
+            { from: 'shared',   allow: [] },
+          ],
+        },
+      ],
+
+      // ─── Общие ────────────────────────────────────────────────────────────────
+      'no-console': ['warn', { allow: ['warn', 'error'] }],
+      'no-magic-numbers': ['warn', {
+        ignore: [-1, 0, 1, 2, 100],
+        ignoreArrayIndexes: true,
+        ignoreDefaultValues: true,
+        ignoreClassFieldInitialValues: true,
+      }],
+      'prefer-const': 'error',
+      'no-var': 'error',
+      'eqeqeq': ['error', 'always'],
+      'no-nested-ternary': 'error',
+    },
+  },
+
+  // Исключения: default export разрешён для страниц, stories, конфигов
+  {
+    files: [
+      'src/pages/**/*.tsx',
+      '**/*.stories.tsx',
+      '**/*.stories.ts',
+      'vite.config.ts',
+    ],
+    rules: {
+      'import/no-default-export': 'off',
+    },
+  },
+
+  // Prettier должен быть последним — отключает конфликтующие правила
+  prettierConfig,
+];

package/src/template/gitignore

@@ -0,0 +1,10 @@
+node_modules
+dist
+dist-ssr
+*.local
+.env
+.env.*
+!.env.example
+storybook-static
+coverage
+.DS_Store

package/src/template/lint-staged.config.js

@@ -0,0 +1,21 @@
+export default {
+  // TypeScript и TSX — линт + форматирование
+  'src/**/*.{ts,tsx}': [
+    'eslint --max-warnings 0 --fix',
+    'prettier --write',
+  ],
+
+  // SCSS — стайллинт + форматирование
+  'src/**/*.scss': [
+    'stylelint --fix',
+    'prettier --write',
+  ],
+
+  // JSON, MD — только форматирование
+  '*.{json,md}': [
+    'prettier --write',
+  ],
+
+  // Проверка типов при изменении любого TS-файла
+  'src/**/*.{ts,tsx}': () => 'tsc --noEmit',
+};