create-repoctl 0.0.13 → 0.1.0

package/README.md

@@ -1,13 +1,29 @@
 # create-repoctl
 
-`create-repoctl` 是 `create-icebreaker` 的 repoctl 品牌入口，方便用户用不同包管理器的 create 语法快速创建项目。
+English | [简体中文](README.zh-CN.md)
 
-## 使用方式
+The recommended create command for starting a repoctl-managed pnpm and Turborepo workspace.
 
-```sh
+```bash
 npm create repoctl@latest
 pnpm create repoctl
 yarn create repoctl
 ```
 
-这些命令会进入和 `create-icebreaker` 相同的脚手架流程：选择目标目录、选择保留模板，并在完成后提示 `pnpm setup` / `pnpm new` / `pnpm check` 等 repoctl onboarding 步骤。
+The interactive flow selects a target directory and any built-in templates to include. After creation:
+
+```bash
+cd <project>
+pnpm install
+pnpm exec repo init
+pnpm exec repo doctor
+pnpm exec repo check
+```
+
+Output is English by default. Pass `--lang zh-CN` or set `REPOCTL_LANG=zh-CN` for Simplified Chinese.
+
+```bash
+pnpm create repoctl -- --lang zh-CN
+```
+
+Documentation: https://repo.icebreaker.top

package/README.zh-CN.md

@@ -0,0 +1,25 @@
+# create-repoctl
+
+[English](README.md) | 简体中文
+
+用于创建 repoctl 管理的 pnpm 与 Turborepo 工作区的推荐 create 命令。
+
+```bash
+npm create repoctl@latest
+pnpm create repoctl
+yarn create repoctl
+```
+
+交互流程会选择目标目录和需要包含的内置模板。创建完成后运行：
+
+```bash
+cd <project>
+pnpm install
+pnpm exec repo init
+pnpm exec repo doctor
+pnpm exec repo check
+```
+
+默认输出英文。传入 `--lang zh-CN` 或设置 `REPOCTL_LANG=zh-CN` 可切换为简体中文。
+
+文档：https://repo.icebreaker.top

package/bin/create-repoctl.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import '../dist/index.mjs'
+import '../dist/cli.mjs'

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/cli.mjs

@@ -0,0 +1,9 @@
+import { t as createCreateRepoctlProgram } from "./src-B2gA_DOK.mjs";
+import process from "node:process";
+//#region src/cli.ts
+createCreateRepoctlProgram().parseAsync(process.argv).catch((error) => {
+	process.stderr.write(`[create-repoctl] ${error instanceof Error ? error.message : error}\n`);
+	process.exitCode = 1;
+});
+//#endregion
+export {};

package/dist/index.d.mts

@@ -1 +1,16 @@
-import "create-icebreaker";
+import { Command } from "@icebreakers/monorepo-templates";
+//#region src/i18n/index.d.ts
+type CreateRepoctlLocale = 'en' | 'zh-CN';
+declare function resolveCreateRepoctlLocale(argv?: readonly string[], env?: Record<string, string | undefined>): CreateRepoctlLocale;
+//#endregion
+//#region src/index.d.ts
+interface CreateRepoctlProgramOptions {
+  commandName?: string;
+  defaultTarget?: string;
+  cwd?: string;
+  argv?: readonly string[];
+  env?: Record<string, string | undefined>;
+}
+declare function createCreateRepoctlProgram(options?: CreateRepoctlProgramOptions): Command;
+//#endregion
+export { type CreateRepoctlLocale, CreateRepoctlProgramOptions, createCreateRepoctlProgram, resolveCreateRepoctlLocale };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import "create-icebreaker";
-export {};
+import { n as resolveCreateRepoctlLocale, t as createCreateRepoctlProgram } from "./src-B2gA_DOK.mjs";
+export { createCreateRepoctlProgram, resolveCreateRepoctlLocale };

package/dist/src-B2gA_DOK.mjs

@@ -0,0 +1,318 @@
+import path from "node:path";
+import process from "node:process";
+import { Command, checkbox, input, scaffoldWorkspace, templateChoices } from "@icebreakers/monorepo-templates";
+import fs from "node:fs/promises";
+//#region src/i18n/locales/en/error.ts
+const error$1 = {
+	commanderAllowedChoices: "Allowed choices are",
+	commanderArgumentMissing: "argument missing",
+	commanderDidYouMean: "Did you mean",
+	commanderDidYouMeanOneOf: "Did you mean one of",
+	commanderErrorPrefix: "error:",
+	commanderMissingRequiredArgument: "missing required argument",
+	commanderNotSpecified: "not specified",
+	commanderRequiredOption: "required option",
+	commanderTooManyArguments: "too many arguments",
+	commanderUnknownCommand: "unknown command",
+	commanderUnknownOption: "unknown option",
+	invalidLocale: "Unsupported locale: {locale}. Use en or zh-CN."
+};
+//#endregion
+//#region src/i18n/locales/en/help.ts
+const help$1 = {
+	argumentsTitle: "Arguments:",
+	choicesLabel: "choices:",
+	commandsTitle: "Commands:",
+	defaultLabel: "default:",
+	description: "Create a repoctl-managed pnpm and Turborepo workspace",
+	envLabel: "env:",
+	targetArgument: "Target directory",
+	templatesOption: "Comma-separated template keys or indexes to include",
+	forceOption: "Remove an existing target directory before creating the workspace",
+	globalOptionsTitle: "Global Options:",
+	helpOption: "Display help for command",
+	languageOption: "Output language: en or zh-CN",
+	optionsTitle: "Options:",
+	presetLabel: "preset:",
+	usageTitle: "Usage:"
+};
+//#endregion
+//#region src/i18n/locales/en/prompt.ts
+const prompt$1 = {
+	targetPrompt: "Project directory (default: {defaultDir})",
+	templatesPrompt: "Select templates to include (none by default)"
+};
+//#endregion
+//#region src/i18n/locales/en/report.ts
+const report$1 = {
+	unknownTemplates: "Ignoring unknown templates: {templates}",
+	complete: "Workspace created. Next steps:"
+};
+//#endregion
+//#region src/i18n/locales/en/index.ts
+const en = {
+	...help$1,
+	...prompt$1,
+	...report$1,
+	...error$1
+};
+//#endregion
+//#region src/i18n/locales/zh-CN/error.ts
+const error = {
+	commanderAllowedChoices: "可选值为",
+	commanderArgumentMissing: "缺少参数",
+	commanderDidYouMean: "你是否想输入",
+	commanderDidYouMeanOneOf: "你是否想输入以下之一",
+	commanderErrorPrefix: "错误：",
+	commanderMissingRequiredArgument: "缺少必填参数",
+	commanderNotSpecified: "未指定",
+	commanderRequiredOption: "必填选项",
+	commanderTooManyArguments: "参数过多",
+	commanderUnknownCommand: "未知命令",
+	commanderUnknownOption: "未知选项",
+	invalidLocale: "不支持的语言：{locale}。请使用 en 或 zh-CN。"
+};
+//#endregion
+//#region src/i18n/locales/zh-CN/help.ts
+const help = {
+	argumentsTitle: "参数：",
+	choicesLabel: "可选值：",
+	commandsTitle: "命令：",
+	defaultLabel: "默认值：",
+	description: "创建由 repoctl 管理的 pnpm 与 Turborepo 工作区",
+	envLabel: "环境变量：",
+	targetArgument: "目标目录",
+	templatesOption: "要包含的模板 key 或序号，以逗号分隔",
+	forceOption: "创建前删除已存在的目标目录",
+	globalOptionsTitle: "全局选项：",
+	helpOption: "显示命令帮助",
+	languageOption: "输出语言：en 或 zh-CN",
+	optionsTitle: "选项：",
+	presetLabel: "预设值：",
+	usageTitle: "用法："
+};
+//#endregion
+//#region src/i18n/locales/zh-CN/prompt.ts
+const prompt = {
+	targetPrompt: "项目目录（默认：{defaultDir}）",
+	templatesPrompt: "选择要包含的模板（默认不选择）"
+};
+//#endregion
+//#region src/i18n/locales/zh-CN/report.ts
+const report = {
+	unknownTemplates: "忽略未知模板：{templates}",
+	complete: "工作区创建完成。后续步骤："
+};
+//#endregion
+//#region src/i18n/locales/zh-CN/index.ts
+const zhCN = {
+	...help,
+	...prompt,
+	...report,
+	...error
+};
+//#endregion
+//#region src/i18n/index.ts
+const supportedLocales = ["en", "zh-CN"];
+function isCreateRepoctlLocale(value) {
+	return supportedLocales.includes(value);
+}
+function readArgvLocale(argv) {
+	const equalsArg = argv.find((arg) => arg.startsWith("--lang="));
+	if (equalsArg) return equalsArg.slice(7);
+	const index = argv.indexOf("--lang");
+	return index >= 0 ? argv[index + 1] : void 0;
+}
+function resolveCreateRepoctlLocale(argv = process.argv, env = process.env) {
+	const argvLocale = readArgvLocale(argv);
+	if (isCreateRepoctlLocale(argvLocale)) return argvLocale;
+	const envLocale = env["REPOCTL_LANG"];
+	return isCreateRepoctlLocale(envLocale) ? envLocale : "en";
+}
+function createTranslator(locale) {
+	const catalog = locale === "zh-CN" ? zhCN : en;
+	return (key, values = {}) => {
+		return Object.entries(values).reduce((result, [name, value]) => result.replaceAll(`{${name}}`, value), catalog[key]);
+	};
+}
+//#endregion
+//#region src/next-steps.ts
+function formatNextSteps(targetDir, cwd = process.cwd(), heading = "Workspace created. Next steps:") {
+	return [
+		"",
+		heading,
+		`  cd ${path.relative(cwd, targetDir) || "."}`,
+		"  pnpm install",
+		"  pnpm exec repo init",
+		"  pnpm exec repo doctor",
+		"  pnpm exec repo check",
+		""
+	].join("\n");
+}
+//#endregion
+//#region src/package-json.ts
+const repoctlPackageName = "repoctl";
+const legacyToolPackageName = "@icebreakers/monorepo";
+const publishedRepoctlVersion = "latest";
+async function updateRootPackageJson(targetDir, projectName) {
+	const pkgPath = path.join(targetDir, "package.json");
+	const raw = await fs.readFile(pkgPath, "utf8");
+	const pkg = JSON.parse(raw);
+	pkg.name = projectName;
+	const devDependencies = pkg.devDependencies;
+	if (devDependencies && devDependencies[legacyToolPackageName]) delete devDependencies[legacyToolPackageName];
+	if (devDependencies && devDependencies[repoctlPackageName]?.startsWith("workspace:")) devDependencies[repoctlPackageName] = publishedRepoctlVersion;
+	if (devDependencies && Object.keys(devDependencies).length === 0) delete pkg.devDependencies;
+	const scripts = pkg.scripts;
+	if (scripts) {
+		const nextScripts = {};
+		for (const [key, value] of Object.entries(scripts)) {
+			if (typeof value === "string" && value.includes("monorepo")) continue;
+			nextScripts[key] = value;
+		}
+		if (Object.keys(nextScripts).length) pkg.scripts = nextScripts;
+		else delete pkg.scripts;
+	}
+	await fs.writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, "utf8");
+}
+//#endregion
+//#region src/templates.ts
+const templateTokenSplitPattern = /[,\s]+/;
+const numericTemplatePattern = /^\d+$/;
+function parseTemplateInput(input) {
+	const selections = /* @__PURE__ */ new Set();
+	const unknown = [];
+	const tokens = input.split(templateTokenSplitPattern).map((token) => token.trim()).filter(Boolean);
+	for (const token of tokens) {
+		const normalized = token.toLowerCase();
+		if (numericTemplatePattern.test(normalized)) {
+			const choice = templateChoices[Number(normalized) - 1];
+			if (choice) selections.add(choice.key);
+			else unknown.push(token);
+			continue;
+		}
+		const match = templateChoices.find((item) => item.key === normalized);
+		if (match) selections.add(match.key);
+		else unknown.push(token);
+	}
+	return {
+		selections: [...selections],
+		unknown
+	};
+}
+function resolveTemplateSelections(input) {
+	if (!input) return {
+		selections: [],
+		unknown: []
+	};
+	return parseTemplateInput(input);
+}
+//#endregion
+//#region src/prompts.ts
+async function promptTargetDir(defaultDir, message) {
+	return ((await input({
+		message,
+		default: defaultDir
+	}))?.trim?.() ?? defaultDir) || defaultDir;
+}
+async function promptTemplates(message) {
+	return await checkbox({
+		message,
+		choices: templateChoices.map((item) => ({
+			name: `${item.key} - ${item.label}`,
+			value: item.key
+		}))
+	});
+}
+//#endregion
+//#region src/source-npm.ts
+async function scaffoldFromNpm(targetDir, selectedTemplates, force = false) {
+	await scaffoldWorkspace({
+		targetDir,
+		templateKeys: selectedTemplates,
+		targetMode: "prepare",
+		force
+	});
+}
+//#endregion
+//#region src/tsconfig.ts
+const workspaceRoots = [
+	"apps",
+	"packages",
+	"templates"
+];
+async function pathExists(targetPath) {
+	try {
+		await fs.access(targetPath);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function readWorkspaceReferences(targetDir, workspaceRoot) {
+	const rootDir = path.join(targetDir, workspaceRoot);
+	if (!await pathExists(rootDir)) return [];
+	const entries = await fs.readdir(rootDir, { withFileTypes: true });
+	const references = [];
+	for (const entry of entries) {
+		if (!entry.isDirectory()) continue;
+		const workspaceDir = path.join(rootDir, entry.name);
+		const [hasPackageJson, hasTsconfig] = await Promise.all([pathExists(path.join(workspaceDir, "package.json")), pathExists(path.join(workspaceDir, "tsconfig.json"))]);
+		if (hasPackageJson && hasTsconfig) references.push({ path: `./${workspaceRoot}/${entry.name}` });
+	}
+	return references;
+}
+async function updateRootTsconfigReferences(targetDir) {
+	const tsconfigPath = path.join(targetDir, "tsconfig.json");
+	const raw = await fs.readFile(tsconfigPath, "utf8");
+	const tsconfig = JSON.parse(raw);
+	const references = (await Promise.all(workspaceRoots.map((workspaceRoot) => readWorkspaceReferences(targetDir, workspaceRoot)))).flat();
+	tsconfig.extends = tsconfig.extends ?? "repoctl/tsconfig.json";
+	tsconfig.files = [];
+	tsconfig.references = references;
+	await fs.writeFile(tsconfigPath, `${JSON.stringify(tsconfig, null, 2)}\n`, "utf8");
+}
+//#endregion
+//#region src/index.ts
+function createCreateRepoctlProgram(options = {}) {
+	const commandName = options.commandName ?? "create-repoctl";
+	const defaultTarget = options.defaultTarget ?? "repoctl-workspace";
+	const cwd = options.cwd ?? process.cwd();
+	const t = createTranslator(resolveCreateRepoctlLocale(options.argv ?? process.argv, options.env ?? process.env));
+	const program = new Command();
+	const defaultHelp = program.createHelp();
+	const titles = {
+		"Arguments:": t("argumentsTitle"),
+		"Commands:": t("commandsTitle"),
+		"Global Options:": t("globalOptionsTitle"),
+		"Options:": t("optionsTitle"),
+		"Usage:": t("usageTitle")
+	};
+	const localizeHelpMetadata = (value) => value.replaceAll("choices:", t("choicesLabel")).replaceAll("default:", t("defaultLabel")).replaceAll("preset:", t("presetLabel")).replaceAll("env:", t("envLabel"));
+	const localizeCommanderError = (value) => value.replaceAll("Did you mean one of", t("commanderDidYouMeanOneOf")).replaceAll("Did you mean", t("commanderDidYouMean")).replaceAll("Allowed choices are", t("commanderAllowedChoices")).replaceAll("missing required argument", t("commanderMissingRequiredArgument")).replaceAll("required option", t("commanderRequiredOption")).replaceAll("argument missing", t("commanderArgumentMissing")).replaceAll("not specified", t("commanderNotSpecified")).replaceAll("too many arguments", t("commanderTooManyArguments")).replaceAll("unknown command", t("commanderUnknownCommand")).replaceAll("unknown option", t("commanderUnknownOption")).replace(/^error:/, t("commanderErrorPrefix"));
+	program.name(commandName).description(t("description")).argument("[dir]", t("targetArgument"), defaultTarget).option("-t, --templates <list>", t("templatesOption")).option("-f, --force", t("forceOption"), false).option("--lang <locale>", t("languageOption")).helpOption("-h, --help", t("helpOption")).configureOutput({ outputError: (value, write) => write(localizeCommanderError(value)) }).configureHelp({
+		argumentDescription: (argument) => localizeHelpMetadata(defaultHelp.argumentDescription(argument)),
+		optionDescription: (option) => localizeHelpMetadata(defaultHelp.optionDescription(option)),
+		styleTitle: (title) => titles[title] ?? title
+	}).action(async (targetDirInput, createOptions) => {
+		if (createOptions.lang && !isCreateRepoctlLocale(createOptions.lang)) throw new Error(t("invalidLocale", { locale: createOptions.lang }));
+		const isInteractive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+		let targetInput = targetDirInput || defaultTarget;
+		if (isInteractive) targetInput = await promptTargetDir(targetInput, t("targetPrompt", { defaultDir: targetInput }));
+		let selectedTemplates = [];
+		if (createOptions.templates) {
+			const { selections, unknown } = resolveTemplateSelections(createOptions.templates);
+			if (unknown.length) process.stderr.write(`${t("unknownTemplates", { templates: unknown.join(", ") })}\n`);
+			selectedTemplates = selections;
+		} else if (isInteractive) selectedTemplates = await promptTemplates(t("templatesPrompt"));
+		const targetDir = path.resolve(cwd, targetInput);
+		const projectName = path.basename(targetDir) || targetInput;
+		await scaffoldFromNpm(targetDir, selectedTemplates, Boolean(createOptions.force));
+		await updateRootPackageJson(targetDir, projectName);
+		await updateRootTsconfigReferences(targetDir);
+		process.stdout.write(formatNextSteps(targetDir, cwd, t("complete")));
+	});
+	return program;
+}
+//#endregion
+export { resolveCreateRepoctlLocale as n, createCreateRepoctlProgram as t };

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "create-repoctl",
   "type": "module",
-  "version": "0.0.13",
-  "description": "Bootstrap repoctl monorepo projects via npm create, yarn create, or pnpm create",
+  "version": "0.1.0",
+  "description": "Create a repoctl-managed pnpm and Turborepo workspace",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
+  "homepage": "https://repo.icebreaker.top",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/sonofmagic/monorepo-template.git",
+    "url": "git+https://github.com/sonofmagic/repoctl.git",
     "directory": "packages/create-repoctl"
   },
   "bugs": {
-    "url": "https://github.com/sonofmagic/monorepo-template/issues"
+    "url": "https://github.com/sonofmagic/repoctl/issues"
   },
   "keywords": [
     "repoctl",
@@ -21,6 +22,16 @@
     "scaffold"
   ],
   "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "bin": {
     "create-repoctl": "bin/create-repoctl.js"
   },
@@ -32,7 +43,10 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "create-icebreaker": "1.0.15"
+    "@icebreakers/monorepo-templates": "1.2.0"
+  },
+  "devDependencies": {
+    "tsd": "^0.33.0"
   },
   "publishConfig": {
     "access": "public"
@@ -40,7 +54,8 @@
   "scripts": {
     "dev": "tsdown --watch --sourcemap",
     "build": "tsdown",
-    "typecheck": "pnpm --filter create-icebreaker build && node ../../node_modules/typescript/bin/tsc -p tsconfig.json",
+    "typecheck": "pnpm --filter @icebreakers/monorepo-templates build && node ../../node_modules/typescript/bin/tsc -p tsconfig.json",
+    "tsd": "pnpm build && tsd --files test-d/**/*.test-d.ts",
     "lint": "eslint .",
     "test": "vitest run --passWithNoTests"
   }