frontpl 0.3.2 → 0.4.0

package/README.md

@@ -42,12 +42,14 @@ Generated lint-related dependencies (`oxlint`, `oxlint-tsgolint`, `oxfmt`, `@kin
 ### `frontpl [name]` / `frontpl init [name]`
 
 Scaffold a new project into `./<name>` (or prompt for a name when omitted).
+Project names support letters (including uppercase/camel case), numbers, `.`, `_`, `-` (cannot start with `.` or `_`).
 
 Generated output includes (based on options):
 
 - `.editorconfig`, `.gitignore`, `.gitattributes`
 - `package.json` (+ scripts like optional `lint`, `format:check`, `test`, `build`)
 - `tsconfig.json`, `src/index.ts`
+- Relative TypeScript imports use explicit `.ts` extensions (e.g. generated `src/index.test.ts`)
 - Optional configs: `oxlint.config.ts`, `.oxfmtrc.json`, `tsdown.config.ts`
 - Optional GitHub Actions workflows in `.github/workflows/`
 
@@ -64,6 +66,52 @@ What it does:
 - Optionally generates `.github/workflows/release.yml` (tag/commit/both)
 - Optionally generates `.github/dependabot.yml` with grouped updates (`dependencies`, `github-actions`)
 
+### `frontpl oxlint`
+
+Add/migrate linting in the current project to `oxlint`.
+
+What it does:
+
+- Asks strategy interactively:
+  - Migrate gradually (keep existing ESLint assets)
+  - Replace ESLint directly (current mode)
+- Ensures `package.json` scripts use:
+  - `lint`: `oxlint --type-aware --type-check`
+  - `lint:fix`: `oxlint --type-aware --type-check --fix`
+- Removes `typecheck: tsc --noEmit` when confirmed (or by default with `--yes`)
+- Ensures devDependencies exist:
+  - `oxlint`
+  - `oxlint-tsgolint`
+  - `@kingsword/lint-config`
+- Creates or updates `oxlint.config.ts` using `@kingsword/lint-config`
+- In replace mode, removes ESLint deps/configs (`eslint*`, `@eslint/*`, `@typescript-eslint/*`, `eslintConfig`, `.eslintrc*`, `eslint.config.*`)
+- Optionally installs dependencies with detected package manager
+
+Use `--yes` (or `-y`) to skip confirmations and apply default choices.
+With `--yes`, strategy defaults to `replace`.
+
+### `frontpl oxfmt`
+
+Add/migrate formatting in the current project to `oxfmt`.
+
+What it does:
+
+- Asks config strategy interactively:
+  - Migrate from Prettier (`oxfmt --migrate=prettier`)
+  - Rebuild `.oxfmtrc.json` (current mode)
+- Ensures `package.json` scripts use:
+  - `format`: `oxfmt`
+  - `format:check`: `oxfmt --check`
+  - `fmt`: `oxfmt`
+  - `fmt:check`: `oxfmt --check`
+- Ensures `devDependencies.oxfmt` exists (defaults to `latest` when missing)
+- Creates or updates `.oxfmtrc.json`
+- Optionally removes `prettier` / `prettier-plugin-*` / `@prettier/plugin-*` dependencies, `package.json#prettier`, and Prettier config files (`.prettierrc*`, `prettier.config.*`)
+- Optionally installs dependencies with detected package manager
+
+Use `--yes` (or `-y`) to skip confirmations and apply default choices.
+With `--yes`, config strategy defaults to rebuild `.oxfmtrc.json`.
+
 ## GitHub Actions (CI + Release)
 
 frontpl generates workflows that call reusable workflows from `kingsword09/workflows` (pinned to commit SHA + `# vX.Y.Z` comment by default):
@@ -100,6 +148,8 @@ pnpm run lint
 pnpm run build
 node dist/cli.mjs --help
 node dist/cli.mjs ci
+node dist/cli.mjs oxlint --help
+node dist/cli.mjs oxfmt --help
 ```
 
 ## Lint preset

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as runCi, t as runInit } from "./init-oJwslpqP.mjs";
+import { a as runCi, n as runOxlint, r as runInit, t as runOxfmt } from "./oxfmt-Bgtl3zwv.mjs";
 import bin from "tiny-bin";
 
 //#region src/cli.ts
@@ -10,6 +10,10 @@ async function main() {
 		await runInit({ nameArg: args[0] });
 	}).command("ci", "Add CI/release workflows to an existing project").action(async () => {
 		await runCi();
+	}).command("oxlint", "Add/migrate linter to oxlint in current project").option("--yes, -y", "Skip confirmations and use defaults").action(async (options) => {
+		await runOxlint({ yes: options.yes === true });
+	}).command("oxfmt", "Add/migrate formatter to oxfmt in current project").option("--yes, -y", "Skip confirmations and use defaults").action(async (options) => {
+		await runOxfmt({ yes: options.yes === true });
 	}).run();
 }
 main();

package/dist/index.d.mts

@@ -7,6 +7,23 @@ declare function runInit({
 }: {
   nameArg?: string;
 }): Promise<void>;
+declare function validateProjectName(value: string | undefined): "Project name is required" | "Project name is too long" | "Project name cannot start with '.'" | "Project name cannot start with '_'" | "Use letters, numbers, '.', '_' or '-'" | undefined;
+//#endregion
+//#region src/commands/oxlint.d.ts
+type CommandOptions$1 = {
+  yes?: boolean;
+};
+declare function runOxlint({
+  yes
+}?: CommandOptions$1): Promise<void>;
+//#endregion
+//#region src/commands/oxfmt.d.ts
+type CommandOptions = {
+  yes?: boolean;
+};
+declare function runOxfmt({
+  yes
+}?: CommandOptions): Promise<void>;
 //#endregion
 //#region src/lib/templates.d.ts
 declare function oxlintConfigTemplate({
@@ -48,4 +65,4 @@ declare function githubDependabotTemplate(opts: {
   workingDirectory: string;
 }): string;
 //#endregion
-export { githubCliCiWorkflowTemplate, githubDependabotTemplate, oxlintConfigTemplate, packageJsonTemplate, runCi, runInit };
+export { githubCliCiWorkflowTemplate, githubDependabotTemplate, oxlintConfigTemplate, packageJsonTemplate, runCi, runInit, runOxfmt, runOxlint, validateProjectName };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { a as oxlintConfigTemplate, i as githubDependabotTemplate, n as runCi, o as packageJsonTemplate, r as githubCliCiWorkflowTemplate, t as runInit } from "./init-oJwslpqP.mjs";
+import { a as runCi, c as oxlintConfigTemplate, i as validateProjectName, l as packageJsonTemplate, n as runOxlint, o as githubCliCiWorkflowTemplate, r as runInit, s as githubDependabotTemplate, t as runOxfmt } from "./oxfmt-Bgtl3zwv.mjs";
 
-export { githubCliCiWorkflowTemplate, githubDependabotTemplate, oxlintConfigTemplate, packageJsonTemplate, runCi, runInit };
+export { githubCliCiWorkflowTemplate, githubDependabotTemplate, oxlintConfigTemplate, packageJsonTemplate, runCi, runInit, runOxfmt, runOxlint, validateProjectName };

package/dist/{init-oJwslpqP.mjs → oxfmt-Bgtl3zwv.mjs}

@@ -1,5 +1,5 @@
 import { cancel, confirm, intro, isCancel, outro, select, spinner, text } from "@clack/prompts";
-import { access, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { access, mkdir, readFile, readdir, unlink, writeFile } from "node:fs/promises";
 import path from "node:path";
 import process from "node:process";
 import { spawn } from "node:child_process";
@@ -11,6 +11,48 @@ async function writeText(filePath, contents) {
 	await writeFile(filePath, contents, "utf8");
 }
 
+//#endregion
+//#region src/lib/utils.ts
+async function pathExists(pathname) {
+	try {
+		await access(pathname);
+		return true;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+//#region src/lib/project.ts
+async function readPackageJson(filePath) {
+	try {
+		return JSON.parse(await readFile(filePath, "utf8"));
+	} catch {
+		return;
+	}
+}
+async function writePackageJson(filePath, value) {
+	await writeText(filePath, JSON.stringify(value, null, 2) + "\n");
+}
+async function detectPackageManager(rootDir) {
+	const pmField = (await readPackageJson(path.join(rootDir, "package.json")))?.packageManager;
+	if (pmField) {
+		const pm = pmField.split("@")[0] ?? "";
+		if (isPackageManager(pm)) return pm;
+	}
+	const candidates = [];
+	if (await pathExists(path.join(rootDir, "pnpm-lock.yaml"))) candidates.push("pnpm");
+	if (await pathExists(path.join(rootDir, "yarn.lock"))) candidates.push("yarn");
+	if (await pathExists(path.join(rootDir, "package-lock.json"))) candidates.push("npm");
+	if (await pathExists(path.join(rootDir, "bun.lockb"))) candidates.push("bun");
+	if (await pathExists(path.join(rootDir, "bun.lock"))) candidates.push("bun");
+	if (await pathExists(path.join(rootDir, "deno.json")) || await pathExists(path.join(rootDir, "deno.jsonc"))) candidates.push("deno");
+	return candidates.length === 1 ? candidates[0] : void 0;
+}
+function isPackageManager(value) {
+	return value === "npm" || value === "pnpm" || value === "yarn" || value === "bun" || value === "deno";
+}
+
 //#endregion
 //#region src/lib/templates.ts
 function editorconfigTemplate() {
@@ -69,7 +111,7 @@ function srcIndexTemplate() {
 function srcVitestTemplate() {
 	return [
 		"import { describe, expect, it } from \"vitest\";",
-		"import { hello } from \"./index.js\";",
+		"import { hello } from \"./index.ts\";",
 		"",
 		"describe(\"hello\", () => {",
 		"  it(\"greets\", () => {",
@@ -333,17 +375,6 @@ function yamlString(value) {
 	return JSON.stringify(value);
 }
 
-//#endregion
-//#region src/lib/utils.ts
-async function pathExists(pathname) {
-	try {
-		await access(pathname);
-		return true;
-	} catch {
-		return false;
-	}
-}
-
 //#endregion
 //#region src/commands/ci.ts
 async function runCi() {
@@ -377,7 +408,7 @@ async function runCi() {
 				}
 			]
 		});
-		if (isCancel(packageManager)) return abort();
+		if (isCancel(packageManager)) return abort$2();
 		const candidates = await listPackageCandidates(rootDir, packageManager);
 		if (candidates.length === 0) {
 			cancel("No package found. Run this command in a project root (with package.json or deno.json).");
@@ -393,7 +424,7 @@ async function runCi() {
 				label: c
 			}))
 		});
-		if (isCancel(workingDirectory)) return abort();
+		if (isCancel(workingDirectory)) return abort$2();
 		const nodeVersionDefault = await detectNodeMajorVersion(rootDir) ?? 22;
 		const nodeVersionText = await text({
 			message: "Node.js major version (for GitHub Actions)",
@@ -403,14 +434,14 @@ async function runCi() {
 				if (!Number.isFinite(major) || major <= 0) return "Enter a valid major version (e.g. 22)";
 			}
 		});
-		if (isCancel(nodeVersionText)) return abort();
+		if (isCancel(nodeVersionText)) return abort$2();
 		const nodeVersion = Number.parseInt(String(nodeVersionText).trim(), 10);
 		const { runLint, runFormatCheck, runTests, lintCommand, formatCheckCommand, testCommand } = await resolveCiCommands(rootDir, workingDirectory, packageManager);
 		const addRelease = await confirm({
 			message: "Add release workflow too?",
 			initialValue: true
 		});
-		if (isCancel(addRelease)) return abort();
+		if (isCancel(addRelease)) return abort$2();
 		const releaseMode = addRelease ? await select({
 			message: "Release workflows",
 			initialValue: "tag",
@@ -429,17 +460,17 @@ async function runCi() {
 				}
 			]
 		}) : void 0;
-		if (isCancel(releaseMode)) return abort();
+		if (isCancel(releaseMode)) return abort$2();
 		const trustedPublishing = addRelease && packageManager !== "deno" ? await confirm({
 			message: "Release: npm trusted publishing (OIDC)?",
 			initialValue: true
 		}) : void 0;
-		if (isCancel(trustedPublishing)) return abort();
+		if (isCancel(trustedPublishing)) return abort$2();
 		const addDependabot = await pathExists(path.join(rootDir, ".git")) ? await confirm({
 			message: "Add/update Dependabot config (.github/dependabot.yml)?",
 			initialValue: true
 		}) : false;
-		if (isCancel(addDependabot)) return abort();
+		if (isCancel(addDependabot)) return abort$2();
 		const ciWorkflowPath = path.join(rootDir, ".github/workflows/ci.yml");
 		const releaseWorkflowPath = path.join(rootDir, ".github/workflows/release.yml");
 		const dependabotPath = path.join(rootDir, ".github/dependabot.yml");
@@ -475,19 +506,19 @@ async function runCi() {
 		}
 		outro(addRelease ? "Done. Generated CI + release workflows (and optional Dependabot)." : "Done. Generated CI workflow (and optional Dependabot).");
 	} catch (err) {
-		if (err instanceof CancelledError) return;
+		if (err instanceof CancelledError$2) return;
 		throw err;
 	}
 }
-var CancelledError = class extends Error {
+var CancelledError$2 = class extends Error {
 	constructor() {
 		super("Cancelled");
 	}
 };
-function abort(opts = {}) {
+function abort$2(opts = {}) {
 	cancel(opts.message ?? "Cancelled");
 	process.exitCode = opts.exitCode ?? 0;
-	throw new CancelledError();
+	throw new CancelledError$2();
 }
 async function confirmOverwriteIfExists(absPath, label) {
 	if (!await pathExists(absPath)) return true;
@@ -495,26 +526,9 @@ async function confirmOverwriteIfExists(absPath, label) {
 		message: `Overwrite existing ${label}?`,
 		initialValue: true
 	});
-	if (isCancel(overwrite)) return abort();
+	if (isCancel(overwrite)) return abort$2();
 	return overwrite;
 }
-function isPackageManager(value) {
-	return value === "npm" || value === "pnpm" || value === "yarn" || value === "bun" || value === "deno";
-}
-async function detectPackageManager(rootDir) {
-	const pmField = (await readPackageJson(path.join(rootDir, "package.json")))?.packageManager;
-	if (pmField) {
-		const pm = pmField.split("@")[0] ?? "";
-		if (isPackageManager(pm)) return pm;
-	}
-	const candidates = [];
-	if (await pathExists(path.join(rootDir, "pnpm-lock.yaml"))) candidates.push("pnpm");
-	if (await pathExists(path.join(rootDir, "yarn.lock"))) candidates.push("yarn");
-	if (await pathExists(path.join(rootDir, "package-lock.json"))) candidates.push("npm");
-	if (await pathExists(path.join(rootDir, "bun.lockb"))) candidates.push("bun");
-	if (await pathExists(path.join(rootDir, "deno.json")) || await pathExists(path.join(rootDir, "deno.jsonc"))) candidates.push("deno");
-	return candidates.length === 1 ? candidates[0] : void 0;
-}
 async function listPackageCandidates(rootDir, packageManager) {
 	const candidates = /* @__PURE__ */ new Set();
 	if (await pathExists(path.join(rootDir, "package.json"))) candidates.add(".");
@@ -564,7 +578,7 @@ async function resolveCiCommands(rootDir, workingDirectory, packageManager) {
 		runTests: true
 	};
 	const pkg = await readPackageJson(path.join(rootDir, workingDirectory, "package.json"));
-	if (!pkg) return abort({
+	if (!pkg) return abort$2({
 		message: `Missing package.json in ${workingDirectory}`,
 		exitCode: 1
 	});
@@ -580,17 +594,17 @@ async function resolveCiCommands(rootDir, workingDirectory, packageManager) {
 		message: `CI: run lint${hasLint ? "" : " (no lint script detected)"}`,
 		initialValue: runLintDefault
 	});
-	if (isCancel(runLint)) return abort();
+	if (isCancel(runLint)) return abort$2();
 	const runFormatCheck = await confirm({
 		message: `CI: run format check${runFormatCheckDefault ? "" : " (no format check script detected)"}`,
 		initialValue: runFormatCheckDefault
 	});
-	if (isCancel(runFormatCheck)) return abort();
+	if (isCancel(runFormatCheck)) return abort$2();
 	const runTests = await confirm({
 		message: `CI: run tests${hasTest ? "" : " (no test script detected)"}`,
 		initialValue: runTestsDefault
 	});
-	if (isCancel(runTests)) return abort();
+	if (isCancel(runTests)) return abort$2();
 	return {
 		runLint,
 		runFormatCheck,
@@ -606,7 +620,7 @@ async function promptCommand(message, initialValue) {
 		initialValue,
 		validate: (v = "") => !v.trim() ? "Command is required" : void 0
 	});
-	if (isCancel(value)) return abort();
+	if (isCancel(value)) return abort$2();
 	return String(value).trim();
 }
 function pmRun$1(pm, script) {
@@ -618,13 +632,6 @@ function pmRun$1(pm, script) {
 		case "deno": return script;
 	}
 }
-async function readPackageJson(filePath) {
-	try {
-		return JSON.parse(await readFile(filePath, "utf8"));
-	} catch {
-		return;
-	}
-}
 
 //#endregion
 //#region src/lib/exec.ts
@@ -918,8 +925,7 @@ function validateProjectName(value) {
 	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 '-'";
+	if (!/^[A-Za-z0-9._-]+$/.test(name)) return "Use letters, numbers, '.', '_' or '-'";
 }
 function onCancel() {
 	cancel("Cancelled");
@@ -936,4 +942,516 @@ function nextStepHint(pm) {
 }
 
 //#endregion
-export { oxlintConfigTemplate as a, githubDependabotTemplate as i, runCi as n, packageJsonTemplate as o, githubCliCiWorkflowTemplate as r, runInit as t };
+//#region src/commands/oxlint.ts
+const OXLINT_COMMAND = "oxlint --type-aware --type-check";
+const OXLINT_FIX_COMMAND = `${OXLINT_COMMAND} --fix`;
+const OXLINT_SCRIPTS = {
+	lint: OXLINT_COMMAND,
+	"lint:fix": OXLINT_FIX_COMMAND
+};
+const ESLINT_CONFIG_FILES = [
+	".eslintrc",
+	".eslintrc.js",
+	".eslintrc.cjs",
+	".eslintrc.mjs",
+	".eslintrc.json",
+	".eslintrc.yaml",
+	".eslintrc.yml",
+	".eslintrc.ts",
+	".eslintrc.cts",
+	".eslintrc.mts",
+	"eslint.config.js",
+	"eslint.config.cjs",
+	"eslint.config.mjs",
+	"eslint.config.ts",
+	"eslint.config.cts",
+	"eslint.config.mts"
+];
+const OXLINT_DEPENDENCIES = [
+	"oxlint",
+	"oxlint-tsgolint",
+	"@kingsword/lint-config"
+];
+async function runOxlint({ yes = false } = {}) {
+	try {
+		intro("frontpl (oxlint)");
+		const rootDir = process.cwd();
+		const packageJsonPath = path.join(rootDir, "package.json");
+		const oxlintConfigPath = path.join(rootDir, "oxlint.config.ts");
+		const pkg = await readPackageJson(packageJsonPath);
+		if (!pkg) {
+			cancel("Missing package.json. Run this command in a Node project root.");
+			process.exitCode = 1;
+			return;
+		}
+		const packageManager = await detectPackageManager(rootDir) ?? "pnpm";
+		const stats = await migrateToOxlint({
+			pkg,
+			rootDir,
+			oxlintConfigPath,
+			strategy: yes ? "replace" : await askMigrationStrategy({
+				rootDir,
+				pkg
+			}),
+			yes
+		});
+		await writePackageJson(packageJsonPath, pkg);
+		const installOk = await maybeInstallDependencies$1({
+			yes,
+			packageManager,
+			rootDir
+		});
+		const scriptSummary = stats.scriptsUpdated.length > 0 ? `updated scripts: ${stats.scriptsUpdated.join(", ")}` : stats.scriptsKept.length > 0 ? `kept existing scripts: ${stats.scriptsKept.join(", ")}` : "scripts already aligned";
+		const dependencySummary = stats.addedDevDependencies.length > 0 ? `added devDependencies: ${stats.addedDevDependencies.join(", ")}` : "required oxlint devDependencies already present";
+		const typecheckSummary = stats.removedTypecheckScript ? "removed redundant typecheck script (tsc --noEmit)" : "kept typecheck script";
+		const eslintDependencySummary = stats.removedDependencies.length > 0 ? `removed eslint deps: ${stats.removedDependencies.join(", ")}` : "no eslint deps removed";
+		const eslintConfigSummary = stats.removedPackageJsonEslintConfig ? "removed package.json#eslintConfig" : "no package.json#eslintConfig removed";
+		const eslintFileSummary = stats.removedConfigFiles.length > 0 ? `removed eslint config files: ${stats.removedConfigFiles.join(", ")}` : "no eslint config files removed";
+		const oxlintConfigSummary = stats.oxlintConfigAction === "written" ? "wrote oxlint.config.ts" : "kept existing oxlint.config.ts";
+		const installSummary = packageManager === "deno" ? "skipped dependency install (deno project)" : installOk === true ? `installed dependencies with ${packageManager}` : installOk === false ? `dependency install failed with ${packageManager}` : "skipped dependency install";
+		outro([
+			"Done. Applied oxlint migration.",
+			`- strategy: ${stats.strategy === "migrate" ? "migrate (keep ESLint assets)" : "replace ESLint assets"}`,
+			`- ${scriptSummary}`,
+			`- ${typecheckSummary}`,
+			`- ${dependencySummary}`,
+			`- ${eslintDependencySummary}`,
+			`- ${eslintConfigSummary}`,
+			`- ${eslintFileSummary}`,
+			`- ${oxlintConfigSummary}`,
+			`- ${installSummary}`
+		].join("\n"));
+	} catch (error) {
+		if (error instanceof CancelledError$1) return;
+		throw error;
+	}
+}
+async function migrateToOxlint(opts) {
+	const { pkg, rootDir, oxlintConfigPath, strategy, yes } = opts;
+	const scripts = { ...pkg.scripts };
+	const conflictingScripts = Object.entries(OXLINT_SCRIPTS).filter(([name, command]) => typeof scripts[name] === "string" && scripts[name] !== command).map(([name]) => name);
+	const shouldOverwriteConflicts = conflictingScripts.length === 0 ? true : yes ? true : await askConfirm$1({
+		message: `Overwrite conflicting scripts (${conflictingScripts.join(", ")}) with oxlint?`,
+		initialValue: true
+	});
+	const scriptsUpdated = [];
+	const scriptsKept = [];
+	for (const [name, command] of Object.entries(OXLINT_SCRIPTS)) {
+		const current = scripts[name];
+		if (current === command) continue;
+		if (current && !shouldOverwriteConflicts) {
+			scriptsKept.push(name);
+			continue;
+		}
+		scripts[name] = command;
+		scriptsUpdated.push(name);
+	}
+	let removedTypecheckScript = false;
+	if (scripts.typecheck === "tsc --noEmit") {
+		if (yes || await askConfirm$1({
+			message: "Remove redundant typecheck script (tsc --noEmit)?",
+			initialValue: true
+		})) {
+			delete scripts.typecheck;
+			removedTypecheckScript = true;
+		}
+	}
+	pkg.scripts = scripts;
+	const devDependencies = { ...pkg.devDependencies };
+	const addedDevDependencies = [];
+	for (const dependency of OXLINT_DEPENDENCIES) {
+		if (devDependencies[dependency]) continue;
+		devDependencies[dependency] = "latest";
+		addedDevDependencies.push(dependency);
+	}
+	pkg.devDependencies = devDependencies;
+	const oxlintConfigAction = await applyOxlintConfig({
+		pkg,
+		oxlintConfigPath,
+		yes
+	});
+	let removedDependencies = [];
+	let removedPackageJsonEslintConfig = false;
+	const removedConfigFiles = [];
+	if (strategy === "replace") {
+		removedDependencies = [...removeEslintDependencies(pkg, "dependencies"), ...removeEslintDependencies(pkg, "devDependencies")];
+		removedPackageJsonEslintConfig = removeEslintConfigFromPackageJson(pkg);
+		cleanupEmptyDependencyBuckets$1(pkg);
+		for (const file of ESLINT_CONFIG_FILES) {
+			const filePath = path.join(rootDir, file);
+			if (!await pathExists(filePath)) continue;
+			await unlink(filePath);
+			removedConfigFiles.push(file);
+		}
+	}
+	return {
+		strategy,
+		scriptsUpdated,
+		scriptsKept,
+		removedTypecheckScript,
+		addedDevDependencies,
+		removedDependencies,
+		removedPackageJsonEslintConfig,
+		removedConfigFiles,
+		oxlintConfigAction
+	};
+}
+async function maybeInstallDependencies$1(opts) {
+	const { yes, packageManager, rootDir } = opts;
+	if (packageManager === "deno") return void 0;
+	if (!(yes || await askConfirm$1({
+		message: `Install dependencies now with ${packageManager}?`,
+		initialValue: true
+	}))) return void 0;
+	const installSpinner = spinner();
+	installSpinner.start(`Installing dependencies with ${packageManager}`);
+	const result = await exec(packageManager, ["install"], { cwd: rootDir });
+	installSpinner.stop(result.ok ? "Dependencies installed" : "Dependency install failed");
+	return result.ok;
+}
+async function askConfirm$1(opts) {
+	const answer = await confirm({
+		message: opts.message,
+		initialValue: opts.initialValue
+	});
+	if (isCancel(answer)) return abort$1();
+	return answer;
+}
+async function askMigrationStrategy(opts) {
+	const strategy = await select({
+		message: "ESLint strategy",
+		initialValue: await detectEslintAssets(opts.rootDir, opts.pkg) ? "migrate" : "replace",
+		options: [{
+			value: "migrate",
+			label: "Migrate gradually (keep ESLint assets)"
+		}, {
+			value: "replace",
+			label: "Replace ESLint directly (current mode)"
+		}]
+	});
+	if (isCancel(strategy)) return abort$1();
+	return strategy;
+}
+async function detectEslintAssets(rootDir, pkg) {
+	if (Object.prototype.hasOwnProperty.call(pkg, "eslintConfig")) return true;
+	const dependencies = pkg.dependencies ?? {};
+	const devDependencies = pkg.devDependencies ?? {};
+	if (Object.keys(dependencies).some(isEslintDependency) || Object.keys(devDependencies).some(isEslintDependency)) return true;
+	for (const file of ESLINT_CONFIG_FILES) if (await pathExists(path.join(rootDir, file))) return true;
+	return false;
+}
+async function applyOxlintConfig(opts) {
+	const { pkg, oxlintConfigPath, yes } = opts;
+	if (!(!await pathExists(oxlintConfigPath) || yes || await askConfirm$1({
+		message: "Overwrite existing oxlint.config.ts?",
+		initialValue: true
+	}))) return "kept-existing";
+	await writeText(oxlintConfigPath, oxlintConfigTemplate({ useVitest: detectUseVitest(pkg.scripts) }));
+	return "written";
+}
+function detectUseVitest(scripts) {
+	return typeof scripts?.test === "string" && scripts.test.includes("vitest");
+}
+function removeEslintDependencies(pkg, key) {
+	const bucket = pkg[key];
+	if (!bucket) return [];
+	const removed = [];
+	for (const name of Object.keys(bucket)) {
+		if (!isEslintDependency(name)) continue;
+		delete bucket[name];
+		removed.push(name);
+	}
+	return removed;
+}
+function isEslintDependency(name) {
+	return name === "eslint" || name === "typescript-eslint" || name.startsWith("@eslint/") || name.startsWith("@typescript-eslint/") || name.startsWith("eslint-") || /(^|\/)eslint-(plugin|config|import-resolver)-/.test(name);
+}
+function removeEslintConfigFromPackageJson(pkg) {
+	if (!Object.prototype.hasOwnProperty.call(pkg, "eslintConfig")) return false;
+	delete pkg.eslintConfig;
+	return true;
+}
+function cleanupEmptyDependencyBuckets$1(pkg) {
+	if (pkg.dependencies && Object.keys(pkg.dependencies).length === 0) delete pkg.dependencies;
+	if (pkg.devDependencies && Object.keys(pkg.devDependencies).length === 0) delete pkg.devDependencies;
+}
+var CancelledError$1 = class extends Error {
+	constructor() {
+		super("Cancelled");
+	}
+};
+function abort$1(opts = {}) {
+	cancel(opts.message ?? "Cancelled");
+	process.exitCode = opts.exitCode ?? 0;
+	throw new CancelledError$1();
+}
+
+//#endregion
+//#region src/commands/oxfmt.ts
+const OXFMT_SCRIPTS = {
+	format: "oxfmt",
+	"format:check": "oxfmt --check",
+	fmt: "oxfmt",
+	"fmt:check": "oxfmt --check"
+};
+const PRETTIER_CONFIG_FILES = [
+	".prettierrc",
+	".prettierrc.json",
+	".prettierrc.json5",
+	".prettierrc.yaml",
+	".prettierrc.yml",
+	".prettierrc.toml",
+	".prettierrc.js",
+	".prettierrc.cjs",
+	".prettierrc.mjs",
+	".prettierrc.ts",
+	".prettierrc.cts",
+	".prettierrc.mts",
+	"prettier.config.js",
+	"prettier.config.cjs",
+	"prettier.config.mjs",
+	"prettier.config.ts",
+	"prettier.config.cts",
+	"prettier.config.mts"
+];
+async function runOxfmt({ yes = false } = {}) {
+	try {
+		intro("frontpl (oxfmt)");
+		const rootDir = process.cwd();
+		const packageJsonPath = path.join(rootDir, "package.json");
+		const oxfmtConfigPath = path.join(rootDir, ".oxfmtrc.json");
+		const pkg = await readPackageJson(packageJsonPath);
+		if (!pkg) {
+			cancel("Missing package.json. Run this command in a Node project root.");
+			process.exitCode = 1;
+			return;
+		}
+		const packageManager = await detectPackageManager(rootDir) ?? "pnpm";
+		const stats = await migrateToOxfmt({
+			pkg,
+			rootDir,
+			oxfmtConfigPath,
+			packageManager,
+			configMode: yes ? "rebuild" : await askConfigMode({
+				rootDir,
+				pkg
+			}),
+			yes
+		});
+		await writePackageJson(packageJsonPath, pkg);
+		const installOk = await maybeInstallDependencies({
+			yes,
+			packageManager,
+			rootDir
+		});
+		const scriptSummary = stats.scriptsUpdated.length > 0 ? `updated scripts: ${stats.scriptsUpdated.join(", ")}` : stats.scriptsKept.length > 0 ? `kept existing scripts: ${stats.scriptsKept.join(", ")}` : "scripts already aligned";
+		const depSummary = stats.addedOxfmtDependency ? "added devDependency: oxfmt" : "devDependency oxfmt already present";
+		const removedDepsSummary = stats.removedDependencies.length > 0 ? `removed prettier deps: ${stats.removedDependencies.join(", ")}` : "no prettier deps removed";
+		const removedPackageJsonPrettierSummary = stats.removedPackageJsonPrettierConfig ? "removed package.json#prettier" : "no package.json#prettier removed";
+		const removedFilesSummary = stats.removedConfigFiles.length > 0 ? `removed prettier config files: ${stats.removedConfigFiles.join(", ")}` : "no prettier config files removed";
+		const configSummary = stats.oxfmtConfigAction === "migrated" ? "migrated .oxfmtrc.json from prettier" : stats.oxfmtConfigAction === "rebuilt" ? "rebuilt .oxfmtrc.json" : "kept existing .oxfmtrc.json";
+		const installSummary = packageManager === "deno" ? "skipped dependency install (deno project)" : installOk === true ? `installed dependencies with ${packageManager}` : installOk === false ? `dependency install failed with ${packageManager}` : "skipped dependency install";
+		outro([
+			"Done. Applied oxfmt migration.",
+			`- ${scriptSummary}`,
+			`- ${depSummary}`,
+			`- ${removedDepsSummary}`,
+			`- ${removedPackageJsonPrettierSummary}`,
+			`- ${removedFilesSummary}`,
+			`- ${configSummary}`,
+			`- ${installSummary}`
+		].join("\n"));
+	} catch (error) {
+		if (error instanceof CancelledError) return;
+		throw error;
+	}
+}
+async function migrateToOxfmt(opts) {
+	const { pkg, rootDir, oxfmtConfigPath, packageManager, configMode, yes } = opts;
+	const scripts = { ...pkg.scripts };
+	const conflictingScripts = Object.entries(OXFMT_SCRIPTS).filter(([name, command]) => typeof scripts[name] === "string" && scripts[name] !== command).map(([name]) => name);
+	const shouldOverwriteConflicts = conflictingScripts.length === 0 ? true : yes ? true : await askConfirm({
+		message: `Overwrite conflicting scripts (${conflictingScripts.join(", ")}) with oxfmt?`,
+		initialValue: true
+	});
+	const scriptsUpdated = [];
+	const scriptsKept = [];
+	for (const [name, command] of Object.entries(OXFMT_SCRIPTS)) {
+		const current = scripts[name];
+		if (current === command) continue;
+		if (current && !shouldOverwriteConflicts) {
+			scriptsKept.push(name);
+			continue;
+		}
+		scripts[name] = command;
+		scriptsUpdated.push(name);
+	}
+	pkg.scripts = scripts;
+	const devDependencies = { ...pkg.devDependencies };
+	let addedOxfmtDependency = false;
+	if (!devDependencies.oxfmt) {
+		devDependencies.oxfmt = "latest";
+		addedOxfmtDependency = true;
+	}
+	pkg.devDependencies = devDependencies;
+	const removePrettier = yes ? true : await askConfirm({
+		message: "Remove prettier dependencies and config files?",
+		initialValue: true
+	});
+	const removedDependencies = [];
+	let removedPackageJsonPrettierConfig = false;
+	if (removePrettier) {
+		removedDependencies.push(...removePrettierDependencies(pkg, "dependencies"));
+		removedDependencies.push(...removePrettierDependencies(pkg, "devDependencies"));
+		removedPackageJsonPrettierConfig = removePrettierConfigFromPackageJson(pkg);
+		cleanupEmptyDependencyBuckets(pkg);
+	}
+	const oxfmtConfigAction = await applyOxfmtConfig({
+		rootDir,
+		oxfmtConfigPath,
+		packageManager,
+		configMode,
+		yes
+	});
+	const removedConfigFiles = [];
+	if (removePrettier) for (const file of PRETTIER_CONFIG_FILES) {
+		const filePath = path.join(rootDir, file);
+		if (!await pathExists(filePath)) continue;
+		await unlink(filePath);
+		removedConfigFiles.push(file);
+	}
+	return {
+		scriptsUpdated,
+		scriptsKept,
+		addedOxfmtDependency,
+		removedPackageJsonPrettierConfig,
+		removedDependencies,
+		removedConfigFiles,
+		oxfmtConfigAction
+	};
+}
+async function maybeInstallDependencies(opts) {
+	const { yes, packageManager, rootDir } = opts;
+	if (packageManager === "deno") return void 0;
+	if (!(yes || await askConfirm({
+		message: `Install dependencies now with ${packageManager}?`,
+		initialValue: true
+	}))) return void 0;
+	const installSpinner = spinner();
+	installSpinner.start(`Installing dependencies with ${packageManager}`);
+	const result = await exec(packageManager, ["install"], { cwd: rootDir });
+	installSpinner.stop(result.ok ? "Dependencies installed" : "Dependency install failed");
+	return result.ok;
+}
+async function askConfirm(opts) {
+	const answer = await confirm({
+		message: opts.message,
+		initialValue: opts.initialValue
+	});
+	if (isCancel(answer)) return abort();
+	return answer;
+}
+async function askConfigMode(opts) {
+	const mode = await select({
+		message: "Prettier config strategy",
+		initialValue: await detectPrettierConfig(opts.rootDir, opts.pkg) ? "migrate" : "rebuild",
+		options: [{
+			value: "migrate",
+			label: "Migrate from Prettier (oxfmt --migrate=prettier)"
+		}, {
+			value: "rebuild",
+			label: "Rebuild .oxfmtrc.json (current mode)"
+		}]
+	});
+	if (isCancel(mode)) return abort();
+	return mode;
+}
+async function detectPrettierConfig(rootDir, pkg) {
+	if (Object.prototype.hasOwnProperty.call(pkg, "prettier")) return true;
+	for (const file of PRETTIER_CONFIG_FILES) if (await pathExists(path.join(rootDir, file))) return true;
+	return false;
+}
+async function applyOxfmtConfig(opts) {
+	const { rootDir, oxfmtConfigPath, packageManager, configMode, yes } = opts;
+	if (!(!await pathExists(oxfmtConfigPath) || yes || await askConfirm({
+		message: configMode === "migrate" ? "Overwrite existing .oxfmtrc.json via prettier migration?" : "Overwrite existing .oxfmtrc.json?",
+		initialValue: true
+	}))) return "kept-existing";
+	if (configMode === "migrate") {
+		if (await runOxfmtPrettierMigration({
+			rootDir,
+			packageManager
+		})) return "migrated";
+		if (!(yes || await askConfirm({
+			message: "Migration failed. Rebuild .oxfmtrc.json with defaults instead?",
+			initialValue: true
+		}))) return "kept-existing";
+	}
+	await writeText(oxfmtConfigPath, oxfmtConfigTemplate());
+	return "rebuilt";
+}
+async function runOxfmtPrettierMigration(opts) {
+	const { rootDir, packageManager } = opts;
+	const migrateSpinner = spinner();
+	migrateSpinner.start("Migrating prettier config to .oxfmtrc.json");
+	if ((await exec("oxfmt", ["--migrate=prettier"], { cwd: rootDir })).ok) {
+		migrateSpinner.stop("Migrated config with oxfmt");
+		return true;
+	}
+	const fallbackRun = packageManager === "pnpm" ? await exec("pnpm", [
+		"exec",
+		"oxfmt",
+		"--migrate=prettier"
+	], { cwd: rootDir }) : packageManager === "npm" ? await exec("npm", [
+		"exec",
+		"oxfmt",
+		"--",
+		"--migrate=prettier"
+	], { cwd: rootDir }) : packageManager === "yarn" ? await exec("yarn", [
+		"dlx",
+		"oxfmt",
+		"--migrate=prettier"
+	], { cwd: rootDir }) : packageManager === "bun" ? await exec("bun", [
+		"x",
+		"oxfmt",
+		"--migrate=prettier"
+	], { cwd: rootDir }) : { ok: false };
+	migrateSpinner.stop(fallbackRun.ok ? "Migrated config with oxfmt" : "Prettier migration failed");
+	return fallbackRun.ok;
+}
+function removePrettierDependencies(pkg, key) {
+	const bucket = pkg[key];
+	if (!bucket) return [];
+	const removed = [];
+	for (const name of Object.keys(bucket)) {
+		if (!isPrettierDependency(name)) continue;
+		delete bucket[name];
+		removed.push(name);
+	}
+	return removed;
+}
+function cleanupEmptyDependencyBuckets(pkg) {
+	if (pkg.dependencies && Object.keys(pkg.dependencies).length === 0) delete pkg.dependencies;
+	if (pkg.devDependencies && Object.keys(pkg.devDependencies).length === 0) delete pkg.devDependencies;
+}
+function removePrettierConfigFromPackageJson(pkg) {
+	if (!Object.prototype.hasOwnProperty.call(pkg, "prettier")) return false;
+	delete pkg.prettier;
+	return true;
+}
+function isPrettierDependency(name) {
+	return name === "prettier" || /(^|\/)prettier-plugin-/.test(name) || name.startsWith("@prettier/plugin-");
+}
+var CancelledError = class extends Error {
+	constructor() {
+		super("Cancelled");
+	}
+};
+function abort(opts = {}) {
+	cancel(opts.message ?? "Cancelled");
+	process.exitCode = opts.exitCode ?? 0;
+	throw new CancelledError();
+}
+
+//#endregion
+export { runCi as a, oxlintConfigTemplate as c, validateProjectName as i, packageJsonTemplate as l, runOxlint as n, githubCliCiWorkflowTemplate as o, runInit as r, githubDependabotTemplate as s, runOxfmt as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontpl",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "Interactive CLI to scaffold standardized frontend project templates.",
   "keywords": [
     "cli",
@@ -53,11 +53,11 @@
     "tiny-bin": "^2.0.0"
   },
   "devDependencies": {
-    "@kingsword/lint-config": "^0.1.1",
+    "@kingsword/lint-config": "^0.2.1",
     "@types/node": "^25.0.10",
-    "oxfmt": "^0.31.0",
+    "oxfmt": "^0.32.0",
     "oxlint": "^1.46.0",
-    "oxlint-tsgolint": "^0.11.5",
+    "oxlint-tsgolint": "^0.13.0",
     "tsdown": "^0.20.1",
     "typescript": "^5.9.3"
   },