create-web-0to1 0.1.0

package/README.md

@@ -0,0 +1,68 @@
+# create-web-0to1
+
+`React`, `Next.js`, `monorepo` preset을 하나의 인터랙티브 wizard로 생성하는 0to1 통합 생성기입니다.
+
+## 사용법
+
+가장 일반적인 실행 방식은 아래입니다.
+
+```bash
+npm create web-0to1@latest
+```
+
+또는
+
+```bash
+npx create-web-0to1@latest
+```
+
+실행 후 wizard에서 아래 preset 중 하나를 고르시면 됩니다.
+
+- `React standalone`
+- `Next standalone`
+- `Monorepo workspace`
+
+실행 방식은 아래처럼 최대한 단순하게 유지했습니다.
+
+- standalone: `자동 scaffold 후 생성` 또는 `scaffolded dir에 적용`
+- monorepo: `바로 생성`
+
+standalone preset에서는 wizard 안에서 아래 옵션도 같이 고를 수 있습니다.
+
+- `Tailwind 포함` / `No Style`
+- `commitlint + husky` 설정 여부
+- `docs/개발원칙` 포함 여부
+
+## 요구 사항
+
+- `Node.js >= 22.18`
+- upstream scaffold 실행용 네트워크 연결
+
+## 로컬 개발
+
+```bash
+npm install
+npm run create
+```
+
+검증:
+
+```bash
+npm run check
+npm run smoke
+```
+
+## 문서 위치
+
+- 운영/인수인계: [docs/HANDOFF.md](./docs/HANDOFF.md)
+- 단계별 작업 로그: [docs/steps/STEP31_COMPLETION_GATE.md](./docs/steps/STEP31_COMPLETION_GATE.md)부터 확인하시면 됩니다.
+
+## publish 메모
+
+이 패키지는 npm publish 후 아래 형태로 실행되도록 맞춰져 있습니다.
+
+```bash
+npm create web-0to1@latest
+```
+
+`npm create <name>`는 내부적으로 `create-<name>` 패키지를 실행하므로, 패키지 이름은 `create-web-0to1`, bin 이름도 동일하게 설정되어 있습니다.

package/internal/engine/create-feature-crud-script.ts

