create-0to1-monorepo 0.1.0

package/README.md

@@ -0,0 +1,19 @@
+# create-0to1-monorepo
+
+`pnpm create 0to1-monorepo`로 현재 모노레포 템플릿을 새 디렉터리에 복사하는 create package입니다.
+
+## Usage
+
+```bash
+pnpm create 0to1-monorepo my-monorepo
+```
+
+의존성 설치를 생략하려면:
+
+```bash
+pnpm create 0to1-monorepo my-monorepo --no-install
+```
+
+## Publish flow
+
+이 패키지는 `prepack` 시점에 현재 워크스페이스를 `template/`으로 복사해서 publish 가능한 상태를 만듭니다.

package/bin/create-0to1-monorepo.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+
+import { execSync } from "node:child_process";
+import * as fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+
+import {
+  copyDirectoryContents,
+  copyRepositoryTemplate,
+} from "../lib/template.js";
+
+function detectPackageManager() {
+  const userAgent = process.env.npm_config_user_agent ?? "";
+
+  if (userAgent.includes("pnpm/")) {
+    return "pnpm";
+  }
+
+  if (userAgent.includes("yarn/")) {
+    return "yarn";
+  }
+
+  if (userAgent.includes("bun/")) {
+    return "bun";
+  }
+
+  return "npm";
+}
+
+function getInstallCommand(packageManager) {
+  switch (packageManager) {
+    case "pnpm":
+      return "pnpm install";
+    case "yarn":
+      return "yarn";
+    case "bun":
+      return "bun install";
+    default:
+      return "npm install";
+  }
+}
+
+function getDevCommand(packageManager) {
+  switch (packageManager) {
+    case "npm":
+      return "npm run dev";
+    case "bun":
+      return "bun run dev";
+    default:
+      return `${packageManager} dev`;
+  }
+}
+
+function sanitizePackageName(name) {
+  return name
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9-_]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+}
+
+function parseArguments(argv) {
+  const args = [...argv];
+  const options = {
+    install: true,
+    targetDirectory: "",
+  };
+
+  while (args.length > 0) {
+    const currentArg = args.shift();
+
+    if (!currentArg) {
+      continue;
+    }
+
+    if (currentArg === "--no-install") {
+      options.install = false;
+      continue;
+    }
+
+    if (currentArg.startsWith("-")) {
+      throw new Error(`지원하지 않는 옵션입니다: ${currentArg}`);
+    }
+
+    if (!options.targetDirectory) {
+      options.targetDirectory = currentArg;
+      continue;
+    }
+
+    throw new Error(`대상 디렉터리는 하나만 지정할 수 있습니다: ${currentArg}`);
+  }
+
+  return options;
+}
+
+async function promptForTargetDirectory() {
+  const readline = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  try {
+    const answer = await readline.question(
+      "생성할 디렉터리 이름을 입력하세요: ",
+    );
+
+    return answer.trim();
+  } finally {
+    readline.close();
+  }
+}
+
+function ensureCreatableDirectory(directoryPath) {
+  if (!fs.existsSync(directoryPath)) {
+    return;
+  }
+
+  const entries = fs.readdirSync(directoryPath);
+
+  if (entries.length > 0) {
+    throw new Error(`대상 디렉터리가 비어 있지 않습니다: ${directoryPath}`);
+  }
+}
+
+function updateRootPackageJson(targetDirectory, projectName) {
+  const packageJsonPath = path.join(targetDirectory, "package.json");
+
+  if (!fs.existsSync(packageJsonPath)) {
+    return;
+  }
+
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+  const sanitizedName = sanitizePackageName(projectName);
+
+  if (sanitizedName) {
+    packageJson.name = sanitizedName;
+  }
+
+  packageJson.private = true;
+
+  fs.writeFileSync(
+    packageJsonPath,
+    `${JSON.stringify(packageJson, null, 2)}\n`,
+    "utf-8",
+  );
+}
+
+function resolveTemplateSourceDirectory() {
+  const packageDirectory = path.resolve(
+    path.dirname(fileURLToPath(import.meta.url)),
+    "..",
+  );
+  const bundledTemplateDirectory = path.join(packageDirectory, "template");
+
+  if (fs.existsSync(bundledTemplateDirectory)) {
+    return {
+      mode: "bundled",
+      path: bundledTemplateDirectory,
+    };
+  }
+
+  return {
+    mode: "workspace",
+    path: path.resolve(packageDirectory, "..", ".."),
+  };
+}
+
+function copyTemplateIntoDirectory(targetDirectory) {
+  const templateSource = resolveTemplateSourceDirectory();
+
+  if (templateSource.mode === "bundled") {
+    copyDirectoryContents(templateSource.path, targetDirectory);
+    return;
+  }
+
+  copyRepositoryTemplate(templateSource.path, targetDirectory);
+}
+
+function printNextSteps(targetDirectory, packageManager, install) {
+  const relativeDirectory =
+    path.relative(process.cwd(), targetDirectory) || ".";
+  const directoryLabel = relativeDirectory.startsWith("..")
+    ? targetDirectory
+    : relativeDirectory;
+
+  console.log("");
+  console.log("완료되었습니다 🎉");
+  console.log("");
+  console.log("다음 단계:");
+  console.log(`  cd ${directoryLabel}`);
+
+  if (!install) {
+    console.log(`  ${getInstallCommand(packageManager)}`);
+  }
+
+  console.log(`  ${getDevCommand(packageManager)}`);
+}
+
+async function main() {
+  const options = parseArguments(process.argv.slice(2));
+  const targetInput =
+    options.targetDirectory || (await promptForTargetDirectory());
+
+  if (!targetInput) {
+    throw new Error("대상 디렉터리 이름이 필요합니다.");
+  }
+
+  const targetDirectory = path.resolve(process.cwd(), targetInput);
+  const packageManager = detectPackageManager();
+
+  ensureCreatableDirectory(targetDirectory);
+  fs.mkdirSync(targetDirectory, { recursive: true });
+
+  copyTemplateIntoDirectory(targetDirectory);
+  updateRootPackageJson(targetDirectory, path.basename(targetDirectory));
+
+  if (options.install) {
+    execSync(getInstallCommand(packageManager), {
+      cwd: targetDirectory,
+      stdio: "inherit",
+    });
+  }
+
+  printNextSteps(targetDirectory, packageManager, options.install);
+}
+
+main().catch((error) => {
+  console.error("");
+  console.error(
+    error instanceof Error ? error.message : "알 수 없는 오류가 발생했습니다.",
+  );
+  process.exit(1);
+});

