frontpl 0.1.0

package/README.md

@@ -0,0 +1,11 @@
+# frontpl
+
+Interactive CLI to scaffold standardized frontend project templates.
+
+## Development
+
+```sh
+pnpm install
+pnpm run build
+node dist/cli.mjs --help
+```

package/dist/cli.d.mts

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

package/dist/cli.mjs

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { t as runInit } from "./init-Cva-s-yN.mjs";
+import bin from "tiny-bin";
+
+//#region src/cli.ts
+async function main() {
+	await bin("frontpl", "Scaffold standardized frontend templates").argument("[name]", "Project name (directory name)").action(async (_options, args) => {
+		await runInit({ nameArg: args[0] });
+	}).command("init", "Scaffold a new project").argument("[name]", "Project name (directory name)").action(async (_options, args) => {
+		await runInit({ nameArg: args[0] });
+	}).run();
+}
+main();
+
+//#endregion
+export {  };

package/dist/index.d.mts

@@ -0,0 +1,8 @@
+//#region src/commands/init.d.ts
+declare function runInit({
+  nameArg
+}: {
+  nameArg?: string;
+}): Promise<void>;
+//#endregion
+export { runInit };

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { t as runInit } from "./init-Cva-s-yN.mjs";
+
+export { runInit };

package/dist/init-Cva-s-yN.mjs

