create-web-0to1 0.1.0

package/internal/engine/standalone-feature-preset.ts

@@ -0,0 +1,34 @@
+export type StandaloneFeaturePreset = 'react' | 'next';
+
+export const standaloneFeaturePresetConfigs = {
+  react: {
+    packageJsonKey: 'react-0to1',
+    routeRootConst: 'pagesDir',
+    routeRootName: 'pages',
+    routeOutputLabel: 'page route',
+    optionalRouteHint:
+      "console.log('src/pages/**/page.tsx는 자동으로 React Router 경로가 됩니다.');\n",
+    envHint: `console.log(
+  'VITE_API_BASE_URL 환경 변수를 설정한 뒤 실제 백엔드 규약에 맞게 엔드포인트를 연결하세요.',
+);`,
+  },
+  next: {
+    packageJsonKey: 'next-0to1',
+    routeRootConst: 'appDir',
+    routeRootName: 'app',
+    routeOutputLabel: 'app route',
+    optionalRouteHint: '',
+    envHint:
+      "console.log('NEXT_PUBLIC_API_BASE_URL과 필요하면 API_BASE_URL 환경 변수를 설정한 뒤 실제 백엔드 규약에 맞게 엔드포인트를 연결하세요.');",
+  },
+} as const satisfies Record<
+  StandaloneFeaturePreset,
+  {
+    packageJsonKey: string;
+    routeRootConst: string;
+    routeRootName: string;
+    routeOutputLabel: string;
+    optionalRouteHint: string;
+    envHint: string;
+  }
+>;

package/internal/meta/preset-plan.ts

@@ -0,0 +1,41 @@
+import {
+  getScaffoldManifest,
+  type PresetId,
+} from './scaffold-manifest.ts';
+import { getRuntimeLayout } from './runtime-layout.ts';
+
+export type PresetPlan = {
+  preset: PresetId;
+  templateDir: string;
+  scaffold: ReturnType<typeof getScaffoldManifest>;
+  runtime: ReturnType<typeof getRuntimeLayout>;
+  notes: string[];
+};
+
+const templateDirs = {
+  react: 'templates/react',
+  next: 'templates/next',
+  monorepo: 'templates/monorepo',
+} as const satisfies Record<PresetId, string>;
+
+export function getPresetPlan(preset: PresetId): PresetPlan {
+  return {
+    preset,
+    templateDir: templateDirs[preset],
+    scaffold: getScaffoldManifest(preset),
+    runtime: getRuntimeLayout(preset),
+    notes: [
+      'templateDir는 정적 override file source입니다.',
+      'runtime layout은 source/ 아래 TS/TSX runtime을 어디로 내보낼지 정합니다.',
+      '실제 create-app 구현은 이 plan을 읽어서 scaffold -> clean -> copy -> rewrite 순서로 실행합니다.',
+    ],
+  };
+}
+
+export function listPresetPlans(): PresetPlan[] {
+  return [
+    getPresetPlan('react'),
+    getPresetPlan('next'),
+    getPresetPlan('monorepo'),
+  ];
+}

package/internal/meta/runtime-copy-plan.ts