@@ -0,0 +1,134 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+
+import {
+  standaloneFeaturePresetConfigs,
+  type StandaloneFeaturePreset,
+} from './standalone-feature-preset.ts';
+
+type StandaloneFeatureCrudPreset = StandaloneFeaturePreset;
+
+let createFeatureCrudTemplatePromise: Promise<string> | null = null;
+
+function getCreateFeatureCrudTemplate(workspaceRoot: string) {
+  if (createFeatureCrudTemplatePromise === null) {
+    // 큰 CRUD 스크립트는 plain template file로 두는 편이
+    // escaped template literal보다 diff와 유지보수가 훨씬 쉽습니다.
+    createFeatureCrudTemplatePromise = readFile(
+      path.join(
+        workspaceRoot,
+        'internal',
+        'engine',
+        'create-feature-crud.template.mjs',
+      ),
+      'utf8',
+    );
+  }
+
+  return createFeatureCrudTemplatePromise;
+}
+
+const createFeatureCrudScriptConfigs = {
+  react: {
+    listImports: `import { useQuery } from '@tanstack/react-query';
+import { useState } from 'react';
+import { Link } from 'react-router-dom';`,
+    listLinkProp: 'to',
+    formImports: `import { zodResolver } from '@hookform/resolvers/zod';
+import { useForm } from 'react-hook-form';
+import { useNavigate } from 'react-router-dom';`,
+    formNavigationHook: 'const navigate = useNavigate();',
+    formSuccessNavigation: 'navigate(successPath);',
+    formDescriptionBlockNoStyle: `      <div>
+        <label htmlFor="description">설명 *</label>
+        <textarea id="description" aria-invalid={errors.description ? true : undefined} placeholder="\${entityLabel} 설명" {...register('description')} />
+        {errors.description ? <p role="alert">{errors.description.message}</p> : null}
+      </div>`,
+    createFormSectionImports: `import { \${entityNamePascal}Form } from '@/features/\${featureName}/components/\${entityName}-form';
+import { useCreate\${entityNamePascal}Form } from '@/features/\${featureName}/hooks/use-create-\${entityName}-form';`,
+    hookImports: `import { useMutation, useQueryClient } from '@tanstack/react-query';`,
+  },
+  next: {
+    listImports: `'use client';
+
+import { useQuery } from '@tanstack/react-query';
+import Link from 'next/link';
+import { useState } from 'react';`,
+    listLinkProp: 'href',
+    formImports: `'use client';
+
+import { zodResolver } from '@hookform/resolvers/zod';
+import { useRouter } from 'next/navigation';
+import { useForm } from 'react-hook-form';`,
+    formNavigationHook: 'const router = useRouter();',
+    formSuccessNavigation: 'router.push(successPath);',
+    formDescriptionBlockNoStyle: `      <div>
+        <label htmlFor="description">
+          설명
+          <span aria-hidden="true"> *</span>
+        </label>
+        <textarea
+          id="description"
+          aria-invalid={errors.description ? true : undefined}
+          placeholder="\${entityLabel} 설명"
+          {...register('description')}
+        />
+        {errors.description ? <p role="alert">{errors.description.message}</p> : null}
+      </div>`,
+    createFormSectionImports: `'use client';
+
+import { \${entityNamePascal}Form } from '@/features/\${featureName}/components/\${entityName}-form';
+import { useCreate\${entityNamePascal}Form } from '@/features/\${featureName}/hooks/use-create-\${entityName}-form';`,
+    hookImports: `'use client';
+
+import { useMutation, useQueryClient } from '@tanstack/react-query';`,
+  },
+} as const satisfies Record<
+  StandaloneFeatureCrudPreset,
+  {
+    listImports: string;
+    listLinkProp: string;
+    formImports: string;
+    formNavigationHook: string;
+    formSuccessNavigation: string;
+    formDescriptionBlockNoStyle: string;
+    createFormSectionImports: string;
+    hookImports: string;
+  }
+>;
+
+export async function buildStandaloneCreateFeatureCrudScript(
+  preset: StandaloneFeatureCrudPreset,
+  workspaceRoot: string,
+) {
+  const templateText = await getCreateFeatureCrudTemplate(workspaceRoot);
+  const baseConfig = standaloneFeaturePresetConfigs[preset];
+  const config = createFeatureCrudScriptConfigs[preset];
+
+  return templateText
+    .replaceAll('__ROUTE_ROOT_CONST__', baseConfig.routeRootConst)
+    .replaceAll('__ROUTE_ROOT_NAME__', baseConfig.routeRootName)
+    .replaceAll('__PACKAGE_JSON_KEY__', baseConfig.packageJsonKey)
+    .replaceAll('__LIST_IMPORTS__', config.listImports)
+    .replaceAll('__LIST_LINK_PROP__', config.listLinkProp)
+    .replaceAll('__FORM_IMPORTS__', config.formImports)
+    .replaceAll('__FORM_NAVIGATION_HOOK__', config.formNavigationHook)
+    .replaceAll('__FORM_SUCCESS_NAVIGATION__', config.formSuccessNavigation)
+    .replaceAll(
+      '__FORM_DESCRIPTION_BLOCK_NO_STYLE__',
+      config.formDescriptionBlockNoStyle,
+    )
+    .replaceAll(
+      '__CREATE_FORM_SECTION_IMPORTS__',
+      config.createFormSectionImports,
+    )
+    .replaceAll('__HOOK_IMPORTS__', config.hookImports)
+    .replaceAll(
+      '__OUTPUT_SUMMARY_LINE__',
+      preset === 'next'
+        ? `console.log(\`생성 대상: feature 파일, ${baseConfig.routeOutputLabel}\`);`
+        : `console.log('생성 대상: feature 파일, ${baseConfig.routeOutputLabel}');`,
+    )
+    .replaceAll('__OPTIONAL_ROUTE_HINT__', baseConfig.optionalRouteHint)
+    .replaceAll('__ENV_HINT__', baseConfig.envHint);
+}