package/lib/template.js

@@ -0,0 +1,132 @@
+import * as fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+export const ROOT_TEMPLATE_ENTRIES = [
+  ".changeset",
+  ".dockerignore",
+  ".github",
+  ".gitignore",
+  ".npmrc",
+  "README.md",
+  "apps",
+  "package.json",
+  "packages",
+  "pnpm-lock.yaml",
+  "pnpm-workspace.yaml",
+  "turbo",
+  "turbo.json",
+];
+
+const EXCLUDED_BASENAMES = new Set([
+  ".DS_Store",
+  ".git",
+  ".idea",
+  ".turbo",
+  ".vscode",
+  "node_modules",
+]);
+const EXCLUDED_ENV_FILE_NAMES = new Set([
+  ".env",
+  ".env.local",
+  ".env.development.local",
+  ".env.production.local",
+  ".env.test.local",
+]);
+const CREATE_PACKAGE_RELATIVE_PATH = path.join(
+  "packages",
+  "create-0to1-monorepo",
+);
+
+function normalizePath(filePath) {
+  return filePath.split(path.sep).join("/");
+}
+
+function shouldSkipPath(sourceRoot, currentPath) {
+  const relativePath = normalizePath(path.relative(sourceRoot, currentPath));
+
+  if (!relativePath || relativePath === ".") {
+    return false;
+  }
+
+  const segments = relativePath.split("/");
+
+  if (segments.some((segment) => EXCLUDED_BASENAMES.has(segment))) {
+    return true;
+  }
+
+  if (EXCLUDED_ENV_FILE_NAMES.has(path.basename(currentPath))) {
+    return true;
+  }
+
+  return relativePath === normalizePath(CREATE_PACKAGE_RELATIVE_PATH);
+}
+
+export function ensureEmptyDirectory(directoryPath) {
+  if (fs.existsSync(directoryPath)) {
+    fs.readdirSync(directoryPath).forEach((entryName) => {
+      fs.rmSync(path.join(directoryPath, entryName), {
+        force: true,
+        recursive: true,
+      });
+    });
+  }
+
+  fs.mkdirSync(directoryPath, { recursive: true });
+}
+
+export function copyDirectoryContents(sourceDirectory, destinationDirectory) {
+  ensureEmptyDirectory(destinationDirectory);
+
+  fs.readdirSync(sourceDirectory).forEach((entryName) => {
+    const sourcePath = path.join(sourceDirectory, entryName);
+    const destinationPath = path.join(destinationDirectory, entryName);
+
+    fs.cpSync(sourcePath, destinationPath, {
+      recursive: true,
+    });
+  });
+}
+
+export function copyRepositoryTemplate(sourceRoot, destinationDirectory) {
+  ensureEmptyDirectory(destinationDirectory);
+
+  ROOT_TEMPLATE_ENTRIES.forEach((entryName) => {
+    const sourcePath = path.join(sourceRoot, entryName);
+
+    if (!fs.existsSync(sourcePath)) {
+      return;
+    }
+
+    const destinationPath = path.join(destinationDirectory, entryName);
+
+    if (entryName === "packages") {
+      fs.mkdirSync(destinationPath, { recursive: true });
+
+      fs.readdirSync(sourcePath).forEach((packageName) => {
+        if (packageName === "create-0to1-monorepo") {
+          return;
+        }
+
+        const sourcePackagePath = path.join(sourcePath, packageName);
+        const destinationPackagePath = path.join(destinationPath, packageName);
+
+        fs.cpSync(sourcePackagePath, destinationPackagePath, {
+          filter: (currentPath) => !shouldSkipPath(sourceRoot, currentPath),
+          recursive: true,
+        });
+      });
+
+      return;
+    }
+
+    fs.cpSync(sourcePath, destinationPath, {
+      filter: (currentPath) => !shouldSkipPath(sourceRoot, currentPath),
+      recursive: true,
+    });
+  });
+}
+
+export function getPackageDirectory(metaUrl) {
+  return path.resolve(path.dirname(fileURLToPath(metaUrl)), "..");
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "create-0to1-monorepo",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "create-0to1-monorepo": "./bin/create-0to1-monorepo.js"
+  },
+  "files": [
+    "README.md",
+    "bin",
+    "lib",
+    "scripts",
+    "template"
+  ],
+  "scripts": {
+    "prepack": "node ./scripts/prepare-template.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/scripts/prepare-template.mjs

@@ -0,0 +1,14 @@
+import path from "node:path";
+
+import {
+  copyRepositoryTemplate,
+  getPackageDirectory,
+} from "../lib/template.js";
+
+const packageDirectory = getPackageDirectory(import.meta.url);
+const repositoryRoot = path.resolve(packageDirectory, "..", "..");
+const templateDirectory = path.join(packageDirectory, "template");
+
+copyRepositoryTemplate(repositoryRoot, templateDirectory);
+
+console.log(`Template prepared at ${templateDirectory}`);

package/template/.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

package/template/.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.2/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "restricted",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

package/template/.dockerignore

@@ -0,0 +1,38 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# Dependencies
+node_modules
+.pnp
+.pnp.js
+
+# Local env files
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Testing
+coverage
+
+# Turbo
+.turbo
+
+# Vercel
+.vercel
+
+# Build Outputs
+.next/
+out/
+build
+dist
+
+
+# Debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Misc
+.DS_Store
+*.pem

package/template/.github/workflows/workflow.yml

@@ -0,0 +1,42 @@
+name: workflow.yml
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "apps/project/**"
+      - "packages/**"
+      - 'pnpm-lock.yaml'
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 8
+
+      - name: Set Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build
+        # 모노레포의 특정 앱만 빌드 (출력 경로가 apps/web/dist라고 가정)
+        run: pnpm --filter ./apps/project build
+
+      - name: Publish to Cloudflare Pages
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: S_KZq6yVZIxowvPeXvOUbLfnGNCn2kTN33LlxH8e
+          accountId: 97f7cfcd2a80803fd63e1434b9e58ea1
+          packageManager: pnpm
+          command: pages deploy apps/project/dist --project-name=test