@@ -0,0 +1,220 @@
+import * as path from 'node:path/posix';
+
+import type { PresetId } from './scaffold-manifest.ts';
+import {
+  getRuntimeLayout,
+  type RuntimeLayer,
+  type RuntimeRootMapping,
+} from './runtime-layout.ts';
+
+const SOURCE_FILE_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'] as const;
+
+type SourceFileExtension = (typeof SOURCE_FILE_EXTENSIONS)[number];
+
+export type RuntimeCopyEntry = {
+  sourcePath: string;
+  outputPath: string;
+  layer: RuntimeLayer;
+  mapping: RuntimeRootMapping;
+};
+
+export type RewriteRuntimeImportsOptions = {
+  preset: PresetId;
+  sourcePath: string;
+  sourceText: string;
+  availableSourceFiles: string[];
+};
+
+function toPosixPath(value: string) {
+  return value.replaceAll('\\', '/');
+}
+
+function normalizeSourcePath(value: string) {
+  const normalized = path.normalize(toPosixPath(value));
+
+  if (normalized.startsWith('source/')) {
+    return normalized.slice('source/'.length);
+  }
+
+  return normalized;
+}
+
+function ensureRelativeSpecifier(value: string) {
+  if (value === '') {
+    return './';
+  }
+
+  return value.startsWith('.') ? value : `./${value}`;
+}
+
+function stripSourceExtension(value: string) {
+  const extension = path.extname(value) as SourceFileExtension | '';
+
+  if (SOURCE_FILE_EXTENSIONS.includes(extension as SourceFileExtension)) {
+    return value.slice(0, -extension.length);
+  }
+
+  return value;
+}
+
+function findRuntimeRootMapping(preset: PresetId, sourcePath: string) {
+  const normalizedSourcePath = normalizeSourcePath(sourcePath);
+  const { mappings } = getRuntimeLayout(preset);
+
+  return (
+    mappings.find(
+      (mapping) =>
+        normalizedSourcePath === mapping.sourceDir ||
+        normalizedSourcePath.startsWith(`${mapping.sourceDir}/`),
+    ) ?? null
+  );
+}
+
+function joinOutputPath(mapping: RuntimeRootMapping, sourcePath: string) {
+  const normalizedSourcePath = normalizeSourcePath(sourcePath);
+  const relativePath = path.relative(mapping.sourceDir, normalizedSourcePath);
+
+  if (!relativePath || relativePath === '.') {
+    return mapping.outputDir;
+  }
+
+  return path.join(mapping.outputDir, relativePath);
+}
+
+function resolveSourceModulePath(
+  sourcePath: string,
+  specifier: string,
+  availableSourceFiles: Set<string>,
+) {
+  const sourceDir = path.dirname(normalizeSourcePath(sourcePath));
+  const baseCandidate = path.normalize(path.join(sourceDir, specifier));
+
+  const directMatch = normalizeSourcePath(baseCandidate);
+  if (availableSourceFiles.has(directMatch)) {
+    return directMatch;
+  }
+
+  for (const extension of SOURCE_FILE_EXTENSIONS) {
+    const withExtension = normalizeSourcePath(`${baseCandidate}${extension}`);
+    if (availableSourceFiles.has(withExtension)) {
+      return withExtension;
+    }
+  }
+
+  for (const extension of SOURCE_FILE_EXTENSIONS) {
+    const asIndexFile = normalizeSourcePath(path.join(baseCandidate, `index${extension}`));
+    if (availableSourceFiles.has(asIndexFile)) {
+      return asIndexFile;
+    }
+  }
+
+  return null;
+}
+
+export function resolveRuntimeOutputPath(preset: PresetId, sourcePath: string) {
+  const mapping = findRuntimeRootMapping(preset, sourcePath);
+
+  if (!mapping) {
+    return null;
+  }
+
+  return joinOutputPath(mapping, sourcePath);
+}
+
+export function createRuntimeCopyPlan(preset: PresetId, sourcePaths: string[]) {
+  return sourcePaths
+    .map((sourcePath) => {
+      const normalizedSourcePath = normalizeSourcePath(sourcePath);
+      const mapping = findRuntimeRootMapping(preset, normalizedSourcePath);
+
+      if (!mapping) {
+        return null;
+      }
+
+      return {
+        sourcePath: normalizedSourcePath,
+        outputPath: joinOutputPath(mapping, normalizedSourcePath),
+        layer: mapping.layer,
+        mapping,
+      } satisfies RuntimeCopyEntry;
+    })
+    .filter((entry): entry is RuntimeCopyEntry => entry !== null)
+    .sort((left, right) => left.outputPath.localeCompare(right.outputPath));
+}
+
+export function rewriteRuntimeModuleSpecifier(
+  preset: PresetId,
+  sourcePath: string,
+  specifier: string,
+  availableSourceFiles: string[],
+) {
+  if (!specifier.startsWith('.')) {
+    return specifier;
+  }
+
+  const availableSourceFileSet = new Set(
+    availableSourceFiles.map((filePath) => normalizeSourcePath(filePath)),
+  );
+  const resolvedTargetSourcePath = resolveSourceModulePath(
+    sourcePath,
+    specifier,
+    availableSourceFileSet,
+  );
+
+  if (!resolvedTargetSourcePath) {
+    return specifier;
+  }
+
+  const currentOutputPath = resolveRuntimeOutputPath(preset, sourcePath);
+  const targetOutputPath = resolveRuntimeOutputPath(preset, resolvedTargetSourcePath);
+
+  if (!currentOutputPath || !targetOutputPath) {
+    return specifier;
+  }
+
+  const relativeOutputPath = path.relative(
+    path.dirname(currentOutputPath),
+    stripSourceExtension(targetOutputPath),
+  );
+
+  return ensureRelativeSpecifier(relativeOutputPath);
+}
+
+export function rewriteRuntimeImports({
+  preset,
+  sourcePath,
+  sourceText,
+  availableSourceFiles,
+}: RewriteRuntimeImportsOptions) {
+  const replaceSpecifier = (specifier: string) =>
+    rewriteRuntimeModuleSpecifier(preset, sourcePath, specifier, availableSourceFiles);
+
+  const fromPattern = /(\bfrom\s+)(['"])([^'"]+)(\2)/g;
+  const sideEffectImportPattern = /(^\s*import\s+)(['"])([^'"]+)(\2)/gm;
+
+  const withRewrittenFromSpecifiers = sourceText.replace(
+    fromPattern,
+    (match, fromKeyword, quote, specifier, closingQuote) => {
+      const nextSpecifier = replaceSpecifier(specifier);
+
+      if (nextSpecifier === specifier) {
+        return match;
+      }
+
+      return `${fromKeyword}${quote}${nextSpecifier}${closingQuote}`;
+    },
+  );
+
+  return withRewrittenFromSpecifiers.replace(
+    sideEffectImportPattern,
+    (match, importKeyword, quote, specifier, closingQuote) => {
+      const nextSpecifier = replaceSpecifier(specifier);
+
+      if (nextSpecifier === specifier) {
+        return match;
+      }
+
+      return `${importKeyword}${quote}${nextSpecifier}${closingQuote}`;
+    },
+  );
+}

package/internal/meta/runtime-layout.ts

@@ -0,0 +1,262 @@
+import type { PresetId } from './scaffold-manifest.ts';
+
+export type RuntimeLayer = 'core' | 'wrapper';
+
+export type RuntimeRootMapping = {
+  // `source/` 기준 상대 경로입니다.
+  sourceDir: string;
+  // 생성 결과물 기준 상대 경로입니다.
+  outputDir: string;
+  layer: RuntimeLayer;
+  notes?: string[];
+};
+
+export type PresetRuntimeLayout = {
+  preset: PresetId;
+  notes: string[];
+  mappings: RuntimeRootMapping[];
+};
+
+function definePresetRuntimeLayout(
+  layout: PresetRuntimeLayout,
+): PresetRuntimeLayout {
+  return layout;
+}
+
+export const reactRuntimeLayout = definePresetRuntimeLayout({
+  preset: 'react',
+  notes: [
+    'React standalone은 shared 도메인 폴더를 그대로 public surface로 사용합니다.',
+    '공통 core 구현도 src/shared 아래로 바로 내려서 wrapper 재노출 단계를 줄입니다.',
+    'app entry 파일은 runtime이 아니라 templates/react가 소유합니다.',
+  ],
+  mappings: [
+    {
+      sourceDir: 'core/query',
+      outputDir: 'src/shared/query',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/request',
+      outputDir: 'src/shared/api',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/auth',
+      outputDir: 'src/shared/auth',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/error',
+      outputDir: 'src/shared/error',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/routes',
+      outputDir: 'src/shared/routes',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/ui',
+      outputDir: 'src/shared/ui',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/utils',
+      outputDir: 'src/shared/utils',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/lib',
+      outputDir: 'src/shared/lib',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'wrappers/react/query',
+      outputDir: 'src/shared/query',
+      layer: 'wrapper',
+    },
+    {
+      sourceDir: 'wrappers/react/request',
+      outputDir: 'src/shared/api',
+      layer: 'wrapper',
+    },
+    {
+      sourceDir: 'wrappers/react/auth',
+      outputDir: 'src/shared/auth',
+      layer: 'wrapper',
+    },
+    {
+      sourceDir: 'wrappers/react/error',
+      outputDir: 'src/shared/error',
+      layer: 'wrapper',
+    },
+    {
+      sourceDir: 'wrappers/react/ui',
+      outputDir: 'src/shared/ui',
+      layer: 'wrapper',
+    },
+  ],
+});
+
+export const nextRuntimeLayout = definePresetRuntimeLayout({
+  preset: 'next',
+  notes: [
+    'Next standalone도 shared 도메인 폴더를 그대로 public surface로 사용합니다.',
+    '공통 core 구현도 src/shared 아래로 바로 내려서 wrapper 재노출 단계를 줄입니다.',
+    'app entry 파일은 runtime이 아니라 templates/next가 소유합니다.',
+  ],
+  mappings: [
+    {
+      sourceDir: 'core/query',
+      outputDir: 'src/shared/query',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/request',
+      outputDir: 'src/shared/api',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/auth',
+      outputDir: 'src/shared/auth',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/error',
+      outputDir: 'src/shared/error',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/routes',
+      outputDir: 'src/shared/routes',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/ui',
+      outputDir: 'src/shared/ui',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/utils',
+      outputDir: 'src/shared/utils',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/lib',
+      outputDir: 'src/shared/lib',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'wrappers/next/query',
+      outputDir: 'src/shared/query',
+      layer: 'wrapper',
+    },
+    {
+      sourceDir: 'wrappers/next/request',
+      outputDir: 'src/shared/api',
+      layer: 'wrapper',
+    },
+    {
+      sourceDir: 'wrappers/next/auth',
+      outputDir: 'src/shared/auth',
+      layer: 'wrapper',
+    },
+    {
+      sourceDir: 'wrappers/next/error',
+      outputDir: 'src/shared/error',
+      layer: 'wrapper',
+    },
+    {
+      sourceDir: 'wrappers/next/ui',
+      outputDir: 'src/shared/ui',
+      layer: 'wrapper',
+    },
+  ],
+});
+
+export const monorepoRuntimeLayout = definePresetRuntimeLayout({
+  preset: 'monorepo',
+  notes: [
+    'monorepo 공통 core 구현도 packages/core/src 아래 도메인 폴더로 바로 둡니다.',
+    'packages/core는 request/config/schema 같은 공개 facade 역할도 같이 맡습니다.',
+    'packages/core-react, packages/core-next는 배포 형태 차이만 담는 wrapper package입니다.',
+  ],
+  mappings: [
+    {
+      sourceDir: 'core/query',
+      outputDir: 'packages/core/src/query',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/request',
+      outputDir: 'packages/core/src/request',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/auth',
+      outputDir: 'packages/core/src/auth',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/error',
+      outputDir: 'packages/core/src/error',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/routes',
+      outputDir: 'packages/core/src/routes',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/ui',
+      outputDir: 'packages/core/src/ui',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/utils',
+      outputDir: 'packages/core/src/utils',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'core/lib',
+      outputDir: 'packages/core/src/lib',
+      layer: 'core',
+    },
+    {
+      sourceDir: 'wrappers/monorepo/core/src',
+      outputDir: 'packages/core/src',
+      layer: 'wrapper',
+    },
+    {
+      sourceDir: 'wrappers/monorepo/core',
+      outputDir: 'packages/core/src',
+      layer: 'wrapper',
+    },
+    {
+      sourceDir: 'wrappers/monorepo/request',
+      outputDir: 'packages/core/src/request',
+      layer: 'wrapper',
+    },
+    {
+      sourceDir: 'wrappers/monorepo/core-react/src',
+      outputDir: 'packages/core-react/src',
+      layer: 'wrapper',
+    },
+    {
+      sourceDir: 'wrappers/monorepo/core-next/src',
+      outputDir: 'packages/core-next/src',
+      layer: 'wrapper',
+    },
+  ],
+});
+
+export const runtimeLayouts = {
+  react: reactRuntimeLayout,
+  next: nextRuntimeLayout,
+  monorepo: monorepoRuntimeLayout,
+} as const satisfies Record<PresetId, PresetRuntimeLayout>;
+
+export function getRuntimeLayout(preset: PresetId) {
+  return runtimeLayouts[preset];
+}