howone 0.0.3

package/bin/index.d.mts

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

package/bin/index.mjs

@@ -0,0 +1,294 @@
+#!/usr/bin/env bun
+import { createRequire } from "node:module";
+import { cancel, confirm, intro, isCancel, outro, select, spinner, text } from "@clack/prompts";
+import { cac } from "cac";
+import { readdir, rename, stat } from "node:fs/promises";
+import { copy, emptyDir, ensureDir, pathExists } from "fs-extra/esm";
+import pc from "picocolors";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import validatePackageName from "validate-npm-package-name";
+//#region src/index.ts
+const packageJson = createRequire(import.meta.url)("../package.json");
+const DEFAULT_PROJECT_NAME = "howone-app";
+const TEMPLATES = ["vite", "nextjs"];
+const TEMPLATE_ALIASES = {
+	vite: "vite",
+	next: "nextjs",
+	nextjs: "nextjs"
+};
+var CliError = class extends Error {
+	constructor(code, message, details) {
+		super(message);
+		this.code = code;
+		this.details = details;
+		this.name = "CliError";
+	}
+};
+const cli = cac("howone");
+cli.version(packageJson.version, "-v, --version");
+cli.help();
+cli.command("create [projectName] [legacyProjectName]", "Create a new project from a HowOne template.").alias("new").alias("init").option("-t, --template <template>", "Template to use: vite, nextjs").option("--vite", "Shortcut for --template vite").option("--nextjs", "Shortcut for --template nextjs").option("--next", "Alias for --nextjs").option("-f, --force", "Overwrite an existing non-empty target directory").option("-y, --yes", "Disable prompts and accept defaults where possible").option("--json", "Print machine-readable JSON output").option("--cwd <dir>", "Directory in which to create the project").example("howone vite my-app").example("howone next my-app").example("howone create my-app --template vite").example("howone create my-app --template nextjs --yes").example("howone create my-app --template vite --json --yes").example("howone create template --vite my-app").action((projectName, legacyProjectName, options) => {
+	runCreate(projectName, legacyProjectName, options).catch((error) => handleFatalError(error, Boolean(options.json)));
+});
+try {
+	cli.parse(normalizeCliArgv(process.argv), { run: true });
+} catch (error) {
+	handleFatalError(error, process.argv.includes("--json"));
+}
+function normalizeCliArgv(argv) {
+	if (argv.length < 3) return argv;
+	const runtime = argv[0];
+	const script = argv[1];
+	const userArgs = argv.slice(2);
+	const first = userArgs[0];
+	if (!first || first === "create" || first === "new" || first === "init" || first === "--help" || first === "-h") return normalizeCreateSubcommandArgv(argv);
+	const template = resolveTemplateAlias(first);
+	if (template) return [
+		runtime,
+		script,
+		"create",
+		...userArgs.slice(1),
+		"--template",
+		template
+	];
+	if (!first.startsWith("-") && hasTemplateFlag(userArgs)) return [
+		runtime,
+		script,
+		"create",
+		...userArgs
+	];
+	return argv;
+}
+function normalizeCreateSubcommandArgv(argv) {
+	const runtime = argv[0];
+	const script = argv[1];
+	const command = argv[2];
+	const rest = argv.slice(3);
+	if (!command || command !== "create" && command !== "new" && command !== "init") return argv;
+	const first = rest[0];
+	const template = resolveTemplateAlias(first);
+	if (!template) return argv;
+	return [
+		runtime,
+		script,
+		command,
+		...rest.slice(1),
+		"--template",
+		template
+	];
+}
+function resolveTemplateAlias(value) {
+	if (!value) return void 0;
+	const normalized = TEMPLATE_ALIASES[value];
+	return normalized && isTemplate(normalized) ? normalized : void 0;
+}
+function hasTemplateFlag(args) {
+	return args.some((arg) => arg === "--vite" || arg === "--next" || arg === "--nextjs" || arg === "--template");
+}
+async function runCreate(projectNameArg, legacyProjectNameArg, options) {
+	const plan = await resolveCreatePlan(projectNameArg, legacyProjectNameArg, options, path.resolve(options.cwd ?? process.cwd()), process.stdout.isTTY && !options.yes && !options.json);
+	if (!options.json) intro(pc.bold("HowOne"));
+	await createTemplate(plan, Boolean(options.json));
+	const result = {
+		ok: true,
+		command: "create",
+		template: plan.template,
+		projectName: plan.projectName,
+		targetDir: plan.targetDir,
+		packageManager: "bun",
+		nextSteps: [
+			`cd ${formatPathForShell(path.relative(plan.cwd, plan.targetDir) || ".")}`,
+			"bun install",
+			"bun run dev"
+		]
+	};
+	if (options.json) {
+		console.log(JSON.stringify(result, null, 2));
+		return;
+	}
+	outro([
+		`${pc.green("Created")} ${pc.bold(plan.template)} template in ${pc.cyan(path.relative(plan.cwd, plan.targetDir) || ".")}`,
+		"",
+		pc.bold("Next steps:"),
+		...result.nextSteps.map((step) => `  ${step}`)
+	].join("\n"));
+}
+async function resolveCreatePlan(projectNameArg, legacyProjectNameArg, options, cwd, isInteractive) {
+	const template = resolveTemplateOption(options);
+	const projectName = projectNameArg === "template" ? legacyProjectNameArg : projectNameArg;
+	const resolvedTemplate = template ?? (isInteractive ? await promptTemplate() : void 0);
+	if (!resolvedTemplate) throw new CliError("E_TEMPLATE_REQUIRED", "Missing template. Use --template vite or --template nextjs.");
+	const resolvedProjectName = projectName ?? (isInteractive ? await promptProjectName() : DEFAULT_PROJECT_NAME);
+	validateProjectName(resolvedProjectName);
+	const targetDir = path.resolve(cwd, resolvedProjectName);
+	const force = Boolean(options.force);
+	if (!force && await isNonEmptyDirectory(targetDir)) {
+		const entries = await readdir(targetDir);
+		if (!isInteractive) throw new CliError("E_TARGET_NOT_EMPTY", `Target directory already exists and is not empty: ${targetDir}`, {
+			targetDir,
+			entries: entries.slice(0, 20),
+			retryWithForce: [
+				"howone",
+				"create",
+				resolvedProjectName,
+				"--template",
+				resolvedTemplate,
+				"--cwd",
+				cwd,
+				"--force",
+				"--yes",
+				...options.json ? ["--json"] : []
+			]
+		});
+		const shouldOverwrite = await confirm({
+			message: `Directory "${path.relative(cwd, targetDir) || "."}" is not empty. Overwrite it?`,
+			initialValue: false
+		});
+		if (isCancel(shouldOverwrite) || !shouldOverwrite) {
+			cancel("Cancelled.");
+			process.exit(0);
+		}
+	}
+	await assertTargetWritable(targetDir);
+	return {
+		template: resolvedTemplate,
+		projectName: resolvedProjectName,
+		targetDir,
+		force,
+		cwd
+	};
+}
+function resolveTemplateOption(options) {
+	const flags = [
+		options.template,
+		options.vite ? "vite" : void 0,
+		options.nextjs || options.next ? "nextjs" : void 0
+	].filter(Boolean);
+	if (flags.length > 1) throw new CliError("E_TEMPLATE_CONFLICT", "Use only one template option.");
+	const template = flags[0];
+	if (!template) return void 0;
+	if (!isTemplate(template)) throw new CliError("E_TEMPLATE_INVALID", `Unsupported template "${template}". Use vite or nextjs.`);
+	return template;
+}
+async function promptTemplate() {
+	const value = await select({
+		message: "Choose a template",
+		options: [{
+			value: "vite",
+			label: "Vite React TypeScript",
+			hint: "Fast SPA starter"
+		}, {
+			value: "nextjs",
+			label: "Next.js App Router TypeScript",
+			hint: "Full-stack app starter"
+		}],
+		initialValue: "vite"
+	});
+	if (isCancel(value)) {
+		cancel("Cancelled.");
+		process.exit(0);
+	}
+	if (!isTemplate(value)) throw new CliError("E_TEMPLATE_INVALID", `Unsupported template "${value}". Use vite or nextjs.`);
+	return value;
+}
+async function promptProjectName() {
+	const value = await text({
+		message: "Project name",
+		placeholder: DEFAULT_PROJECT_NAME,
+		defaultValue: DEFAULT_PROJECT_NAME,
+		validate(value) {
+			try {
+				validateProjectName(value ?? "");
+				return;
+			} catch (error) {
+				return error instanceof Error ? error.message : String(error);
+			}
+		}
+	});
+	if (isCancel(value)) {
+		cancel("Cancelled.");
+		process.exit(0);
+	}
+	return value;
+}
+async function createTemplate(plan, json) {
+	const templateDir = getTemplateDir(plan.template);
+	const task = json ? null : spinner();
+	task?.start("Creating project");
+	if (plan.force && await pathExists(plan.targetDir)) await emptyDir(plan.targetDir);
+	else await ensureDir(plan.targetDir);
+	await copy(templateDir, plan.targetDir, {
+		overwrite: true,
+		errorOnExist: false,
+		filter: (source) => {
+			return !path.relative(templateDir, source).split(path.sep).includes("node_modules");
+		}
+	});
+	await restoreGitignore(plan.targetDir);
+	await assertTemplateCopied(plan);
+	task?.stop("Project created");
+}
+function getTemplateDir(template) {
+	const currentFile = fileURLToPath(import.meta.url);
+	const packageDir = path.resolve(path.dirname(currentFile), "..");
+	return path.join(packageDir, "templates", template);
+}
+async function restoreGitignore(targetDir) {
+	const source = path.join(targetDir, "gitignore");
+	if (!await pathExists(source)) return;
+	await rename(source, path.join(targetDir, ".gitignore"));
+}
+async function assertTemplateCopied(plan) {
+	if (await pathExists(path.join(plan.targetDir, "package.json"))) return;
+	throw new CliError("E_TEMPLATE_COPY_FAILED", `Template copy failed: ${plan.targetDir} is missing package.json`, {
+		template: plan.template,
+		targetDir: plan.targetDir
+	});
+}
+async function assertTargetWritable(targetDir) {
+	if (!await pathExists(targetDir)) return;
+	if (!(await stat(targetDir)).isDirectory()) throw new CliError("E_TARGET_NOT_DIRECTORY", `Target exists and is not a directory: ${targetDir}`);
+}
+async function isNonEmptyDirectory(targetDir) {
+	if (!await pathExists(targetDir)) return false;
+	if (!(await stat(targetDir)).isDirectory()) return false;
+	return (await readdir(targetDir)).length > 0;
+}
+function validateProjectName(projectName) {
+	if (!projectName.trim()) throw new CliError("E_PROJECT_NAME_REQUIRED", "Project name is required.");
+	const result = validatePackageName(path.basename(projectName));
+	if (result.validForNewPackages) return;
+	throw new CliError("E_PROJECT_NAME_INVALID", [...result.errors ?? [], ...result.warnings ?? []][0] ?? `Invalid project name: ${projectName}`);
+}
+function isTemplate(value) {
+	return TEMPLATES.includes(value);
+}
+function formatPathForShell(value) {
+	return value.includes(" ") ? JSON.stringify(value) : value;
+}
+function handleFatalError(error, json) {
+	if (error instanceof CliError) {
+		printError(error, json);
+		process.exit(1);
+	}
+	printError(new CliError("E_UNEXPECTED", error instanceof Error ? error.message : String(error)), json);
+	process.exit(1);
+}
+function printError(error, json) {
+	const payload = {
+		ok: false,
+		error: {
+			code: error.code,
+			message: error.message,
+			...error.details ? { details: error.details } : {}
+		}
+	};
+	if (json) {
+		console.error(JSON.stringify(payload, null, 2));
+		return;
+	}
+	console.error(`${pc.red("Error")} ${error.message}`);
+}
+//#endregion
+export {};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "howone",
+  "version": "0.0.3",
+  "private": false,
+  "description": "HowOne command line tools for creating app templates.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./bin/index.mjs",
+  "types": "./bin/index.d.mts",
+  "bin": {
+    "howone": "./bin/index.mjs"
+  },
+  "files": [
+    "bin",
+    "templates"
+  ],
+  "exports": {
+    ".": "./bin/index.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts --format esm --platform node --out-dir bin --clean --dts",
+    "dev": "bun src/index.ts",
+    "lint": "biome check src templates",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.3.0",
+    "cac": "^7.0.0",
+    "fs-extra": "^11.3.4",
+    "picocolors": "^1.1.1",
+    "validate-npm-package-name": "^7.0.2"
+  },
+  "devDependencies": {
+    "@howone/tsconfig": "workspace:*",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.6.0",
+    "@types/validate-npm-package-name": "^4.0.2",
+    "tsdown": "^0.21.10",
+    "typescript": "^5.7.3"
+  }
+}

