@fedify/init 2.1.0-dev.421 → 2.1.0-dev.438

package/dist/test/create.js

@@ -1,7 +1,7 @@
 import { CommandError, printErrorMessage, printMessage, product, runSubCommand } from "../utils.js";
 import pm_default from "../json/pm.js";
 import { kvStores, messageQueues } from "../lib.js";
-import webframeworks_default from "../webframeworks.js";
+import webframeworks_default from "../webframeworks/mod.js";
 import { filter, isEmpty, pipe, toArray } from "@fxts/core";
 import process from "node:process";
 import { values } from "@optique/core";
@@ -38,6 +38,9 @@ const createTestApp = (testDirPrefix, dry) => async (options) => {
 			});
 		}
 		printMessage`  Fail: ${vals}`;
+		printMessage`    Check out these files for more details:
+      ${join$1(testDir, "out.txt")} and 
+      ${join$1(testDir, "err.txt")}\n`;
 		return "";
 	}
 };
@@ -57,7 +60,7 @@ function* genInitCommand(testDir, dry, [webFramework, packageManager, kvStore, m
 	yield kvStore;
 	yield "-m";
 	yield messageQueue;
-	if (dry) yield "-d";
+	if (dry) yield "--dry-run";
 }
 const generateTestCases = ({ webFramework, packageManager, kvStore, messageQueue }) => {
 	const pms = filterPackageManager(packageManager);

package/dist/test/lookup.js

@@ -1,6 +1,6 @@
 import { printErrorMessage, printMessage, runSubCommand } from "../utils.js";
 import { getDevCommand } from "../lib.js";
-import webframeworks_default from "../webframeworks.js";
+import webframeworks_default from "../webframeworks/mod.js";
 import process from "node:process";
 import { values } from "@optique/core";
 import { spawn } from "node:child_process";
@@ -53,7 +53,7 @@ async function testApp(dir) {
 		kv,
 		mq
 	])}...`;
-	const result = await serverClosure(dir, getDevCommand(pm), sendLookup);
+	const result = await serverClosure(dir, getDevCommand(pm), sendLookup).catch(() => false);
 	printMessage`    Lookup ${result ? "successful" : "failed"} for ${values([
 		wf,
 		pm,

package/dist/test/utils.js

@@ -7,7 +7,7 @@ import { tmpdir } from "node:os";
 const genRunId = () => `${Date.now()}-${Math.random().toString(36).slice(2)}`;
 const genTestDirPrefix = ({ runId }) => join(tmpdir(), "fedify-init", runId);
 const emptyTestDir = ({ testDirPrefix }) => rm(testDirPrefix, { recursive: true }).catch(() => {});
-const logTestDir = ({ runId, testDirPrefix }) => printMessage`Test run completed.
+const logTestDir = ({ runId, testDirPrefix }) => printMessage`Test running with
 Run ID: ${runId}
 Path: ${testDirPrefix}`;
 

package/dist/types.d.ts

@@ -4,47 +4,108 @@ import { RequiredNotNull } from "./utils.js";
 import { Message } from "@optique/core";
 
 //#region src/types.d.ts
+/** Supported package manager identifiers: `"deno"`, `"pnpm"`, `"bun"`, `"yarn"`, `"npm"`. */
 type PackageManager = typeof PACKAGE_MANAGER[number];
+/** Supported web framework identifiers: `"hono"`, `"nitro"`, `"next"`, `"elysia"`, `"astro"`, `"express"`. */
+
+/**
+ * The result returned by a web framework's `init()` function.
+ * Contains all the information needed to scaffold a project for that framework,
+ * including dependencies, template files, compiler options, and task scripts.
+ */
 interface WebFrameworkInitializer {
+  /** Optional shell command to run before scaffolding (e.g., `create-next-app`). */
   command?: string[];
+  /** Runtime dependencies to install (package name to version). */
   dependencies?: object;
+  /** Development-only dependencies to install (package name to version). */
   devDependencies?: object;
+  /** Relative path where the federation configuration file will be created. */
   federationFile: string;
+  /** Relative path where the logging configuration file will be created. */
   loggingFile: string;
+  /** Additional files to create, keyed by relative path to file content. */
   files?: Record<string, string>;
+  /** TypeScript compiler options to include in `tsconfig.json`. */
   compilerOptions?: Record<string, string | boolean | number | string[] | null>;
+  /** Task scripts keyed by task name (e.g., `"dev"`, `"prod"`, `"lint"`). */
   tasks?: Record<string, string>;
+  /** Instructions shown to the user after project initialization is complete. */
   instruction: Message;
 }
+/**
+ * Describes a web framework integration (Hono, Express, Nitro, Next.js,
+ * ElysiaJS, Astro) and how to initialize a project with it.
+ */
+
+/**
+ * Describes a message queue backend (Deno KV, Redis, PostgreSQL, AMQP) and
+ * the dependencies, imports, and environment variables it requires.
+ */
 interface MessageQueueDescription {
+  /** Human-readable name of the message queue backend. */
   label: string;
+  /** Package managers that this message queue supports. */
   packageManagers: readonly PackageManager[];
+  /** Runtime dependencies required by this message queue. */
   dependencies?: Record<string, string>;
+  /** Development-only dependencies required by this message queue. */
   devDependencies?: Record<string, string>;
+  /** ES module imports needed, keyed by module specifier to named exports. */
   imports: Record<string, Record<string, string>>;
+  /** TypeScript expression that creates the message queue instance. */
   object: string;
+  /** Deno unstable feature flags required (e.g., `["kv"]`). */
   denoUnstable?: string[];
+  /** Environment variables required, keyed by name to default value. */
   env?: Record<string, string>;
 }
+/**
+ * Describes a key-value store backend (Deno KV, Redis, PostgreSQL) and
+ * the dependencies, imports, and environment variables it requires.
+ */
 interface KvStoreDescription {
+  /** Human-readable name of the key-value store backend. */
   label: string;
+  /** Package managers that this KV store supports. */
   packageManagers: readonly PackageManager[];
+  /** Runtime dependencies required by this KV store. */
   dependencies?: Record<string, string>;
+  /** Development-only dependencies required by this KV store. */
   devDependencies?: Record<string, string>;
+  /** ES module imports needed, keyed by module specifier to named exports. */
   imports: Record<string, Record<string, string>>;
+  /** TypeScript expression that creates the KV store instance. */
   object: string;
+  /** Deno unstable feature flags required (e.g., `["kv"]`). */
   denoUnstable?: string[];
+  /** Environment variables required, keyed by name to default value. */
   env?: Record<string, string>;
 }
+/**
+ * Fully resolved initialization options with all fields guaranteed non-null.
+ * Created after the user has answered all interactive prompts.
+ */
 type InitCommandOptions = RequiredNotNull<InitCommand> & {
   readonly testMode: boolean;
 };
+/**
+ * The complete data object used throughout the initialization process.
+ * Extends {@link InitCommandOptions} with derived fields such as the project
+ * name, framework initializer, KV/MQ descriptions, and environment variables.
+ */
 interface InitCommandData extends InitCommandOptions {
+  /** The project name, derived from the target directory's basename. */
   readonly projectName: string;
+  /** The resolved initializer configuration from the chosen web framework. */
   readonly initializer: WebFrameworkInitializer;
+  /** The resolved key-value store description. */
   readonly kv: KvStoreDescription;
+  /** The resolved message queue description. */
   readonly mq: MessageQueueDescription;
+  /** Combined environment variables from both KV store and message queue. */
   readonly env: Record<string, string>;
 }
+/** A synchronous side-effect function that operates on {@link InitCommandData}. */
 //#endregion
 export { InitCommandData };

package/dist/utils.d.ts

@@ -4,6 +4,9 @@ import { toMerged } from "es-toolkit";
 import { spawn } from "node:child_process";
 
 //#region src/utils.d.ts
+
+/** Makes all properties of `T` required and non-nullable. */
 type RequiredNotNull<T> = { [P in keyof T]: NonNullable<T[P]> };
+/** Type guard that checks whether a value is a `Promise`. */
 //#endregion
 export { RequiredNotNull };

package/dist/utils.js

@@ -7,9 +7,25 @@ import { flow, toMerged } from "es-toolkit";
 import { spawn } from "node:child_process";
 
 //#region src/utils.ts
+/**
+* Whether terminal color output is enabled.
+* `true` when stdout is a TTY and the `NO_COLOR` environment variable is not set.
+*/
 const colorEnabled = process.stdout.isTTY && !("NO_COLOR" in process.env && process.env.NO_COLOR !== "");
+/** Chalk instance configured based on {@link colorEnabled}. */
 const colors = new Chalk(colorEnabled ? {} : { level: 0 });
+/** Type guard that checks whether a value is a `Promise`. */
 const isPromise = (value) => value instanceof Promise;
+/**
+* Functional composition helper that adds a computed property to an object.
+* Returns a function that takes an object, computes a value using `f`, and
+* returns a new object with the additional property `key` set to the result.
+* Handles both synchronous and asynchronous computations.
+*
+* @param key - The property key to add
+* @param f - A function that computes the value from the input object
+* @returns A function that augments the input object with the computed property
+*/
 function set(key, f) {
 	return (obj) => {
 		const result = f(obj);
@@ -23,12 +39,31 @@ function set(key, f) {
 		};
 	};
 }
+/**
+* Curried deep merge helper. Returns a function that merges `source` into the
+* given `target` object using `es-toolkit`'s `toMerged`.
+*/
 const merge$1 = (source = {}) => (target = {}) => toMerged(target, source);
+/**
+* Curried `String.prototype.replace`. Returns a function that performs the
+* replacement on the given text.
+*/
 const replace = (pattern, replacement) => (text$1) => text$1.replace(pattern, replacement);
+/**
+* Curried `String.prototype.replaceAll`. Returns a function that replaces all
+* occurrences of the pattern in the given text.
+*/
 const replaceAll = (pattern, replacement) => (text$1) => text$1.replaceAll(pattern, replacement);
+/** Serializes a value to a pretty-printed JSON string with a trailing newline. */
 const formatJson = (obj) => JSON.stringify(obj, null, 2) + "\n";
+/** Checks whether a string or array-like value has a length greater than zero. */
 const notEmpty = (s) => s.length > 0;
+/** Type guard that checks whether an error is a "file not found" (`ENOENT`) error. */
 const isNotFoundError = (e) => isObject(e) && "code" in e && e.code === "ENOENT";
+/**
+* Error thrown when a spawned shell command exits with a non-zero code.
+* Captures stdout, stderr, exit code, and the original command array.
+*/
 var CommandError = class extends Error {
 	commandLine;
 	constructor(message$1, stdout, stderr, code, command$1) {
@@ -41,6 +76,16 @@ var CommandError = class extends Error {
 		this.commandLine = command$1.join(" ");
 	}
 };
+/**
+* Executes a shell command (or a chain of commands joined by `"&&"`) as child
+* processes and returns the combined stdout/stderr output.
+* Throws a {@link CommandError} if any command in the chain exits with a
+* non-zero code.
+*
+* @param command - The command as an array of strings; use `"&&"` to chain
+* @param options - Options forwarded to `node:child_process.spawn`
+* @returns A promise resolving to `{ stdout, stderr }`
+*/
 const runSubCommand = async (command$1, options) => {
 	const commands = command$1.reduce((acc, cur) => {
 		if (cur === "&&") acc.push([]);
@@ -88,14 +133,29 @@ const runSingularCommand = (command$1, options) => new Promise((resolve, reject)
 		reject(error);
 	});
 });
+/** Returns the current working directory. */
 const getCwd = () => process.cwd();
+/** Returns the current OS platform (e.g., `"darwin"`, `"win32"`, `"linux"`). */
 const getOsType = () => process.platform;
+/** Exits the process with the given exit code. */
 const exit = (code) => process.exit(code);
+/**
+* Generates the cartesian product of multiple iterables.
+* Used by the test suite to enumerate all option combinations.
+*
+* @example
+* ```ts
+* [...product(["a", "b"], [1, 2])]
+* // [["a", 1], ["a", 2], ["b", 1], ["b", 2]]
+* ```
+*/
 function* product(...[head, ...tail]) {
 	if (!head) yield [];
 	else for (const x of head) for (const xs of product(...tail)) yield [x, ...xs];
 }
+/** Prints a formatted message to stdout using `@optique/run`'s `print`. */
 const printMessage = flow(message, print);
+/** Prints a formatted error message to stderr using `@optique/run`'s `printError`. */
 const printErrorMessage = flow(message, printError);
 
 //#endregion

package/dist/webframeworks/astro.js

@@ -0,0 +1,83 @@
+import { PACKAGE_VERSION, readTemplate } from "../lib.js";
+import { PACKAGE_MANAGER } from "../const.js";
+import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
+import { getInstruction } from "./utils.js";
+
+//#region src/webframeworks/astro.ts
+const astroDescription = {
+	label: "Astro",
+	packageManagers: PACKAGE_MANAGER,
+	defaultPort: 4321,
+	init: ({ packageManager: pm }) => ({
+		command: Array.from(getAstroInitCommand(pm)),
+		dependencies: pm === "deno" ? {
+			...defaultDenoDependencies,
+			"@deno/astro-adapter": "npm:@deno/astro-adapter@^0.3.2",
+			"@fedify/astro": PACKAGE_VERSION
+		} : {
+			"@astrojs/node": "^9.5.4",
+			"@fedify/astro": PACKAGE_VERSION
+		},
+		devDependencies: {
+			...defaultDevDependencies,
+			...pm !== "deno" ? {
+				typescript: "^5.9.3",
+				"@types/node": "^22.17.0"
+			} : {}
+		},
+		federationFile: "src/federation.ts",
+		loggingFile: "src/logging.ts",
+		files: {
+			[`astro.config.ts`]: readTemplate(`astro/astro.config.${pm === "deno" ? "deno" : "node"}.ts`),
+			"src/middleware.ts": readTemplate("astro/src/middleware.ts"),
+			...pm !== "deno" ? { "eslint.config.ts": readTemplate("defaults/eslint.config.ts") } : {}
+		},
+		compilerOptions: void 0,
+		tasks: {
+			...pm === "deno" ? {
+				dev: "deno run -A npm:astro dev",
+				build: "deno run -A npm:astro build",
+				preview: "deno run -A npm:astro preview"
+			} : pm === "bun" ? {
+				dev: "bunx astro dev",
+				build: "bunx astro build",
+				preview: "bunx astro preview"
+			} : {
+				dev: "astro dev",
+				build: "astro build",
+				preview: "astro preview"
+			},
+			...pm !== "deno" ? { lint: "eslint ." } : {}
+		},
+		instruction: getInstruction(pm, 4321)
+	})
+};
+var astro_default = astroDescription;
+/**
+* Returns the shell command array to scaffold a new Astro project
+* in the current directory using the given package manager.
+* Also removes the default `astro.config.mjs` so it can be replaced
+* by a template.
+*/
+function* getAstroInitCommand(pm) {
+	yield* createAstroAppCommand(pm);
+	yield "astro@latest";
+	yield ".";
+	yield "--";
+	yield "--no-git";
+	yield "--skip-houston";
+	yield "-y";
+	yield "&&";
+	yield "rm";
+	yield "astro.config.mjs";
+	if (pm === "deno") yield "package.json";
+}
+const createAstroAppCommand = (pm) => pm === "deno" ? [
+	"deno",
+	"init",
+	"-y",
+	"--npm"
+] : [pm, "create"];
+
+//#endregion
+export { astro_default as default };

package/dist/webframeworks/const.js

@@ -0,0 +1,11 @@
+import { PACKAGE_VERSION } from "../lib.js";
+
+//#region src/webframeworks/const.ts
+const defaultDevDependencies = {
+	"@fedify/lint": PACKAGE_VERSION,
+	"eslint": "^9.0.0"
+};
+const defaultDenoDependencies = { "@fedify/lint": PACKAGE_VERSION };
+
+//#endregion
+export { defaultDenoDependencies, defaultDevDependencies };

package/dist/webframeworks/elysia.js

@@ -0,0 +1,66 @@
+import { PACKAGE_VERSION, readTemplate } from "../lib.js";
+import { PACKAGE_MANAGER } from "../const.js";
+import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
+import { getInstruction, packageManagerToRuntime } from "./utils.js";
+
+//#region src/webframeworks/elysia.ts
+const elysiaDescription = {
+	label: "ElysiaJS",
+	packageManagers: PACKAGE_MANAGER,
+	defaultPort: 3e3,
+	init: ({ projectName, packageManager: pm }) => ({
+		dependencies: pm === "deno" ? {
+			...defaultDenoDependencies,
+			elysia: "npm:elysia@^1.3.6",
+			"@fedify/elysia": PACKAGE_VERSION
+		} : pm === "bun" ? {
+			elysia: "^1.3.6",
+			"@fedify/elysia": PACKAGE_VERSION
+		} : {
+			elysia: "^1.3.6",
+			"@elysiajs/node": "^1.4.2",
+			"@fedify/elysia": PACKAGE_VERSION,
+			...pm === "pnpm" ? {
+				"@sinclair/typebox": "^0.34.41",
+				"openapi-types": "^12.1.3"
+			} : {}
+		},
+		devDependencies: {
+			...pm === "bun" ? { "@types/bun": "^1.2.19" } : {
+				tsx: "^4.21.0",
+				"@types/node": "^25.0.3",
+				typescript: "^5.9.3"
+			},
+			...defaultDevDependencies
+		},
+		federationFile: "src/federation.ts",
+		loggingFile: "src/logging.ts",
+		files: {
+			"src/index.ts": readTemplate(`elysia/index/${packageManagerToRuntime(pm)}.ts`).replace(/\/\* logger \*\//, projectName),
+			...pm !== "deno" ? { "eslint.config.ts": readTemplate("defaults/eslint.config.ts") } : {}
+		},
+		compilerOptions: pm === "deno" || pm === "bun" ? void 0 : {
+			"lib": ["ESNext", "DOM"],
+			"target": "ESNext",
+			"module": "NodeNext",
+			"moduleResolution": "NodeNext",
+			"allowImportingTsExtensions": true,
+			"verbatimModuleSyntax": true,
+			"noEmit": true,
+			"strict": true
+		},
+		tasks: {
+			"dev": pm === "deno" ? "deno serve --allow-env --allow-net --watch ./src/index.ts" : pm === "bun" ? "bun run --hot ./src/index.ts" : "tsx watch src/index.ts",
+			...pm === "deno" ? { "prod": "deno serve --allow-env --allow-net ./src/index.ts" } : pm === "bun" ? { "prod": "bun run ./src/index.ts" } : {
+				"build": "tsc src/index.ts --outDir dist",
+				"start": "NODE_ENV=production node dist/index.js"
+			},
+			...pm !== "deno" ? { "lint": "eslint ." } : {}
+		},
+		instruction: getInstruction(pm, 3e3)
+	})
+};
+var elysia_default = elysiaDescription;
+
+//#endregion
+export { elysia_default as default };

package/dist/webframeworks/express.js

@@ -0,0 +1,54 @@
+import { PACKAGE_VERSION, readTemplate } from "../lib.js";
+import { PACKAGE_MANAGER } from "../const.js";
+import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
+import { getInstruction } from "./utils.js";
+
+//#region src/webframeworks/express.ts
+const expressDescription = {
+	label: "Express",
+	packageManagers: PACKAGE_MANAGER,
+	defaultPort: 8e3,
+	init: ({ projectName, packageManager: pm }) => ({
+		dependencies: {
+			"npm:express": "^4.19.2",
+			"@fedify/express": PACKAGE_VERSION,
+			...pm !== "deno" && pm !== "bun" ? {
+				"@dotenvx/dotenvx": "^1.14.1",
+				tsx: "^4.17.0"
+			} : {},
+			...pm === "deno" ? defaultDenoDependencies : {}
+		},
+		devDependencies: {
+			"@types/express": "^4.17.21",
+			...pm === "bun" ? { "@types/bun": "^1.1.6" } : {},
+			...defaultDevDependencies
+		},
+		federationFile: "src/federation.ts",
+		loggingFile: "src/logging.ts",
+		files: {
+			"src/app.ts": readTemplate("express/app.ts").replace(/\/\* logger \*\//, projectName),
+			"src/index.ts": readTemplate("express/index.ts"),
+			...pm !== "deno" ? { "eslint.config.ts": readTemplate("defaults/eslint.config.ts") } : {}
+		},
+		compilerOptions: pm === "deno" ? void 0 : {
+			"lib": ["ESNext", "DOM"],
+			"target": "ESNext",
+			"module": "NodeNext",
+			"moduleResolution": "NodeNext",
+			"allowImportingTsExtensions": true,
+			"verbatimModuleSyntax": true,
+			"noEmit": true,
+			"strict": true
+		},
+		tasks: {
+			"dev": pm === "bun" ? "bun run --hot ./src/index.ts" : pm === "deno" ? "deno run --allow-net --allow-env --allow-sys --watch ./src/index.ts" : "dotenvx run -- tsx watch ./src/index.ts",
+			"prod": pm === "bun" ? "bun run ./src/index.ts" : pm === "deno" ? "deno run --allow-net --allow-env --allow-sys ./src/index.ts" : "dotenvx run -- node --import tsx ./src/index.ts",
+			...pm !== "deno" ? { "lint": "eslint ." } : {}
+		},
+		instruction: getInstruction(pm, 8e3)
+	})
+};
+var express_default = expressDescription;
+
+//#endregion
+export { express_default as default };

package/dist/webframeworks/hono.js

@@ -0,0 +1,66 @@
+import { replace } from "../utils.js";
+import { PACKAGE_VERSION, readTemplate } from "../lib.js";
+import { PACKAGE_MANAGER } from "../const.js";
+import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
+import { getInstruction, packageManagerToRuntime } from "./utils.js";
+import { pipe } from "@fxts/core";
+
+//#region src/webframeworks/hono.ts
+const honoDescription = {
+	label: "Hono",
+	packageManagers: PACKAGE_MANAGER,
+	defaultPort: 8e3,
+	init: ({ projectName, packageManager: pm }) => ({
+		dependencies: pm === "deno" ? {
+			...defaultDenoDependencies,
+			"@std/dotenv": "^0.225.2",
+			"@hono/hono": "^4.5.0",
+			"@hongminhee/x-forwarded-fetch": "^0.2.0",
+			"@fedify/hono": PACKAGE_VERSION
+		} : pm === "bun" ? {
+			hono: "^4.5.0",
+			"x-forwarded-fetch": "^0.2.0",
+			"@fedify/hono": PACKAGE_VERSION
+		} : {
+			"@dotenvx/dotenvx": "^1.14.1",
+			hono: "^4.5.0",
+			"@hono/node-server": "^1.12.0",
+			tsx: "^4.17.0",
+			"x-forwarded-fetch": "^0.2.0",
+			"@fedify/hono": PACKAGE_VERSION
+		},
+		devDependencies: {
+			...defaultDevDependencies,
+			...pm === "bun" ? { "@types/bun": "^1.1.6" } : {}
+		},
+		federationFile: "src/federation.ts",
+		loggingFile: "src/logging.ts",
+		files: {
+			"src/app.tsx": pipe("hono/app.tsx", readTemplate, replace(/\/\* hono \*\//, pm === "deno" ? "@hono/hono" : "hono"), replace(/\/\* logger \*\//, projectName)),
+			"src/index.ts": readTemplate(`hono/index/${packageManagerToRuntime(pm)}.ts`),
+			...pm !== "deno" ? { "eslint.config.ts": readTemplate("defaults/eslint.config.ts") } : {}
+		},
+		compilerOptions: pm === "deno" ? void 0 : {
+			"lib": ["ESNext", "DOM"],
+			"target": "ESNext",
+			"module": "NodeNext",
+			"moduleResolution": "NodeNext",
+			"allowImportingTsExtensions": true,
+			"verbatimModuleSyntax": true,
+			"noEmit": true,
+			"strict": true,
+			"jsx": "react-jsx",
+			"jsxImportSource": "hono/jsx"
+		},
+		tasks: {
+			"dev": pm === "deno" ? "deno run -A --watch ./src/index.ts" : pm === "bun" ? "bun run --hot ./src/index.ts" : "dotenvx run -- tsx watch ./src/index.ts",
+			"prod": pm === "deno" ? "deno run -A ./src/index.ts" : pm === "bun" ? "bun run ./src/index.ts" : "dotenvx run -- node --import tsx ./src/index.ts",
+			...pm !== "deno" ? { "lint": "eslint ." } : {}
+		},
+		instruction: getInstruction(pm, 8e3)
+	})
+};
+var hono_default = honoDescription;
+
+//#endregion
+export { hono_default as default };

package/dist/webframeworks/mod.js

@@ -0,0 +1,27 @@
+import astro_default from "./astro.js";
+import elysia_default from "./elysia.js";
+import express_default from "./express.js";
+import hono_default from "./hono.js";
+import next_default from "./next.js";
+import nitro_default from "./nitro.js";
+
+//#region src/webframeworks/mod.ts
+/**
+* Registry of all supported web framework configurations.
+* Each entry defines the framework's label, supported package managers,
+* default port, and an `init()` factory that produces a
+* {@link WebFrameworkInitializer} with dependencies, templates, tasks,
+* and instructions tailored to the selected package manager.
+*/
+const webFrameworks = {
+	astro: astro_default,
+	elysia: elysia_default,
+	express: express_default,
+	hono: hono_default,
+	next: next_default,
+	nitro: nitro_default
+};
+var webframeworks_default = webFrameworks;
+
+//#endregion
+export { webframeworks_default as default };

package/dist/webframeworks/next.js

@@ -0,0 +1,56 @@
+import { PACKAGE_VERSION, readTemplate } from "../lib.js";
+import { PACKAGE_MANAGER } from "../const.js";
+import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
+import { getInstruction } from "./utils.js";
+
+//#region src/webframeworks/next.ts
+const nextDescription = {
+	label: "Next.js",
+	packageManagers: PACKAGE_MANAGER,
+	defaultPort: 3e3,
+	init: ({ packageManager: pm }) => ({
+		command: getNextInitCommand(pm),
+		dependencies: {
+			"@fedify/next": PACKAGE_VERSION,
+			...pm === "deno" ? defaultDenoDependencies : {}
+		},
+		devDependencies: {
+			"@types/node": "^20.11.2",
+			...defaultDevDependencies
+		},
+		federationFile: "federation/index.ts",
+		loggingFile: "logging.ts",
+		files: {
+			"middleware.ts": readTemplate("next/middleware.ts"),
+			...pm !== "deno" ? { "eslint.config.ts": readTemplate("defaults/eslint.config.ts") } : {}
+		},
+		tasks: { ...pm !== "deno" ? { "lint": "eslint ." } : {} },
+		instruction: getInstruction(pm, 3e3)
+	})
+};
+var next_default = nextDescription;
+/**
+* Returns the shell command array to scaffold a new Next.js project
+* in the current directory using the given package manager.
+*/
+const getNextInitCommand = (pm) => [
+	...createNextAppCommand(pm),
+	".",
+	"--yes"
+];
+const createNextAppCommand = (pm) => pm === "deno" ? [
+	"deno",
+	"-Ar",
+	"npm:create-next-app@latest"
+] : pm === "bun" ? [
+	"bun",
+	"create",
+	"next-app"
+] : pm === "npm" ? ["npx", "create-next-app"] : [
+	pm,
+	"dlx",
+	"create-next-app"
+];
+
+//#endregion
+export { next_default as default };