@@ -0,0 +1,380 @@
+import { cancel, confirm, intro, isCancel, outro, select, spinner, text } from "@clack/prompts";
+import { access, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import process from "node:process";
+import { spawn } from "node:child_process";
+import os from "node:os";
+
+//#region src/lib/exec.ts
+async function exec(command, args, opts = {}) {
+	const resolved = resolveCommand$1(command);
+	return new Promise((resolve) => {
+		const child = spawn(resolved, args, {
+			cwd: opts.cwd,
+			stdio: "inherit",
+			shell: false,
+			env: process.env
+		});
+		child.on("close", (code) => resolve({ ok: code === 0 }));
+		child.on("error", () => resolve({ ok: false }));
+	});
+}
+function resolveCommand$1(command) {
+	if (process.platform !== "win32") return command;
+	if (command === "npm") return "npm.cmd";
+	if (command === "pnpm") return "pnpm.cmd";
+	if (command === "yarn") return "yarn.cmd";
+	return command;
+}
+
+//#endregion
+//#region src/lib/versions.ts
+async function detectPackageManagerVersion(pm) {
+	switch (pm) {
+		case "npm": return (await execCapture("npm", ["--version"])).stdout.trim() || void 0;
+		case "pnpm": return (await execCapture("pnpm", ["--version"])).stdout.trim() || void 0;
+		case "yarn": return (await execCapture("yarn", ["--version"])).stdout.trim() || void 0;
+		case "bun": return (await execCapture("bun", ["--version"])).stdout.trim() || void 0;
+		case "deno": return ((await execCapture("deno", ["--version"])).stdout.trim().split("\n")[0] ?? "").match(/deno\\s+([0-9]+\\.[0-9]+\\.[0-9]+)/)?.[1];
+	}
+}
+async function execCapture(command, args) {
+	const resolved = resolveCommand(command);
+	return new Promise((resolve) => {
+		const child = spawn(resolved, args, {
+			cwd: os.tmpdir(),
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			],
+			shell: false,
+			env: process.env
+		});
+		const chunks = [];
+		child.stdout.on("data", (d) => chunks.push(Buffer.from(d)));
+		child.on("close", (code) => {
+			resolve({
+				ok: code === 0,
+				stdout: Buffer.concat(chunks).toString("utf8")
+			});
+		});
+		child.on("error", () => resolve({
+			ok: false,
+			stdout: ""
+		}));
+	});
+}
+function resolveCommand(command) {
+	if (process.platform !== "win32") return command;
+	if (command === "npm") return "npm.cmd";
+	if (command === "pnpm") return "pnpm.cmd";
+	if (command === "yarn") return "yarn.cmd";
+	return command;
+}
+
+//#endregion
+//#region src/lib/templates.ts
+function editorconfigTemplate() {
+	return [
+		"root = true",
+		"",
+		"[*]",
+		"charset = utf-8",
+		"end_of_line = lf",
+		"indent_style = space",
+		"indent_size = 2",
+		"insert_final_newline = true",
+		"trim_trailing_whitespace = true",
+		"",
+		"[*.md]",
+		"trim_trailing_whitespace = false",
+		""
+	].join("\n");
+}
+function gitignoreTemplate() {
+	return [
+		"node_modules",
+		"dist",
+		"coverage",
+		"*.log",
+		".DS_Store",
+		".env",
+		".env.*",
+		""
+	].join("\n");
+}
+function gitattributesTemplate() {
+	return ["* text=auto eol=lf", ""].join("\n");
+}
+function tsconfigTemplate() {
+	return JSON.stringify({
+		compilerOptions: {
+			target: "ES2022",
+			module: "ESNext",
+			moduleResolution: "Bundler",
+			strict: true,
+			skipLibCheck: true,
+			noEmit: true
+		},
+		include: ["src"]
+	}, null, 2) + "\n";
+}
+function srcIndexTemplate() {
+	return [
+		"export function hello(name: string) {",
+		"  return `Hello, ${name}`;",
+		"}",
+		""
+	].join("\n");
+}
+function srcVitestTemplate() {
+	return [
+		"import { describe, expect, it } from \"vitest\";",
+		"import { hello } from \"./index.js\";",
+		"",
+		"describe(\"hello\", () => {",
+		"  it(\"greets\", () => {",
+		"    expect(hello(\"world\")).toBe(\"Hello, world\");",
+		"  });",
+		"});",
+		""
+	].join("\n");
+}
+function readmeTemplate(projectName) {
+	return [
+		`# ${projectName}`,
+		"",
+		"Generated by `frontpl`.",
+		""
+	].join("\n");
+}
+function oxlintConfigTemplate({ useVitest }) {
+	return JSON.stringify({
+		$schema: "https://json.schemastore.org/oxlintrc.json",
+		env: {
+			browser: true,
+			es2022: true
+		}
+	}, null, 2) + "\n";
+}
+function oxfmtConfigTemplate() {
+	return JSON.stringify({ $schema: "https://json.schemastore.org/oxfmtrc.json" }, null, 2) + "\n";
+}
+function tsdownConfigTemplate() {
+	return [
+		"import { defineConfig } from \"tsdown\";",
+		"",
+		"export default defineConfig({",
+		"  entry: [\"src/index.ts\"],",
+		"  platform: \"browser\"",
+		"});",
+		""
+	].join("\n");
+}
+function packageJsonTemplate(opts) {
+	const scripts = { typecheck: "tsc --noEmit" };
+	if (opts.useOxlint) {
+		const oxlintCmd = [
+			"oxlint",
+			opts.useVitest ? "--vitest-plugin" : void 0,
+			"--type-aware",
+			"--type-check"
+		].filter(Boolean).join(" ");
+		scripts.lint = oxlintCmd;
+		scripts["lint:fix"] = `${oxlintCmd} --fix`;
+	}
+	if (opts.useOxfmt) {
+		scripts.fmt = "oxfmt";
+		scripts["fmt:check"] = "oxfmt --check";
+	}
+	if (opts.useVitest) scripts.test = "vitest";
+	if (opts.useTsdown) scripts.build = "tsdown";
+	const devDependencies = { typescript: opts.typescriptVersion };
+	if (opts.useOxlint) {
+		if (opts.oxlintVersion) devDependencies.oxlint = opts.oxlintVersion;
+		if (opts.oxlintTsgolintVersion) devDependencies["oxlint-tsgolint"] = opts.oxlintTsgolintVersion;
+	}
+	if (opts.useOxfmt && opts.oxfmtVersion) devDependencies.oxfmt = opts.oxfmtVersion;
+	if (opts.useVitest && opts.vitestVersion) devDependencies.vitest = opts.vitestVersion;
+	if (opts.useTsdown && opts.tsdownVersion) devDependencies.tsdown = opts.tsdownVersion;
+	return JSON.stringify({
+		name: opts.name,
+		version: "0.0.0",
+		private: true,
+		type: "module",
+		scripts,
+		devDependencies,
+		packageManager: opts.packageManager
+	}, null, 2) + "\n";
+}
+
+//#endregion
+//#region src/lib/utils.ts
+async function pathExists(pathname) {
+	try {
+		await access(pathname);
+		return true;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+//#region src/commands/init.ts
+async function runInit({ nameArg }) {
+	intro("frontpl");
+	const projectName = await text({
+		message: "Project name",
+		initialValue: nameArg ?? "my-frontend",
+		validate: validateProjectName
+	});
+	if (isCancel(projectName)) return onCancel();
+	const packageManager = await select({
+		message: "Package manager",
+		initialValue: "pnpm",
+		options: [
+			{
+				value: "npm",
+				label: "npm"
+			},
+			{
+				value: "yarn",
+				label: "yarn"
+			},
+			{
+				value: "pnpm",
+				label: "pnpm"
+			},
+			{
+				value: "bun",
+				label: "bun"
+			},
+			{
+				value: "deno",
+				label: "deno"
+			}
+		]
+	});
+	if (isCancel(packageManager)) return onCancel();
+	const pnpmWorkspace = packageManager === "pnpm" ? await confirm({
+		message: "pnpm workspace mode (monorepo skeleton)?",
+		initialValue: false
+	}) : false;
+	if (isCancel(pnpmWorkspace)) return onCancel();
+	const useOxlint = await confirm({
+		message: "Enable oxlint (type-aware + type-check via tsgolint)?",
+		initialValue: true
+	});
+	if (isCancel(useOxlint)) return onCancel();
+	const useOxfmt = await confirm({
+		message: "Enable oxfmt (code formatting)?",
+		initialValue: true
+	});
+	if (isCancel(useOxfmt)) return onCancel();
+	const useVitest = await confirm({
+		message: "Add Vitest?",
+		initialValue: false
+	});
+	if (isCancel(useVitest)) return onCancel();
+	const useTsdown = await confirm({
+		message: "Add tsdown build?",
+		initialValue: true
+	});
+	if (isCancel(useTsdown)) return onCancel();
+	const initGit = await confirm({
+		message: "Initialize a git repository?",
+		initialValue: true
+	});
+	if (isCancel(initGit)) return onCancel();
+	const rootDir = path.resolve(process.cwd(), projectName);
+	if (await pathExists(rootDir)) {
+		cancel(`Directory already exists: ${rootDir}`);
+		process.exitCode = 1;
+		return;
+	}
+	const pkgDir = pnpmWorkspace ? path.join(rootDir, "packages", projectName) : rootDir;
+	const pmVersion = await detectPackageManagerVersion(packageManager);
+	const packageManagerField = pmVersion ? `${packageManager}@${pmVersion}` : `${packageManager}@latest`;
+	await mkdir(path.join(pkgDir, "src"), { recursive: true });
+	await Promise.all([
+		writeText(path.join(rootDir, ".editorconfig"), editorconfigTemplate()),
+		writeText(path.join(rootDir, ".gitignore"), gitignoreTemplate()),
+		writeText(path.join(rootDir, ".gitattributes"), gitattributesTemplate())
+	]);
+	if (pnpmWorkspace) {
+		await writeText(path.join(rootDir, "pnpm-workspace.yaml"), [
+			"packages:",
+			"  - \"packages/*\"",
+			""
+		].join("\n"));
+		await writeText(path.join(rootDir, "package.json"), JSON.stringify({
+			name: projectName,
+			private: true,
+			packageManager: packageManagerField
+		}, null, 2) + "\n");
+	}
+	await Promise.all([
+		writeText(path.join(pkgDir, "README.md"), readmeTemplate(projectName)),
+		writeText(path.join(pkgDir, "src/index.ts"), srcIndexTemplate()),
+		writeText(path.join(pkgDir, "tsconfig.json"), tsconfigTemplate()),
+		writeText(path.join(pkgDir, "package.json"), packageJsonTemplate({
+			name: projectName,
+			packageManager: packageManagerField,
+			typescriptVersion: "latest",
+			useOxlint,
+			oxlintVersion: "latest",
+			oxlintTsgolintVersion: "latest",
+			useOxfmt,
+			oxfmtVersion: "latest",
+			useVitest,
+			vitestVersion: "latest",
+			useTsdown,
+			tsdownVersion: "latest"
+		}))
+	]);
+	if (useOxlint) await writeText(path.join(pkgDir, ".oxlintrc.json"), oxlintConfigTemplate({ useVitest }));
+	if (useOxfmt) await writeText(path.join(pkgDir, ".oxfmtrc.json"), oxfmtConfigTemplate());
+	if (useVitest) await writeText(path.join(pkgDir, "src/index.test.ts"), srcVitestTemplate());
+	if (useTsdown) await writeText(path.join(pkgDir, "tsdown.config.ts"), tsdownConfigTemplate());
+	if (packageManager === "deno") await writeText(path.join(rootDir, "deno.json"), JSON.stringify({ nodeModulesDir: "auto" }, null, 2) + "\n");
+	const canInstall = Boolean(pmVersion);
+	let installOk = false;
+	if (canInstall) {
+		const installSpinner = spinner();
+		installSpinner.start(`Installing dependencies with ${packageManager}`);
+		installOk = (await exec(packageManager, ["install"], { cwd: rootDir })).ok;
+		installSpinner.stop(installOk ? "Dependencies installed" : "Install failed (skipped)");
+	}
+	if (initGit) await exec("git", ["init"], { cwd: rootDir });
+	outro(`Done. Next:\n  cd ${projectName}${!canInstall ? `\n  (${packageManager} not found, run install manually)` : !installOk ? `\n  (${packageManager} install failed, run install manually)` : ""}\n  ${nextStepHint(packageManager)}`);
+}
+function validateProjectName(value) {
+	const name = value.trim();
+	if (!name) return "Project name is required";
+	if (name.length > 214) return "Project name is too long";
+	if (name.startsWith(".")) return "Project name cannot start with '.'";
+	if (name.startsWith("_")) return "Project name cannot start with '_'";
+	if (/[A-Z]/.test(name)) return "Use lowercase letters only";
+	if (!/^[a-z0-9._-]+$/.test(name)) return "Use letters, numbers, '.', '_' or '-'";
+}
+function onCancel() {
+	cancel("Cancelled");
+	process.exitCode = 0;
+}
+async function writeText(filePath, contents) {
+	await mkdir(path.dirname(filePath), { recursive: true });
+	await writeFile(filePath, contents, "utf8");
+}
+function nextStepHint(pm) {
+	switch (pm) {
+		case "npm": return "npm run typecheck";
+		case "pnpm": return "pnpm run typecheck";
+		case "yarn": return "yarn typecheck";
+		case "bun": return "bun run typecheck";
+		case "deno": return "deno task typecheck  # (or run the package.json scripts with your preferred runner)";
+	}
+}
+
+//#endregion
+export { runInit as t };

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "frontpl",
+  "version": "0.1.0",
+  "description": "Interactive CLI to scaffold standardized frontend project templates.",
+  "keywords": [
+    "cli",
+    "frontend",
+    "generator",
+    "scaffold",
+    "template"
+  ],
+  "homepage": "https://github.com/kingsword09/frontpl#readme",
+  "bugs": {
+    "url": "https://github.com/kingsword09/frontpl/issues"
+  },
+  "license": "MIT",
+  "author": "Kingsword kingsword09 <kingsword09@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kingsword09/frontpl.git"
+  },
+  "bin": {
+    "frontpl": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "start": "node dist/cli.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "oxlint --type-aware --type-check",
+    "lint:fix": "oxlint --type-aware --type-check --fix",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
+    "fmt": "pnpm run format",
+    "fmt:check": "pnpm run format:check",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "tiny-bin": "^1.11.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.10",
+    "oxfmt": "^0.26.0",
+    "oxlint": "^1.41.0",
+    "oxlint-tsgolint": "^0.11.1",
+    "tsdown": "^0.20.1",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "packageManager": "pnpm@10.28.1"
+}