@wolfstar/create-http-framework 2.0.1 → 2.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2022 Wolfstar Project
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,69 @@
+# `@wolfstar/create-http-framework`
+
+A CLI scaffolding tool for creating new [WolfStar HTTP Framework](https://github.com/wolfstar-project/stars-components/tree/main/packages/http-framework) bot projects.
+
+## Usage
+
+```bash
+npm create @wolfstar/http-framework@latest my-discord-bot
+# or
+pnpm create @wolfstar/http-framework my-discord-bot
+# or
+yarn create @wolfstar/http-framework my-discord-bot
+# or
+bun create @wolfstar/http-framework my-discord-bot
+```
+
+The CLI will guide you through the following prompts:
+
+- **Project name** — an npm-compatible name for your bot
+- **Package manager** — npm, yarn, pnpm, or bun
+- **Language** — TypeScript or JavaScript
+- **Build tool** — tsdown, TypeScript 6, or the TypeScript 7 release candidate
+- **Linter and formatter** — Oxlint / ESLint and Oxfmt / Prettier
+- **Port** — the port the HTTP server will listen on (default: `3000`)
+- **i18n support** — optionally add `@wolfstar/http-framework-i18n`
+- **Auto-install** — install dependencies immediately after scaffolding
+
+## Options
+
+| Flag                         | Alias | Description                                                 |
+| ---------------------------- | ----- | ----------------------------------------------------------- |
+| `--overwrite`                |       | Overwrite the target directory if it already exists         |
+| `--no-interactive`           |       | Skip all prompts and use defaults / flags                   |
+| `--interactive`              | `-i`  | Force interactive prompts even when an AI agent is detected |
+| `--package-manager <pm>`     |       | Choose npm, yarn, pnpm, or bun                              |
+| `--language <lang>`          |       | Choose TypeScript (`ts`) or JavaScript (`js`)               |
+| `--build <tool>`             |       | Choose `tsc6`, `tsc7`, or `tsdown` for TypeScript           |
+| `--lint <linter>`            |       | Choose `none`, `eslint`, or `oxlint`                        |
+| `--format <formatter>`       |       | Choose `none`, `prettier`, or `oxfmt`                       |
+| `--port <number>`            |       | Set the HTTP port (default: `3000`)                         |
+| `--i18n` / `--no-i18n`       |       | Enable or disable i18n support                              |
+| `--install` / `--no-install` |       | Enable or disable dependency installation                   |
+| `--help`                     | `-h`  | Print usage and exit                                        |
+
+## Non-interactive / AI agent mode
+
+When the CLI detects an AI agent is running it (via [`@vercel/detect-agent`](https://www.npmjs.com/package/@vercel/detect-agent)), it automatically enters non-interactive mode, equivalent to passing `--no-interactive`. A project name argument is required in this mode:
+
+```bash
+create-http-framework my-discord-bot --no-interactive
+```
+
+## Generated project structure
+
+```
+my-discord-bot/
+├── src/
+│   ├── commands/
+│   │   └── ping.ts     # Example ping command
+│   └── index.ts        # Entry point — starts the HTTP server
+├── .env                # Environment variables (DISCORD_TOKEN, DISCORD_PUBLIC_KEY)
+├── .gitignore
+├── package.json
+└── tsconfig.json
+```
+
+## Requirements
+
+- Node.js `>=20`

package/dist/index.js

@@ -4,7 +4,7 @@ import { determineAgent } from "@vercel/detect-agent";
 import mri from "mri";
 import { dirname, join, relative, resolve } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
-import { execFileSync } from "node:child_process";
+import spawn from "cross-spawn";
 import { resolveCommand } from "package-manager-detector/commands";
 import { detect } from "package-manager-detector/detect";
 import Handlebars from "handlebars";
@@ -33,6 +33,37 @@ function writeFile(filePath, content) {
 	writeFileSync(filePath, content, "utf-8");
 }
 
+//#endregion
+//#region src/tools/options.ts
+const PACKAGE_MANAGERS = [
+	"npm",
+	"yarn",
+	"pnpm",
+	"bun"
+];
+const LANGUAGES = ["ts", "js"];
+const BUILD_TOOLS = [
+	"tsc6",
+	"tsc7",
+	"tsdown"
+];
+const LINTERS = [
+	"none",
+	"eslint",
+	"oxlint"
+];
+const FORMATTERS = [
+	"none",
+	"prettier",
+	"oxfmt"
+];
+/**
+* TypeScript 7.0 (the native compiler) ships under the main `typescript` package on the `rc`
+* dist-tag. We pin it exactly because it is a prerelease (the old separate `@typescript/native-preview`
+* package only has dev builds).
+*/
+const TYPESCRIPT_RC_VERSION = "7.0.1-rc";
+
 //#endregion
 //#region src/tools/npmHelpers.ts
 async function fetchVersion(packageName) {
@@ -40,25 +71,47 @@ async function fetchVersion(packageName) {
 	if (!response.ok) throw new Error(`Failed to resolve latest version for ${packageName}: ${response.status} ${response.statusText}`);
 	return (await response.json()).version;
 }
-async function fetchDependencyVersions() {
-	const [httpFramework, httpFrameworkI18n, discordApiTypes, typescript, tsNode, typesNode, discordJsBuilders] = await Promise.all([
-		fetchVersion("@wolfstar/http-framework"),
-		fetchVersion("@wolfstar/http-framework-i18n"),
-		fetchVersion("discord-api-types"),
-		fetchVersion("typescript"),
-		fetchVersion("ts-node"),
-		fetchVersion("@types/node"),
-		fetchVersion("@discordjs/builders")
+/**
+* Resolves the latest versions of only the packages required by the chosen selections.
+* `ts-node` is intentionally never included. TypeScript 7.0 (tsc7) is pinned to the rc instead
+* of being fetched, because `typescript@latest` resolves to the 6.x line.
+*/
+async function fetchDependencyVersions(selections) {
+	const names = /* @__PURE__ */ new Set([
+		"@wolfstar/http-framework",
+		"discord-api-types",
+		"@discordjs/builders"
 	]);
-	return {
-		httpFramework,
-		httpFrameworkI18n,
-		discordApiTypes,
-		typescript,
-		tsNode,
-		typesNode,
-		discordJsBuilders
-	};
+	if (selections.i18n) names.add("@wolfstar/http-framework-i18n");
+	if (selections.language === "ts") {
+		names.add("@types/node");
+		switch (selections.buildTool) {
+			case "tsc6":
+				names.add("typescript").add("tsc-watch");
+				break;
+			case "tsc7":
+				names.add("tsc-watch");
+				break;
+			case "tsdown":
+				names.add("tsdown").add("typescript");
+				break;
+		}
+	}
+	if (selections.linter === "eslint") {
+		names.add("eslint");
+		names.add(selections.language === "ts" ? "typescript-eslint" : "@eslint/js");
+	}
+	if (selections.linter === "oxlint") names.add("oxlint");
+	if (selections.formatter === "prettier") names.add("prettier");
+	if (selections.formatter === "oxfmt") names.add("oxfmt");
+	const list = [...names];
+	const resolved = await Promise.all(list.map(fetchVersion));
+	const versions = {};
+	list.forEach((name, index) => {
+		versions[name] = resolved[index];
+	});
+	if (selections.language === "ts" && selections.buildTool === "tsc7") versions["typescript"] = TYPESCRIPT_RC_VERSION;
+	return versions;
 }
 
 //#endregion
@@ -79,21 +132,274 @@ async function detectPackageManager() {
 	}
 	return "npm";
 }
+function quoteToken(token) {
+	return /\s/.test(token) ? `"${token}"` : token;
+}
+/**
+* Builds the correct "run a script" command string for the given package manager, e.g.
+* `npm run build` / `pnpm run build`. Extra args are forwarded the way each manager expects
+* (npm inserts the `--` separator automatically), and tokens containing spaces are quoted so
+* nested commands (`--onSuccess "pnpm run start"`) survive being placed in a package.json script.
+*/
+function getRunScript(pm, script, args = []) {
+	const resolved = resolveCommand(pm, "run", [script, ...args]);
+	if (!resolved) throw new Error(`Could not resolve run command for ${pm}`);
+	return [resolved.command, ...resolved.args].map(quoteToken).join(" ");
+}
+/** Returns the install command string for the given package manager, e.g. `pnpm install`. */
+function getInstallScript(pm) {
+	const resolved = resolveCommand(pm, "install", []);
+	if (!resolved) throw new Error(`Could not resolve install command for ${pm}`);
+	return [resolved.command, ...resolved.args].map(quoteToken).join(" ");
+}
 async function installDependencies(pm, dir) {
 	const agent = (await detect({ cwd: process.cwd() }))?.agent ?? pm;
 	const resolved = resolveCommand(agent, "install", []);
 	if (!resolved) throw new Error(`Could not resolve install command for ${agent}`);
-	execFileSync(resolved.command, resolved.args, {
+	const result = spawn.sync(resolved.command, resolved.args, {
+		cwd: dir,
+		stdio: process.env["DEBUG"] ? "inherit" : "pipe"
+	});
+	if (result.error) throw result.error;
+	if (result.status !== 0) throw new Error(`Dependency installation failed with exit code ${result.status ?? "unknown"}`);
+}
+/** Runs an arbitrary command in `dir` via cross-spawn (used for the post-scaffold formatter pass). */
+function runCommand(command, args, dir) {
+	const result = spawn.sync(command, args, {
 		cwd: dir,
 		stdio: process.env["DEBUG"] ? "inherit" : "pipe"
 	});
+	if (result.error) throw result.error;
+	if (result.status !== 0) throw new Error(`Command "${command}" failed with exit code ${result.status ?? "unknown"}`);
+}
+
+//#endregion
+//#region src/tools/projectFiles.ts
+const caret = (version) => `^${version}`;
+function sortKeys(record) {
+	return Object.fromEntries(Object.entries(record).sort(([a], [b]) => a.localeCompare(b)));
+}
+function json(value) {
+	return `${JSON.stringify(value, null, "	")}\n`;
+}
+function buildScripts(ctx) {
+	const { packageManager: pm, buildTool } = ctx;
+	const start = "node dist/index.js";
+	let scripts;
+	if (ctx.language === "js") scripts = {
+		start: "node src/index.js",
+		dev: "node --watch src/index.js"
+	};
+	else if (buildTool === "tsdown") scripts = {
+		build: "tsdown",
+		dev: getRunScript(pm, "build", ["--onSuccess", getRunScript(pm, "start")]),
+		watch: getRunScript(pm, "build", ["--watch"]),
+		"watch:start": getRunScript(pm, "build", [
+			"--watch",
+			"--onSuccess",
+			getRunScript(pm, "start")
+		]),
+		start
+	};
+	else scripts = {
+		build: "tsc -b src",
+		dev: `${getRunScript(pm, "build")} && ${getRunScript(pm, "start")}`,
+		watch: "tsc -b src -w",
+		"watch:start": `tsc-watch -b src --onSuccess "${getRunScript(pm, "start")}"`,
+		start
+	};
+	if (ctx.linter === "oxlint") {
+		scripts["lint"] = "oxlint src";
+		scripts["lint:fix"] = "oxlint --fix src";
+	} else if (ctx.linter === "eslint") {
+		scripts["lint"] = "eslint src";
+		scripts["lint:fix"] = "eslint src --fix";
+	}
+	if (ctx.formatter === "oxfmt") {
+		scripts["format"] = "oxfmt --write src";
+		scripts["format:check"] = "oxfmt --check src";
+	} else if (ctx.formatter === "prettier") {
+		scripts["format"] = "prettier --write src";
+		scripts["format:check"] = "prettier --check src";
+	}
+	return scripts;
+}
+function buildDependencies(ctx) {
+	const v = ctx.versions;
+	const dependencies = {
+		"@discordjs/builders": caret(v["@discordjs/builders"]),
+		"@wolfstar/http-framework": caret(v["@wolfstar/http-framework"]),
+		"discord-api-types": caret(v["discord-api-types"])
+	};
+	if (ctx.i18n) dependencies["@wolfstar/http-framework-i18n"] = caret(v["@wolfstar/http-framework-i18n"]);
+	return sortKeys(dependencies);
+}
+function buildDevDependencies(ctx) {
+	const v = ctx.versions;
+	const dev = {};
+	if (ctx.language === "ts") {
+		dev["@types/node"] = caret(v["@types/node"]);
+		switch (ctx.buildTool) {
+			case "tsc6":
+				dev["typescript"] = caret(v["typescript"]);
+				dev["tsc-watch"] = caret(v["tsc-watch"]);
+				break;
+			case "tsc7":
+				dev["typescript"] = v["typescript"];
+				dev["tsc-watch"] = caret(v["tsc-watch"]);
+				break;
+			case "tsdown":
+				dev["tsdown"] = caret(v["tsdown"]);
+				dev["typescript"] = caret(v["typescript"]);
+				break;
+		}
+	}
+	if (ctx.linter === "eslint") {
+		dev["eslint"] = caret(v["eslint"]);
+		if (ctx.language === "ts") dev["typescript-eslint"] = caret(v["typescript-eslint"]);
+		else dev["@eslint/js"] = caret(v["@eslint/js"]);
+	} else if (ctx.linter === "oxlint") dev["oxlint"] = caret(v["oxlint"]);
+	if (ctx.formatter === "prettier") dev["prettier"] = caret(v["prettier"]);
+	else if (ctx.formatter === "oxfmt") dev["oxfmt"] = caret(v["oxfmt"]);
+	return sortKeys(dev);
+}
+function packageJson(ctx) {
+	const devDependencies = buildDevDependencies(ctx);
+	return json({
+		name: ctx.name,
+		version: "1.0.0",
+		description: "A Discord HTTP bot built with `@wolfstar/http-framework`",
+		type: "module",
+		scripts: buildScripts(ctx),
+		dependencies: buildDependencies(ctx),
+		...Object.keys(devDependencies).length > 0 ? { devDependencies } : {},
+		engines: { node: ">=20" }
+	});
+}
+const sharedCompilerOptions = {
+	target: "ES2022",
+	module: "Node16",
+	moduleResolution: "Node16",
+	strict: true,
+	esModuleInterop: true,
+	skipLibCheck: true,
+	declaration: true,
+	declarationMap: true,
+	sourceMap: true,
+	experimentalDecorators: true,
+	emitDecoratorMetadata: true
+};
+/** Writes the tsconfig(s). The tsc branches use a composite build so `tsc -b src` resolves `src/tsconfig.json`. */
+function writeTsconfig(targetDir, ctx) {
+	if (ctx.language === "js") return;
+	if (ctx.buildTool === "tsdown") {
+		writeFile(join(targetDir, "tsconfig.json"), json({
+			compilerOptions: {
+				...sharedCompilerOptions,
+				outDir: "./dist",
+				rootDir: "./src"
+			},
+			include: ["src/**/*.ts"],
+			exclude: ["node_modules", "dist"]
+		}));
+		return;
+	}
+	writeFile(join(targetDir, "tsconfig.json"), json({
+		files: [],
+		references: [{ path: "./src" }]
+	}));
+	writeFile(join(targetDir, "src", "tsconfig.json"), json({
+		compilerOptions: {
+			...sharedCompilerOptions,
+			rootDir: ".",
+			outDir: "../dist",
+			composite: true,
+			tsBuildInfoFile: "../dist/tsconfig.tsbuildinfo"
+		},
+		include: ["**/*.ts"]
+	}));
+}
+function writeBuildConfig(targetDir, ctx) {
+	if (ctx.language === "js" || ctx.buildTool !== "tsdown") return;
+	const content = [
+		"import { defineConfig } from 'tsdown';",
+		"",
+		"export default defineConfig({",
+		"	entry: ['src/**/*.ts'],",
+		"	format: ['esm'],",
+		"	target: 'node20',",
+		"	// Mirror the src/ structure so the framework can load command pieces from dist/commands at runtime.",
+		"	unbundle: true,",
+		"	// Emit dist/index.js so the shared `start` script (node dist/index.js) works.",
+		"	outExtensions: () => ({ js: '.js' }),",
+		"	clean: true,",
+		"	sourcemap: true",
+		"});",
+		""
+	].join("\n");
+	writeFile(join(targetDir, "tsdown.config.ts"), content);
+}
+function writeLinterConfig(targetDir, ctx) {
+	if (ctx.linter === "oxlint") writeFile(join(targetDir, ".oxlintrc.json"), json({
+		$schema: "./node_modules/oxlint/configuration_schema.json",
+		...ctx.language === "ts" ? { plugins: ["typescript"] } : {},
+		categories: {
+			correctness: "error",
+			suspicious: "warn"
+		},
+		ignorePatterns: ["dist/**", "node_modules/**"]
+	}));
+	else if (ctx.linter === "eslint") {
+		const content = ctx.language === "ts" ? [
+			"import tseslint from 'typescript-eslint';",
+			"",
+			"export default tseslint.config(",
+			"	{ ignores: ['dist/**'] },",
+			"	...tseslint.configs.recommended",
+			");",
+			""
+		].join("\n") : [
+			"import js from '@eslint/js';",
+			"",
+			"export default [",
+			"	{ ignores: ['dist/**'] },",
+			"	js.configs.recommended",
+			"];",
+			""
+		].join("\n");
+		writeFile(join(targetDir, "eslint.config.mjs"), content);
+	}
+}
+function writeFormatterConfig(targetDir, ctx) {
+	if (ctx.formatter === "oxfmt") writeFile(join(targetDir, ".oxfmtrc.json"), json({
+		$schema: "./node_modules/oxfmt/configuration_schema.json",
+		useTabs: true,
+		tabWidth: 4,
+		printWidth: 150,
+		singleQuote: true,
+		trailingComma: "none",
+		semi: true,
+		endOfLine: "lf"
+	}));
+	else if (ctx.formatter === "prettier") writeFile(join(targetDir, ".prettierrc.json"), json({
+		useTabs: true,
+		tabWidth: 4,
+		printWidth: 150,
+		singleQuote: true,
+		trailingComma: "none"
+	}));
+}
+/** Generates every config-style file in code so the output is always valid, formatted JSON/TS. */
+function writeProjectFiles(targetDir, ctx) {
+	writeFile(join(targetDir, "package.json"), packageJson(ctx));
+	writeTsconfig(targetDir, ctx);
+	writeBuildConfig(targetDir, ctx);
+	writeLinterConfig(targetDir, ctx);
+	writeFormatterConfig(targetDir, ctx);
 }
 
 //#endregion
 //#region src/tools/templateProcessor.ts
-Handlebars.registerHelper("eq", (a, b) => a === b);
-Handlebars.registerHelper("or", (...args) => args.slice(0, -1).some(Boolean));
-Handlebars.registerHelper("and", (...args) => args.slice(0, -1).every(Boolean));
 const templateDir = join(fileURLToPath(import.meta.url), "../..", "template");
 function walkDir(dir) {
 	const entries = readdirSync(dir);
@@ -109,6 +415,8 @@ function processTemplate(outputDir, context) {
 	const allFiles = walkDir(templateDir);
 	for (const absoluteSource of allFiles) {
 		const relativePath = relative(templateDir, absoluteSource);
+		if (context.language === "js" && relativePath.endsWith(".ts.hbs")) continue;
+		if (context.language === "ts" && relativePath.endsWith(".js.hbs")) continue;
 		const rawContent = readFileSync(absoluteSource, "utf-8");
 		const isHandlebars = relativePath.endsWith(".hbs");
 		writeFile(join(outputDir, isHandlebars ? relativePath.slice(0, -4) : relativePath), isHandlebars ? Handlebars.compile(rawContent)(context) : rawContent);
@@ -128,27 +436,46 @@ function printHelp() {
 Usage: create-http-framework [project-name] [options]
 
 Options:
-  --overwrite        Overwrite target directory if it already exists
-  --yes, -y          Skip prompts and use defaults (port 3000, no i18n, auto-install)
-  --interactive, -i  Force interactive prompts even when an AI agent is detected
-  --help, -h         Print this message and exit
+  --overwrite                  Overwrite target directory if it already exists
+  --no-interactive             Skip all prompts and use defaults / flags
+  --interactive, -i            Force interactive prompts even when an AI agent is detected
+  --package-manager <pm>       npm | yarn | pnpm | bun (defaults to the detected one)
+  --language <lang>            ts | js (default: ts)
+  --build <tool>               tsc6 | tsc7 | tsdown — TypeScript only (default: tsdown)
+  --lint <linter>              none | eslint | oxlint (default: oxlint)
+  --format <formatter>         none | prettier | oxfmt (default: oxfmt)
+  --port <number>              HTTP port (default: 3000)
+  --i18n / --no-i18n           Toggle @wolfstar/http-framework-i18n (default: off)
+  --install / --no-install     Toggle dependency installation (default: on)
+  --help, -h                   Print this message and exit
 
 `);
 	process.exit(0);
 }
+function parseEnum(value, allowed, label) {
+	if (value === void 0) return void 0;
+	if (!allowed.includes(value)) {
+		cancel(`Invalid ${label} "${value}". Expected one of: ${allowed.join(", ")}.`);
+		process.exit(1);
+	}
+	return value;
+}
 async function main() {
 	const argv = mri(process.argv.slice(2), {
-		boolean: [
-			"overwrite",
-			"yes",
-			"help",
-			"interactive"
+		boolean: ["overwrite", "help"],
+		string: [
+			"package-manager",
+			"language",
+			"build",
+			"lint",
+			"format",
+			"port"
 		],
 		alias: {
-			y: "yes",
 			h: "help",
 			i: "interactive"
-		}
+		},
+		default: { install: true }
 	});
 	if (argv["help"]) {
 		printHelp();
@@ -156,16 +483,23 @@ async function main() {
 	}
 	const argProjectName = argv._[0];
 	const flagOverwrite = argv["overwrite"];
-	const flagYes = argv["yes"];
 	const flagInteractive = argv["interactive"];
+	const cliPackageManager = parseEnum(argv["package-manager"], PACKAGE_MANAGERS, "--package-manager");
+	const cliLanguage = parseEnum(argv["language"], LANGUAGES, "--language");
+	const cliBuild = parseEnum(argv["build"], BUILD_TOOLS, "--build");
+	const cliLint = parseEnum(argv["lint"], LINTERS, "--lint");
+	const cliFormat = parseEnum(argv["format"], FORMATTERS, "--format");
+	const cliPort = argv["port"];
+	const cliI18n = argv["i18n"];
+	const cliInstall = argv["install"];
 	const { isAgent, agent } = await determineAgent();
-	const agentMode = isAgent && !flagInteractive;
-	const effectiveYes = flagYes || agentMode;
+	const agentMode = isAgent && flagInteractive !== true;
+	const nonInteractive = flagInteractive === false || agentMode;
 	intro("Welcome to the WolfStar HTTP Framework!");
-	if (agentMode && !flagYes) log.info(`AI agent detected (${agent.name}) — running in non-interactive mode`);
-	const packageManager = await detectPackageManager();
+	if (agentMode && flagInteractive !== false) log.info(`AI agent detected (${agent.name}) — running in non-interactive mode`);
+	const detectedPackageManager = await detectPackageManager();
 	let projectName;
-	if (effectiveYes) {
+	if (nonInteractive) {
 		if (!argProjectName) {
 			cancel("A project name argument is required in non-interactive mode.");
 			process.exit(1);
@@ -193,9 +527,26 @@ async function main() {
 		}
 		projectName = nameResult;
 	}
+	let packageManager;
+	if (nonInteractive) packageManager = cliPackageManager ?? detectedPackageManager;
+	else {
+		const pmResult = await select({
+			message: "Which package manager would you like to use?",
+			options: PACKAGE_MANAGERS.map((pm) => ({
+				value: pm,
+				label: pm
+			})),
+			initialValue: PACKAGE_MANAGERS.includes(detectedPackageManager) ? detectedPackageManager : "npm"
+		});
+		if (isCancel(pmResult)) {
+			cancel("Operation cancelled.");
+			process.exit(0);
+		}
+		packageManager = pmResult;
+	}
 	const targetDir = resolve(projectName);
 	if (directoryExists(targetDir) && !isEmpty(targetDir)) if (flagOverwrite) emptyDir(targetDir);
-	else if (effectiveYes) {
+	else if (nonInteractive) {
 		cancel(`"${projectName}" already exists. Use --overwrite to overwrite it.`);
 		process.exit(1);
 	} else {
@@ -216,8 +567,13 @@ async function main() {
 		emptyDir(targetDir);
 	}
 	let port;
-	if (effectiveYes) port = 3e3;
-	else {
+	if (nonInteractive) {
+		port = cliPort === void 0 ? 3e3 : Number(cliPort);
+		if (!Number.isInteger(port) || port < 1 || port > 65535) {
+			cancel("Provide a valid --port between 1 and 65535.");
+			process.exit(1);
+		}
+	} else {
 		const portResult = await text({
 			message: "Which port should the HTTP server listen on?",
 			placeholder: "3000",
@@ -233,8 +589,110 @@ async function main() {
 		}
 		port = Number(portResult);
 	}
+	let language;
+	if (nonInteractive) language = cliLanguage ?? "ts";
+	else {
+		const languageResult = await select({
+			message: "Which language would you like to use?",
+			options: [{
+				value: "ts",
+				label: "TypeScript"
+			}, {
+				value: "js",
+				label: "JavaScript"
+			}],
+			initialValue: "ts"
+		});
+		if (isCancel(languageResult)) {
+			cancel("Operation cancelled.");
+			process.exit(0);
+		}
+		language = languageResult;
+	}
+	let buildTool = "tsdown";
+	if (cliBuild !== void 0 && language === "js") log.warn("--build only applies to TypeScript projects and will be ignored.");
+	if (language === "ts") if (nonInteractive) buildTool = cliBuild ?? "tsdown";
+	else {
+		const buildResult = await select({
+			message: "Which build tool would you like to use?",
+			options: [
+				{
+					value: "tsdown",
+					label: "tsdown (bundler)"
+				},
+				{
+					value: "tsc6",
+					label: "TypeScript 6.0 (tsc)"
+				},
+				{
+					value: "tsc7",
+					label: "TypeScript 7.0 rc (tsc)"
+				}
+			],
+			initialValue: "tsdown"
+		});
+		if (isCancel(buildResult)) {
+			cancel("Operation cancelled.");
+			process.exit(0);
+		}
+		buildTool = buildResult;
+	}
+	let linter;
+	if (nonInteractive) linter = cliLint ?? "oxlint";
+	else {
+		const lintResult = await select({
+			message: "Which linter would you like to use?",
+			options: [
+				{
+					value: "oxlint",
+					label: "oxlint"
+				},
+				{
+					value: "eslint",
+					label: "ESLint"
+				},
+				{
+					value: "none",
+					label: "None"
+				}
+			],
+			initialValue: "oxlint"
+		});
+		if (isCancel(lintResult)) {
+			cancel("Operation cancelled.");
+			process.exit(0);
+		}
+		linter = lintResult;
+	}
+	let formatter;
+	if (nonInteractive) formatter = cliFormat ?? "oxfmt";
+	else {
+		const formatResult = await select({
+			message: "Which formatter would you like to use?",
+			options: [
+				{
+					value: "oxfmt",
+					label: "oxfmt"
+				},
+				{
+					value: "prettier",
+					label: "Prettier"
+				},
+				{
+					value: "none",
+					label: "None"
+				}
+			],
+			initialValue: "oxfmt"
+		});
+		if (isCancel(formatResult)) {
+			cancel("Operation cancelled.");
+			process.exit(0);
+		}
+		formatter = formatResult;
+	}
 	let wantsI18n;
-	if (effectiveYes) wantsI18n = false;
+	if (nonInteractive) wantsI18n = cliI18n ?? false;
 	else {
 		const i18nResult = await confirm({
 			message: "Would you like to add i18n support? (@wolfstar/http-framework-i18n)",
@@ -247,7 +705,7 @@ async function main() {
 		wantsI18n = Boolean(i18nResult);
 	}
 	let wantsInstall;
-	if (effectiveYes) wantsInstall = true;
+	if (nonInteractive) wantsInstall = cliInstall;
 	else {
 		const installResult = await confirm({
 			message: `Would you like to automatically install dependencies with ${packageManager}?`,
@@ -261,24 +719,58 @@ async function main() {
 	}
 	const s = spinner();
 	s.start("Fetching latest dependency versions...");
-	const versions = await fetchDependencyVersions();
+	const versions = await fetchDependencyVersions({
+		i18n: wantsI18n,
+		language,
+		buildTool,
+		linter,
+		formatter
+	});
 	s.stop("Versions fetched.");
 	s.start("Generating project files...");
 	processTemplate(targetDir, {
+		name: projectName,
+		port,
+		language
+	});
+	writeProjectFiles(targetDir, {
 		name: projectName,
 		port,
 		i18n: wantsI18n,
 		packageManager,
-		todaysDate: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+		language,
+		buildTool,
+		linter,
+		formatter,
 		versions
 	});
 	s.stop("Project files generated.");
+	if (formatter !== "none") try {
+		s.start("Formatting project files...");
+		if (formatter === "oxfmt") runCommand("npx", [
+			"--yes",
+			"oxfmt",
+			"--write",
+			"."
+		], targetDir);
+		else runCommand("npx", [
+			"--yes",
+			"prettier",
+			"--write",
+			".",
+			"--log-level",
+			"warn"
+		], targetDir);
+		s.stop("Project files formatted.");
+	} catch {
+		s.stop("Skipped formatting (formatter not available yet — it will run after install).");
+	}
 	if (wantsInstall) {
 		s.start(`Installing dependencies with ${packageManager}...`);
 		await installDependencies(packageManager, targetDir);
 		s.stop("Dependencies installed.");
 	}
-	outro(`Done! To get started:\n\n  cd ${projectName}\n${wantsInstall ? "" : `  ${packageManager} install\n`}  ${packageManager} run dev`);
+	outro(`Done! To get started:\n\n  cd ${projectName}\n${wantsInstall ? "" : `  ${getInstallScript(packageManager)}\n`}  ${getRunScript(packageManager, "dev")}`);
 }
 main().catch((error) => {
 	cancel(error instanceof Error ? error.message : String(error));

package/package.json

@@ -1,58 +1,59 @@
 {
-	"name": "@wolfstar/create-http-framework",
-	"version": "2.0.1",
-	"description": "Create a new WolfStar HTTP Framework bot project",
-	"keywords": [
-		"cli",
-		"create",
-		"discord",
-		"http",
-		"scaffold",
-		"wolfstar"
-	],
-	"homepage": "https://github.com/wolfstar-project/stars-components/tree/main/packages/create-http-framework",
-	"bugs": {
-		"url": "https://github.com/wolfstar-project/stars-components/issues"
-	},
-	"license": "Apache-2.0",
-	"author": "@wolfstar",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/wolfstar-project/stars-components.git",
-		"directory": "packages/create-http-framework"
-	},
-	"bin": {
-		"create-http-framework": "./dist/index.js"
-	},
-	"files": [
-		"dist/",
-		"template/"
-	],
-	"type": "module",
-	"publishConfig": {
-		"access": "public"
-	},
-	"scripts": {
-		"build": "tsdown --config-loader unrun",
-		"typecheck": "tsc -p ../../tsconfig.json",
-		"lint": "oxlint src --fix",
-		"prepack": "pnpm run build"
-	},
-	"dependencies": {
-		"@clack/prompts": "^1.6.0",
-		"@vercel/detect-agent": "^1.2.3",
-		"handlebars": "^4.7.9",
-		"mri": "^1.2.0",
-		"package-manager-detector": "^1.6.0"
-	},
-	"devDependencies": {
-		"@types/handlebars": "^4.1.0",
-		"@types/mri": "^1.2.0",
-		"@types/node": "22.15.21",
-		"tsdown": "^0.22.3",
-		"typescript": "~5.8.3"
-	},
-	"engines": {
-		"node": ">=20"
-	}
-}
+  "name": "@wolfstar/create-http-framework",
+  "version": "2.1.0",
+  "description": "Create a new WolfStar HTTP Framework bot project",
+  "keywords": [
+    "cli",
+    "create",
+    "discord",
+    "http",
+    "scaffold",
+    "wolfstar"
+  ],
+  "homepage": "https://github.com/wolfstar-project/stars-components/tree/main/packages/create-http-framework",
+  "bugs": {
+    "url": "https://github.com/wolfstar-project/stars-components/issues"
+  },
+  "license": "Apache-2.0",
+  "author": "@wolfstar",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wolfstar-project/stars-components.git",
+    "directory": "packages/create-http-framework"
+  },
+  "bin": {
+    "create-http-framework": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "template/"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.7.0",
+    "@vercel/detect-agent": "^1.2.3",
+    "cross-spawn": "^7.0.6",
+    "handlebars": "^4.7.9",
+    "mri": "^1.2.0",
+    "package-manager-detector": "^1.7.0"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
+    "@types/handlebars": "^4.1.0",
+    "@types/mri": "^1.2.0",
+    "@types/node": "22.15.21",
+    "tsdown": "^0.22.3",
+    "typescript": "~5.8.3"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsdown --config-loader unrun",
+    "typecheck": "tsc -p ../../tsconfig.json",
+    "lint": "oxlint src --fix"
+  }
+}

package/template/.env.hbs

@@ -1 +1,4 @@
-DISCORD_TOKEN=your_bot_token_here DISCORD_PUBLIC_KEY=your_public_key_here DISCORD_CLIENT_ID=your_client_id_here HTTP_POST_PATH=/
+DISCORD_TOKEN=your_bot_token_here
+DISCORD_PUBLIC_KEY=your_public_key_here
+DISCORD_CLIENT_ID=your_client_id_here
+HTTP_POST_PATH=/

package/template/.gitignore.hbs

@@ -1 +1,4 @@
-node_modules/ dist/ .env *.js.map
+node_modules/
+dist/
+.env
+*.js.map

package/template/src/commands/ping.js.hbs

@@ -0,0 +1,12 @@
+import { Command } from '@wolfstar/http-framework';
+import { MessageFlags } from 'discord-api-types/v10';
+
+export class PingCommand extends Command {
+	chatInputRun(interaction) {
+		return interaction.reply({ content: 'Pong!', flags: MessageFlags.Ephemeral });
+	}
+
+	static builder = (builder) => builder
+		.setName('ping')
+		.setDescription('Replies with pong!')
+}

package/template/src/commands/ping.ts.hbs

@@ -1,5 +1,13 @@
-import { Command } from '@wolfstar/http-framework'; import { SlashCommandBuilder } from '@discordjs/builders'; import { MessageFlags } from
-'discord-api-types/v10'; export class PingCommand extends Command { public constructor(context: Command.LoaderContext) { super(context, { name:
-'ping', description: 'Replies with pong!' }); } public override chatInputRun(interaction: Command.ChatInputInteraction) { return interaction.reply({
-content: 'Pong!', flags: MessageFlags.Ephemeral }); } public static readonly builder = new SlashCommandBuilder() .setName('ping')
-.setDescription('Replies with pong!'); }
+import { Command, RegisterCommand } from '@wolfstar/http-framework';
+import { MessageFlags } from 'discord-api-types/v10';
+
+@RegisterCommand((builder) =>
+	builder //
+		.setName('ping')
+		.setDescription('Replies with pong!')
+)
+export class PingCommand extends Command {
+	public override chatInputRun(interaction: Command.ChatInputInteraction) {
+		return interaction.reply({ content: 'Pong!', flags: MessageFlags.Ephemeral });
+	}
+}

package/template/src/index.js.hbs

@@ -0,0 +1,10 @@
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Client } from '@wolfstar/http-framework';
+
+const client = new Client();
+
+await client.load({ baseUserDirectory: join(dirname(fileURLToPath(import.meta.url)), 'commands') });
+await client.listen({ port: {{port}} });
+
+console.log('Bot is running on port {{port}}');

package/template/src/index.ts.hbs

@@ -1,5 +1,10 @@
-import { dirname, join } from 'node:path'; import { fileURLToPath } from 'node:url'; import { Client } from '@wolfstar/http-framework'; const client =
-new Client(); await client.load({ baseUserDirectory: join(dirname(fileURLToPath(import.meta.url)), 'commands') }); await client.listen({ port:
-{{port}}
-}); console.log('Bot is running on port
-{{port}}');
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Client } from '@wolfstar/http-framework';
+
+const client = new Client();
+
+await client.load({ baseUserDirectory: join(dirname(fileURLToPath(import.meta.url)), 'commands') });
+await client.listen({ port: {{port}} });
+
+console.log('Bot is running on port {{port}}');

package/template/package.json.hbs

@@ -1,7 +0,0 @@
-{ "name": "{{name}}", "version": "1.0.0", "description": "A Discord HTTP bot built with `@wolfstar/http-framework`", "author": "`@wolfstar`",
-"repository": { "url": "https://github.com/yourusername/your-repo.git" }, "bugs": { "url": "https://github.com/yourusername/your-repo/issues" },
-"homepage": "https://github.com/yourusername/your-repo#readme", "keywords": ["discord", "bot", "http", "wolfstar"], "type": "module", "scripts": {
-"build": "tsc", "dev": "node --watch --loader ts-node/esm src/index.ts", "start": "node dist/index.js" }, "dependencies": { "@discordjs/builders": "^{{versions.discordJsBuilders}}",
-"@wolfstar/http-framework": "^{{versions.httpFramework}}"{{#if i18n}}, "@wolfstar/http-framework-i18n": "^{{versions.httpFrameworkI18n}}"{{/if}},
-"discord-api-types": "^{{versions.discordApiTypes}}" }, "devDependencies": { "@types/node": "^{{versions.typesNode}}", "ts-node": "^{{versions.tsNode}}",
-"typescript": "^{{versions.typescript}}" }, "engines": { "node": ">=20" } }

package/template/tsconfig.json.hbs

@@ -1,3 +0,0 @@
-{ "compilerOptions": { "target": "ES2022", "module": "Node16", "moduleResolution": "Node16", "outDir": "./dist", "rootDir": "./src", "strict": true,
-"esModuleInterop": true, "skipLibCheck": true, "declaration": true, "declarationMap": true, "sourceMap": true, "experimentalDecorators": true,
-"emitDecoratorMetadata": true }, "include": ["src/**/*.ts"], "exclude": ["node_modules", "dist"] }