byuckchon-frontend-cli 1.9.6 → 1.10.0

package/src/generators/createMonorepo.js

@@ -1,7 +1,10 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 
+import { versions } from '../constants/versions.js';
+import { readSettingsAsset } from '../utils/settingsAssets.js';
 import { createApp } from './createApp.js';
+import { scaffoldReviewAutomation } from './scaffoldReviewAutomation.js';
 
 /**
  * 새 pnpm 모노레포를 스캐폴드한다. (marketd-frontend 구조 참고)
@@ -32,6 +35,7 @@ export async function createMonorepo(config) {
   await writeRootFiles(root, config, scope);
   await writeConfigTypescript(root, scope);
   await writeConfigEslint(root, scope);
+  await scaffoldReviewAutomation({ projectRoot: root, projectType: 'monorepo' });
 
   // 최초 앱 하나만 생성. 이후 추가는 `bc add`.
   const appName = config.appName;
@@ -71,15 +75,17 @@ async function writeRootFiles(root, config, scope) {
       typecheck: 'turbo run typecheck',
       'tokens:build': 'turbo run tokens:build',
       format:
-        'prettier --write "**/*.{ts,tsx,js,jsx,json,md,yml,yaml}" --ignore-path .gitignore',
+        'prettier --write "**/*.{ts,tsx,js,jsx,cjs,json,md,yml,yaml}" --ignore-path .gitignore',
       'format:check':