package/templates/nextjs/AGENTS.md

@@ -0,0 +1,5 @@
+<!-- BEGIN:nextjs-agent-rules -->
+# This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
+<!-- END:nextjs-agent-rules -->

package/templates/nextjs/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/templates/nextjs/README.md

@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

package/templates/nextjs/app/globals.css

@@ -0,0 +1,49 @@
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+html {
+  height: 100%;
+}
+
+html,
+body {
+  max-width: 100vw;
+  overflow-x: hidden;
+}
+
+body {
+  min-height: 100%;
+  display: flex;
+  flex-direction: column;
+  color: var(--foreground);
+  background: var(--background);
+  font-family: Arial, Helvetica, sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+* {
+  box-sizing: border-box;
+  padding: 0;
+  margin: 0;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+@media (prefers-color-scheme: dark) {
+  html {
+    color-scheme: dark;
+  }
+}

package/templates/nextjs/app/layout.tsx

@@ -0,0 +1,30 @@
+import type { Metadata } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
+
+export const metadata: Metadata = {
+  title: "Create Next App",
+  description: "Generated by create next app",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en" className={`${geistSans.variable} ${geistMono.variable}`}>
+      <body>{children}</body>
+    </html>
+  );
+}

package/templates/nextjs/app/page.module.css

@@ -0,0 +1,142 @@
+.page {
+  --background: #fafafa;
+  --foreground: #fff;
+
+  --text-primary: #000;
+  --text-secondary: #666;
+
+  --button-primary-hover: #383838;
+  --button-secondary-hover: #f2f2f2;
+  --button-secondary-border: #ebebeb;
+
+  display: flex;
+  flex: 1;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  font-family: var(--font-geist-sans);
+  background-color: var(--background);
+}
+
+.main {
+  display: flex;
+  flex: 1;
+  width: 100%;
+  max-width: 800px;
+  flex-direction: column;
+  align-items: flex-start;
+  justify-content: space-between;
+  background-color: var(--foreground);
+  padding: 120px 60px;
+}
+
+.intro {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  text-align: left;
+  gap: 24px;
+}
+
+.intro h1 {
+  max-width: 320px;
+  font-size: 40px;
+  font-weight: 600;
+  line-height: 48px;
+  letter-spacing: -2.4px;
+  text-wrap: balance;
+  color: var(--text-primary);
+}
+
+.intro p {
+  max-width: 440px;
+  font-size: 18px;
+  line-height: 32px;
+  text-wrap: balance;
+  color: var(--text-secondary);
+}
+
+.intro a {
+  font-weight: 500;
+  color: var(--text-primary);
+}
+
+.ctas {
+  display: flex;
+  flex-direction: row;
+  width: 100%;
+  max-width: 440px;
+  gap: 16px;
+  font-size: 14px;
+}
+
+.ctas a {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  height: 40px;
+  padding: 0 16px;
+  border-radius: 128px;
+  border: 1px solid transparent;
+  transition: 0.2s;
+  cursor: pointer;
+  width: fit-content;
+  font-weight: 500;
+}
+
+a.primary {
+  background: var(--text-primary);
+  color: var(--background);
+  gap: 8px;
+}
+
+a.secondary {
+  border-color: var(--button-secondary-border);
+}
+
+/* Enable hover only on non-touch devices */
+@media (hover: hover) and (pointer: fine) {
+  a.primary:hover {
+    background: var(--button-primary-hover);
+    border-color: transparent;
+  }
+
+  a.secondary:hover {
+    background: var(--button-secondary-hover);
+    border-color: transparent;
+  }
+}
+
+@media (max-width: 600px) {
+  .main {
+    padding: 48px 24px;
+  }
+
+  .intro {
+    gap: 16px;
+  }
+
+  .intro h1 {
+    font-size: 32px;
+    line-height: 40px;
+    letter-spacing: -1.92px;
+  }
+}
+
+@media (prefers-color-scheme: dark) {
+  .logo {
+    filter: invert();
+  }
+
+  .page {
+    --background: #000;
+    --foreground: #000;
+
+    --text-primary: #ededed;
+    --text-secondary: #999;
+
+    --button-primary-hover: #ccc;
+    --button-secondary-hover: #1a1a1a;
+    --button-secondary-border: #1a1a1a;
+  }
+}

package/templates/nextjs/app/page.tsx

@@ -0,0 +1,66 @@
+import Image from "next/image";
+import styles from "./page.module.css";
+
+export default function Home() {
+  return (
+    <div className={styles.page}>
+      <main className={styles.main}>
+        <Image
+          className={styles.logo}
+          src="/next.svg"
+          alt="Next.js logo"
+          width={100}
+          height={20}
+          priority
+        />
+        <div className={styles.intro}>
+          <h1>To get started, edit the page.tsx file.</h1>
+          <p>
+            Looking for a starting point or more instructions? Head over to{" "}
+            <a
+              href="https://vercel.com/templates?framework=next.js&utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+              target="_blank"
+              rel="noopener noreferrer"
+            >
+              Templates
+            </a>{" "}
+            or the{" "}
+            <a
+              href="https://nextjs.org/learn?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+              target="_blank"
+              rel="noopener noreferrer"
+            >
+              Learning
+            </a>{" "}
+            center.
+          </p>
+        </div>
+        <div className={styles.ctas}>
+          <a
+            className={styles.primary}
+            href="https://vercel.com/new?utm_source=create-next-app&utm_medium=appdir-template&utm_campaign=create-next-app"
+            target="_blank"
+            rel="noopener noreferrer"
+          >
+            <Image
+              className={styles.logo}
+              src="/vercel.svg"
+              alt="Vercel logomark"
+              width={16}
+              height={16}
+            />
+            Deploy Now
+          </a>
+          <a
+            className={styles.secondary}
+            href="https://nextjs.org/docs?utm_source=create-next-app&utm_medium=appdir-template&utm_campaign=create-next-app"
+            target="_blank"
+            rel="noopener noreferrer"
+          >
+            Documentation
+          </a>
+        </div>
+      </main>
+    </div>
+  );
+}