@wolfstar/create-http-framework 2.3.0 → 2.4.0-next-20260905171250

package/dist/index.js

@@ -279,6 +279,16 @@ const sharedCompilerOptions = {
 	experimentalDecorators: true,
 	emitDecoratorMetadata: true
 };
+/**
+* The `paths` that make `stars`' built-in aliases type-check. Only the `tsdown` build resolves them, so only its
+* tsconfig declares them: `tsc` emits imports untouched and would leave `~/lib/…` in the output.
+*/
+const STARS_ALIAS_PATHS = {
+	"~/*": ["./src/*"],
+	"@/*": ["./src/*"],
+	"~~/*": ["./*"],
+	"@@/*": ["./*"]
+};
 /** 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;
@@ -287,9 +297,10 @@ function writeTsconfig(targetDir, ctx) {
 			compilerOptions: {
 				...sharedCompilerOptions,
 				outDir: "./dist",
-				rootDir: "./src"
+				rootDir: "./src",
+				paths: STARS_ALIAS_PATHS
 			},
-			include: ["src/**/*.ts"],
+			include: ["src/**/*.ts", ".stars/*.d.ts"],
 			exclude: ["node_modules", "dist"]
 		}));
 		return;
@@ -309,36 +320,23 @@ function writeTsconfig(targetDir, ctx) {
 		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/main.js so the shared `start` script (node dist/main.js) works.",
-		"	outExtensions: () => ({ js: '.js' }),",
-		"	clean: true,",
-		"	sourcemap: true",
-		"});",
-		""
-	].join("\n");
-	writeFile(join(targetDir, "tsdown.config.ts"), content);
-}
-/** Writes the `stars.config.*` file read by the `stars` CLI (`dev`, `build`, `info`, `codegen` scripts). */
+/**
+* Writes the `stars.config.*` file read by the `stars` CLI (`dev`, `build`, `info`, `codegen` scripts). It carries
+* the build too: `tsdown` projects are configured here rather than in a `tsdown.config.ts` of their own, which is
+* what `future.compatibilityVersion: 4` means for a generated project.
+*/
 function writeStarsConfig(targetDir, ctx) {
 	const isJs = ctx.language === "js";
-	const build = isJs ? "{ tool: 'none' }" : ctx.buildTool === "tsdown" ? "{ tool: 'tsdown' }" : "{ tool: 'tsc', tsconfig: 'src/tsconfig.json' }";
+	const isTsdown = !isJs && ctx.buildTool === "tsdown";
 	const content = [
 		"import { defineConfig } from '@wolfstar/http-framework/config';",
 		"",
 		"export default defineConfig({",
 		`\tentry: 'src/main.${isJs ? "js" : "ts"}',`,
-		`\tbuild: ${build}`,
+		`\tbuild: ${isJs ? "{ tool: 'none' }" : isTsdown ? "{ tool: 'tsdown' }" : "{ tool: 'tsc', tsconfig: 'src/tsconfig.json' }"},`,
+		"	// The next major's defaults: auto imports wired into the build, and `tsdown` configured from this file.",
+		"	future: { compatibilityVersion: 4 }",
+		...isTsdown ? ["	// The build needs nothing else. Add a `tsdown` block for what the defaults cannot know,", "	// such as a plugin that copies assets into dist/."] : [],
 		"});",
 		""
 	].join("\n");
@@ -398,7 +396,6 @@ function writeFormatterConfig(targetDir, ctx) {
 function writeProjectFiles(targetDir, ctx) {
 	writeFile(join(targetDir, "package.json"), packageJson(ctx));
 	writeTsconfig(targetDir, ctx);
-	writeBuildConfig(targetDir, ctx);
 	writeStarsConfig(targetDir, ctx);
 	writeLinterConfig(targetDir, ctx);
 	writeFormatterConfig(targetDir, ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wolfstar/create-http-framework",
-  "version": "2.3.0",
+  "version": "2.4.0-next-20260905171250",
   "description": "Create a new WolfStar HTTP Framework bot project",
   "keywords": [
     "cli",

package/template/base/.gitignore.hbs

@@ -1,5 +1,6 @@
 node_modules/
 dist/
+.stars/
 .env
 *.js.map
 .create-http-framework.json