-        'prettier --check "**/*.{ts,tsx,js,jsx,json,md,yml,yaml}" --ignore-path .gitignore',
+        'prettier --check "**/*.{ts,tsx,js,jsx,cjs,json,md,yml,yaml}" --ignore-path .gitignore',
       clean: 'turbo run clean && rm -rf node_modules .turbo',
       preinstall: 'npx only-allow pnpm',
       // 최초 앱 실행 단축키 (bc add 시 앱마다 추가됨).
       [config.appName]: `pnpm --filter @${scope}/${config.appName} dev`,
     },
     devDependencies: {
+      // 루트의 prettier.config.mjs 와 tsconfig.base.json 이 직접 참조한다.
+      '@byuckchon-frontend/settings': versions['@byuckchon-frontend/settings'],
       '@types/node': '^22.0.0',
       eslint: '^9.18.0',
       'eslint-config-prettier': '^10.1.8',
@@ -100,58 +106,22 @@ packages:
 `,
   );
 
-  await writeJson(path.join(root, 'turbo.json'), {
-    $schema: 'https://turborepo.org/schema.json',
-    ui: 'tui',
-    globalDependencies: ['tsconfig.base.json', '.env', '.env.*', '!.env*.local'],
-    globalEnv: ['NODE_ENV', 'CI'],
-    tasks: {
-      build: {
-        dependsOn: ['^build'],
-        outputs: ['dist/**', 'build/**', '.next/**', '!.next/cache/**', 'out/**'],
-        inputs: [
-          '$TURBO_DEFAULT$',
-          '!**/*.md',
-          '!**/*.test.ts',
-          '!**/*.test.tsx',
-          '!**/*.spec.ts',
-          '!**/*.spec.tsx',
-        ],
-      },
-      dev: { cache: false, persistent: true },
-      lint: { dependsOn: ['^build'], outputs: [] },
-      typecheck: { dependsOn: ['^build'], outputs: ['.tsbuildinfo', '**/*.tsbuildinfo'] },
-      'tokens:build': { outputs: ['src/tokens.css'] },
-      clean: { cache: false },
-    },
-  });
+  // turbo / .npmrc / .nvmrc 는 참조 문법이 없어서 내용을 복사한다.
+  // 이후 settings 가 바뀌면 `npx byuckchon-settings-sync` 로 갱신한다.
+  await write(path.join(root, 'turbo.json'), await readSettingsAsset('project/turbo.json'));
 
+  // 공통 옵션은 @byuckchon-frontend/settings 가 관리한다.
+  // 이 파일은 모노레포 전용 예외를 얹는 자리로만 남긴다.
   await writeJson(path.join(root, 'tsconfig.base.json'), {
     $schema: 'https://json.schemastore.org/tsconfig',
-    display: `${name} Base`,
+    display: `${config.projectName} Base`,
+    extends: '@byuckchon-frontend/settings/tsconfig/base.json',
     compilerOptions: {
-      target: 'ES2022',
-      lib: ['ES2022'],
-      module: 'ESNext',
-      moduleResolution: 'Bundler',
-      strict: true,
       noUncheckedIndexedAccess: true,
       noImplicitOverride: true,
-      noFallthroughCasesInSwitch: true,
-      useUnknownInCatchVariables: true,
-      exactOptionalPropertyTypes: false,
-      esModuleInterop: true,
       allowSyntheticDefaultImports: true,
-      forceConsistentCasingInFileNames: true,
-      resolveJsonModule: true,
-      isolatedModules: true,
-      verbatimModuleSyntax: false,
-      skipLibCheck: true,
       incremental: true,
-      composite: false,
-      types: [],
     },
-    exclude: ['node_modules', 'dist', 'build', '.turbo', '.next', 'coverage'],
   });
 
   await writeJson(path.join(root, 'tsconfig.json'), {
@@ -160,42 +130,19 @@ packages:
     include: [],
   });
 
-  await write(
-    path.join(root, '.npmrc'),
-    `# pnpm 동작 설정
-# React 버전 통일 및 (향후 Expo/RN 도입 대비) hoisted linker 사용.
-node-linker=hoisted
-
-public-hoist-pattern[]=*react*
-public-hoist-pattern[]=*@types/*
-public-hoist-pattern[]=*eslint*
-public-hoist-pattern[]=*prettier*
-
-strict-peer-dependencies=false
-auto-install-peers=true
-save-exact=false
-save-prefix=^
-prefer-frozen-lockfile=true
-`,
-  );
+  await write(path.join(root, '.npmrc'), await readSettingsAsset('project/npmrc'));
 
-  await write(path.join(root, '.nvmrc'), '20\n');
+  await write(path.join(root, '.nvmrc'), await readSettingsAsset('project/nvmrc'));
 
   await write(
     path.join(root, 'prettier.config.mjs'),
-    `/** @type {import("prettier").Config} */
+    `// 포맷 규칙은 @byuckchon-frontend/settings 가 관리합니다.
+// 이 모노레포 전용 예외가 필요하면 펼쳐서 덮어쓰세요.
+import byuckchon from '@byuckchon-frontend/settings/prettier';
+
+/** @type {import("prettier").Config} */
 export default {
-  semi: true,
-  singleQuote: true,
-  trailingComma: 'all',
-  tabWidth: 2,
-  printWidth: 100,
-  arrowParens: 'always',
-  endOfLine: 'lf',
-  bracketSpacing: true,
-  bracketSameLine: false,
-  jsxSingleQuote: false,
-  plugins: ['prettier-plugin-tailwindcss'],
+  ...byuckchon,
   overrides: [
     {
       files: ['*.json', '*.md', '*.yml', '*.yaml'],
@@ -203,7 +150,7 @@ export default {
     },
   ],
 };
-`,
+`
   );
 
   await write(
@@ -311,106 +258,54 @@ async function writeConfigTypescript(root, scope) {
   const dir = path.join(root, 'packages', 'config-typescript');
   await fs.mkdir(dir, { recursive: true });
 
+  // 프리셋 본체는 @byuckchon-frontend/settings 가 관리한다.
+  // 이 패키지는 모노레포 전용 예외를 얹을 자리로만 남긴다.
   await writeJson(path.join(dir, 'package.json'), {
     name: `@${scope}/config-typescript`,
     version: '0.0.0',
     private: true,
-    description: `Shared TypeScript config presets for @${scope} apps & packages`,
+    description: 'settings 의 TypeScript 프리셋을 이 모노레포용으로 감싼 패키지',
     files: ['base.json', 'library.json', 'react.json', 'next.json', 'node.json'],
-  });
-
-  await writeJson(path.join(dir, 'base.json'), {
-    $schema: 'https://json.schemastore.org/tsconfig',
-    display: 'Base',
-    extends: '../../tsconfig.base.json',
-  });
-
-  await writeJson(path.join(dir, 'react.json'), {
-    $schema: 'https://json.schemastore.org/tsconfig',
-    display: 'React Web (Vite)',
-    extends: './base.json',
-    compilerOptions: {
-      lib: ['ES2022', 'DOM', 'DOM.Iterable'],
-      jsx: 'react-jsx',
-      moduleResolution: 'Bundler',
-      module: 'ESNext',
-      noEmit: true,
-      allowImportingTsExtensions: true,
-      useDefineForClassFields: true,
-      types: ['vite/client'],
-      noUncheckedIndexedAccess: false,
-    },
-  });
-
-  await writeJson(path.join(dir, 'next.json'), {
-    $schema: 'https://json.schemastore.org/tsconfig',
-    display: 'Next.js (App Router)',
-    extends: './base.json',
-    compilerOptions: {
-      lib: ['ES2022', 'DOM', 'DOM.Iterable'],
-      jsx: 'preserve',
-      module: 'ESNext',
-      moduleResolution: 'Bundler',
-      noEmit: true,
-      allowJs: true,
-      incremental: true,
-      plugins: [{ name: 'next' }],
-      noUncheckedIndexedAccess: false,
+    dependencies: {
+      '@byuckchon-frontend/settings': versions['@byuckchon-frontend/settings'],
     },
   });
 
-  await writeJson(path.join(dir, 'library.json'), {
+  const preset = (display, name) => ({
     $schema: 'https://json.schemastore.org/tsconfig',
-    display: 'Library (packages/*)',
-    extends: './base.json',
-    compilerOptions: {
-      declaration: true,
-      declarationMap: true,
-      sourceMap: true,
-      outDir: 'dist',
-      rootDir: 'src',
-      composite: true,
-    },
+    display,
+    extends: `@byuckchon-frontend/settings/tsconfig/${name}.json`,
   });
 
-  await writeJson(path.join(dir, 'node.json'), {
-    $schema: 'https://json.schemastore.org/tsconfig',
-    display: 'Node (scripts)',
-    extends: './base.json',
-    compilerOptions: {
-      lib: ['ES2022'],
-      module: 'NodeNext',
-      moduleResolution: 'NodeNext',
-      types: ['node'],
-    },
-  });
+  await writeJson(path.join(dir, 'base.json'), preset('Base', 'base'));
+  await writeJson(path.join(dir, 'react.json'), preset('React Web (Vite)', 'react'));
+  await writeJson(path.join(dir, 'next.json'), preset('Next.js (App Router)', 'next'));
+  await writeJson(path.join(dir, 'library.json'), preset('Library (packages/*)', 'library'));
+  await writeJson(path.join(dir, 'node.json'), preset('Node (scripts)', 'node'));
 }
 
 async function writeConfigEslint(root, scope) {
   const dir = path.join(root, 'packages', 'config-eslint');
   await fs.mkdir(dir, { recursive: true });
 
+  // 규칙 본체는 @byuckchon-frontend/settings 가 관리한다.
+  // 이 패키지는 모노레포 전용 예외를 얹을 자리로만 남긴다.
   await writeJson(path.join(dir, 'package.json'), {
     name: `@${scope}/config-eslint`,
     version: '0.0.0',
     private: true,
     type: 'module',
-    description: `Shared ESLint flat configs for @${scope} apps & packages`,
+    description: 'settings 의 ESLint 프리셋을 이 모노레포용으로 감싼 패키지',
     main: './base.js',
     exports: {
       '.': './base.js',
       './base': './base.js',
       './react': './react.js',
+      './next': './next.js',
     },
-    files: ['base.js', 'react.js'],
+    files: ['base.js', 'react.js', 'next.js'],
     dependencies: {
-      '@eslint/js': '^9.18.0',
-      'eslint-config-prettier': '^10.1.8',
-      'eslint-plugin-import': '^2.32.0',
-      'eslint-plugin-react': '^7.37.4',
-      'eslint-plugin-react-hooks': '^5.1.0',
-      globals: '^15.14.0',
-      'typescript-eslint': '^8.59.1',
+      '@byuckchon-frontend/settings': versions['@byuckchon-frontend/settings'],
     },
     peerDependencies: {
       eslint: '^9.0.0',
@@ -418,97 +313,17 @@ async function writeConfigEslint(root, scope) {
     },
   });
 
-  await write(
-    path.join(dir, 'base.js'),
-    `// @ts-check
-import js from '@eslint/js';
-import tseslint from 'typescript-eslint';
-import prettier from 'eslint-config-prettier';
-import importPlugin from 'eslint-plugin-import';
-import globals from 'globals';
+  const reexport = (name, named) => `// 규칙 본체는 @byuckchon-frontend/settings 가 관리합니다.
+// 이 모노레포에만 해당하는 예외는 아래 배열에 이어붙이세요.
+import byuckchon from '@byuckchon-frontend/settings/eslint/${name}';
 
-/**
- * 공통 ESLint flat config (TS 베이스).
- * @type {import("eslint").Linter.Config[]}
- */
-export const baseConfig = [
-  {
-    ignores: [
-      '**/node_modules/**',
-      '**/dist/**',
-      '**/build/**',
-      '**/out/**',
-      '**/.next/**',
-      '**/.turbo/**',
-      '**/coverage/**',
-      '**/*.d.ts',
-    ],
-  },
-  js.configs.recommended,
-  ...tseslint.configs.recommended,
-  {
-    languageOptions: {
-      ecmaVersion: 2022,
-      sourceType: 'module',
-      globals: { ...globals.es2022 },
-    },
-    plugins: { import: importPlugin },
-    rules: {
-      'no-console': ['warn', { allow: ['warn', 'error'] }],
-      '@typescript-eslint/consistent-type-imports': [
-        'warn',
-        { prefer: 'type-imports', fixStyle: 'inline-type-imports' },
-      ],
-      '@typescript-eslint/no-unused-vars': [
-        'warn',
-        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
-      ],
-    },
-  },
-  prettier,
-];
-
-export default baseConfig;
-`,
-  );
-
-  await write(
-    path.join(dir, 'react.js'),
-    `// @ts-check
-import react from 'eslint-plugin-react';
-import reactHooks from 'eslint-plugin-react-hooks';
-import globals from 'globals';
+/** @type {import("eslint").Linter.Config[]} */
+export const ${named} = [...byuckchon];
 
-import { baseConfig } from './base.js';
+export default ${named};
+`;
 
-/**
- * React (Vite/Next) 앱용 ESLint config.
- * @type {import("eslint").Linter.Config[]}
- */
-export const reactConfig = [
-  ...baseConfig,
-  {
-    files: ['**/*.{js,jsx,ts,tsx}'],
-    languageOptions: {
-      globals: { ...globals.browser, ...globals.es2022 },
-      parserOptions: { ecmaFeatures: { jsx: true } },
-    },
-    plugins: { react, 'react-hooks': reactHooks },
-    settings: { react: { version: 'detect' } },
-    rules: {
-      ...react.configs.recommended.rules,
-      ...react.configs['jsx-runtime'].rules,
-      ...reactHooks.configs.recommended.rules,
-      'react/prop-types': 'off',
-      'react/react-in-jsx-scope': 'off',
-      'react/no-unescaped-entities': 'off',
-      'react-hooks/rules-of-hooks': 'warn',
-      '@typescript-eslint/no-explicit-any': 'off',
-    },
-  },
-];
-
-export default reactConfig;
-`,
-  );
+  await write(path.join(dir, 'base.js'), reexport('base', 'baseConfig'));
+  await write(path.join(dir, 'react.js'), reexport('react', 'reactConfig'));
+  await write(path.join(dir, 'next.js'), reexport('next', 'nextConfig'));
 }

package/src/generators/createPackageJson.js

@@ -16,17 +16,26 @@ export async function createPackageJson(rootDir, config) {
           dev: 'vite',
           build: 'tsc -b && vite build',
           'tokens:build': 'style-dictionary build --config token.config.js',
+          // PR Check workflow 가 lint / typecheck / build 를 각각 호출한다.
+          typecheck: 'tsc -b',
           lint: 'eslint . --ext ts,tsx',
           preview: 'vite preview',
-          format: 'prettier --write "src/**/*.{ts,tsx,css}"',
+          format:
+            'prettier --write "src/**/*.{ts,tsx,css}" "tools/**/*.{js,cjs,json,md}"',
+          'format:check':
+            'prettier --check "src/**/*.{ts,tsx,css}" "tools/**/*.{js,cjs,json,md}"',
         }
       : {
           dev: 'next dev',
           build: 'next build',
           'tokens:build': 'style-dictionary build --config token.config.js',
+          typecheck: 'tsc --noEmit',
           start: 'next start',
-          lint: 'next lint',
-          format: 'prettier --write "src/**/*.{ts,tsx,css}"',
+          lint: 'eslint .',
+          format:
+            'prettier --write "src/**/*.{ts,tsx,css}" "tools/**/*.{js,cjs,json,md}"',
+          'format:check':
+            'prettier --check "src/**/*.{ts,tsx,css}" "tools/**/*.{js,cjs,json,md}"',
         },
     dependencies: {
       react: isReact ? versions.react : versions['next-react'],
@@ -37,9 +46,12 @@ export async function createPackageJson(rootDir, config) {
       ...(isReact
         ? {
             axios: versions.axios,
+            'react-router-dom': versions['react-router-dom'],
           }
         : {}),
       zod: versions.zod,
+      clsx: versions.clsx,
+      'tailwind-merge': versions['tailwind-merge'],
     },
     devDependencies: {
       '@types/react': versions['@types/react'],
@@ -47,14 +59,10 @@ export async function createPackageJson(rootDir, config) {
       '@types/node': versions['@types/node'],
       '@trivago/prettier-plugin-sort-imports':
         versions['@trivago/prettier-plugin-sort-imports'],
+      // eslint/prettier/tsconfig/tokens 설정과 motion CSS 가 모두 이 패키지를 참조한다.
+      // (ESLint 플러그인도 이 패키지가 의존성으로 들고 온다)
+      '@byuckchon-frontend/settings': versions['@byuckchon-frontend/settings'],
       eslint: versions.eslint,
-      'eslint-config-expo': versions['eslint-config-expo'],
-      'eslint-import-resolver-typescript':
-        versions['eslint-import-resolver-typescript'],
-      'eslint-plugin-import': versions['eslint-plugin-import'],
-      'eslint-plugin-react': versions['eslint-plugin-react'],
-      'eslint-plugin-react-hooks': versions['eslint-plugin-react-hooks'],
-      'eslint-plugin-unused-imports': versions['eslint-plugin-unused-imports'],
       prettier: versions.prettier,
       'prettier-plugin-tailwindcss': versions['prettier-plugin-tailwindcss'],
       'style-dictionary': versions['style-dictionary'],
@@ -63,9 +71,6 @@ export async function createPackageJson(rootDir, config) {
       ...(isReact
         ? {
             '@tailwindcss/vite': versions['@tailwindcss/vite'],
-            '@typescript-eslint/eslint-plugin':
-              versions['@typescript-eslint/eslint-plugin'],
-            '@typescript-eslint/parser': versions['@typescript-eslint/parser'],
             '@vitejs/plugin-react': versions['@vitejs/plugin-react'],
             vite: versions.vite,
             'vite-plugin-svgr': versions['vite-plugin-svgr'],
@@ -74,6 +79,7 @@ export async function createPackageJson(rootDir, config) {
             '@tailwindcss/postcss': versions['@tailwindcss/postcss'],
             '@svgr/webpack': versions['@svgr/webpack'],
             'eslint-config-next': versions['eslint-config-next'],
+            '@eslint/eslintrc': versions['@eslint/eslintrc'],
           }),
     },
   };

package/src/generators/createProject.js

@@ -1,22 +1,18 @@
-import fs from 'fs/promises';
-import path from 'path';
-import { exec as execCallback } from 'child_process';
-import { promisify } from 'util';
+import fs from "fs/promises";
+import path from "path";
+import { exec as execCallback } from "child_process";
+import { promisify } from "util";
 
-import { createBaseFiles } from './createBaseFiles.js';
-import { createBcConfig } from './createBcConfig.js';
-import { createFolders } from './createFolders.js';
-import { createPackageJson } from './createPackageJson.js';
-import { createReadme } from './createReadme.js';
-import { scaffoldApiConventionDoc } from './apiConventionDoc.js';
+import { createBaseFiles } from "./createBaseFiles.js";
+import { createBcConfig } from "./createBcConfig.js";
+import { createFolders } from "./createFolders.js";
+import { createPackageJson } from "./createPackageJson.js";
+import { createReadme } from "./createReadme.js";
+import { scaffoldApiConventionDoc } from "./apiConventionDoc.js";
+import { scaffoldReviewAutomation } from "./scaffoldReviewAutomation.js";
+import { BYUCKCHON_PACKAGES } from "./install.js";
 
 const exec = promisify(execCallback);
-const BYUCKCHON_PACKAGES = [
-  '@byuckchon-frontend/hooks',
-  '@byuckchon-frontend/utils',
-  '@byuckchon-frontend/basic-ui',
-  '@byuckchon-frontend/core',
-];
 
 export async function createProject(config) {
   const rootDir = path.resolve(config.projectName);
@@ -27,10 +23,17 @@ export async function createProject(config) {
   await createBaseFiles(rootDir, config);
   await createReadme(rootDir, config);
   // API 코드 컨벤션 .md 를 프레임워크에 맞는 API 루트(src/api | src/lib/api)에 깐다.
-  await scaffoldApiConventionDoc({ projectRoot: rootDir, framework: config.framework });
+  await scaffoldApiConventionDoc({
+    projectRoot: rootDir,
+    framework: config.framework,
+  });
   await createBcConfig(rootDir, config);
+  await scaffoldReviewAutomation({
+    projectRoot: rootDir,
+    projectType: "single",
+  });
 
   // 최신 버전(latest 포함) 의존성을 실제로 설치해 lockfile까지 생성
-  await exec('npm install', { cwd: rootDir });
-  await exec(`npm install ${BYUCKCHON_PACKAGES.join(' ')}`, { cwd: rootDir });
+  await exec("npm install", { cwd: rootDir });
+  await exec(`npm install ${BYUCKCHON_PACKAGES.join(" ")}`, { cwd: rootDir });
 }

package/src/generators/createReadme.js

@@ -10,7 +10,7 @@ export async function createReadme(rootDir, config) {
 
 | 항목 | 내용 |
 |------|------|
-| Framework | ${isReact ? 'React 19' : 'Next.js 15 (App Router)'} |
+| Framework | ${isReact ? 'React 18' : 'Next.js 15 (App Router)'} |
 | Language | TypeScript |
 | Build Tool | ${isReact ? 'Vite' : 'Next.js built-in'} |
 | Styling | Tailwind CSS |
@@ -47,8 +47,8 @@ src/
 ├── components/    재사용 가능한 UI 컴포넌트${
     isReact
       ? `
-├── layout/        레이아웃 컴포넌트
-└── page/          페이지 컴포넌트`
+├── layouts/       레이아웃 컴포넌트
+└── pages/         페이지 컴포넌트`
       : `
 └── app/           Next.js App Router (layout, page 등)`
   }
@@ -61,7 +61,7 @@ ${
 각 레이어는 아래 방향으로만 import 해야 합니다.
 
 \`\`\`
-lib → store → api → hooks → context → components → layout → page
+lib → store → api → hooks → context → components → layouts → pages
 \`\`\`
 
 \`assets\`는 모든 레이어에서 자유롭게 참조 가능합니다.`

package/src/generators/install.js

@@ -10,6 +10,7 @@ export const BYUCKCHON_PACKAGES = [
   '@byuckchon-frontend/utils',
   '@byuckchon-frontend/basic-ui',
   '@byuckchon-frontend/core',
+  '@byuckchon-frontend/settings',
 ];
 
 async function hasPnpm() {