@better-fullstack/types 1.3.17 → 1.3.18

package/dist/index.mjs

@@ -1,3 +1,2350 @@
-import { $ as FrontendSchema, $t as SEARCH_VALUES, A as DATABASE_SETUP_VALUES, At as ProjectNameSchema, B as EcosystemSchema, Bt as RUST_CLI_VALUES, C as CLIInputSchema, Ct as PYTHON_QUALITY_VALUES, D as CSS_FRAMEWORK_VALUES, Dt as PackageManagerSchema, E as CSSFrameworkSchema, Et as PYTHON_WEB_FRAMEWORK_VALUES, F as DirectoryConflictSchema, Ft as PythonValidationSchema, G as FILE_STORAGE_VALUES, Gt as RealtimeSchema, H as EmailSchema, Ht as RUST_LIBRARIES_VALUES, I as ECOSYSTEM_VALUES, It as PythonWebFrameworkSchema, J as FRONTEND_VALUES, Jt as RustCliSchema, K as FILE_UPLOAD_VALUES, Kt as RuntimeSchema, L as EFFECT_VALUES, Lt as REALTIME_VALUES, M as DIRECTORY_CONFLICT_VALUES, Mt as PythonOrmSchema, N as DatabaseSchema, Nt as PythonQualitySchema, O as CachingSchema, Ot as PaymentsSchema, P as DatabaseSetupSchema, Pt as PythonTaskQueueSchema, Q as FormsSchema, Qt as RustWebFrameworkSchema, R as EMAIL_VALUES, Rt as RUNTIME_VALUES, S as CACHING_VALUES, St as PYTHON_ORM_VALUES, T as CMS_VALUES, Tt as PYTHON_VALIDATION_VALUES, U as ExamplesSchema, Ut as RUST_ORM_VALUES, V as EffectSchema, Vt as RUST_FRONTEND_VALUES, W as FEATURE_FLAGS_VALUES, Wt as RUST_WEB_FRAMEWORK_VALUES, X as FileStorageSchema, Xt as RustLibrariesSchema, Y as FeatureFlagsSchema, Yt as RustFrontendSchema, Z as FileUploadSchema, Zt as RustOrmSchema, _ as AuthSchema, _t as ORM_VALUES, a as ANALYTICS_VALUES, an as TEMPLATE_VALUES, at as GoApiSchema, b as BetterTStackConfigFileSchema, bt as PAYMENTS_VALUES, c as API_VALUES, cn as TestingSchema, ct as GoOrmSchema, d as AddInputSchema, dn as VALIDATION_VALUES, dt as JOB_QUEUE_VALUES, en as SERVER_DEPLOY_VALUES, et as GO_API_VALUES, f as AddonsSchema, fn as ValidationSchema, ft as JobQueueSchema, g as AstroIntegrationSchema, gt as ORMSchema, h as AnimationSchema, ht as OBSERVABILITY_VALUES, i as AI_VALUES, in as StateManagementSchema, it as GO_WEB_FRAMEWORK_VALUES, j as DATABASE_VALUES, jt as PythonAiSchema, k as CreateInputSchema, kt as ProjectConfigSchema, l as ASTRO_INTEGRATION_VALUES, ln as UILibrarySchema, lt as GoWebFrameworkSchema, m as AnalyticsSchema, mn as WebDeploySchema, mt as LoggingSchema, n as AISchema, nn as SearchSchema, nt as GO_LOGGING_VALUES, o as ANIMATION_VALUES, on as TESTING_VALUES, ot as GoCliSchema, p as AiDocsSchema, pn as WEB_DEPLOY_VALUES, pt as LOGGING_VALUES, q as FORMS_VALUES, qt as RustApiSchema, r as AI_DOCS_VALUES, rn as ServerDeploySchema, rt as GO_ORM_VALUES, s as APISchema, sn as TemplateSchema, st as GoLoggingSchema, t as ADDONS_VALUES, tn as STATE_MANAGEMENT_VALUES, tt as GO_CLI_VALUES, u as AUTH_VALUES, un as UI_LIBRARY_VALUES, ut as InitResultSchema, v as BACKEND_VALUES, vt as ObservabilitySchema, w as CMSSchema, wt as PYTHON_TASK_QUEUE_VALUES, x as BetterTStackConfigSchema, xt as PYTHON_AI_VALUES, y as BackendSchema, yt as PACKAGE_MANAGER_VALUES, z as EXAMPLES_VALUES, zt as RUST_API_VALUES } from "./schemas-j7_vA7t5.mjs";
+import { $ as FrontendSchema, $t as SEARCH_VALUES, A as DATABASE_SETUP_VALUES, At as ProjectNameSchema, B as EcosystemSchema, Bt as RUST_CLI_VALUES, C as CLIInputSchema, Cn as UILibrarySchema, Ct as PYTHON_QUALITY_VALUES, D as CSS_FRAMEWORK_VALUES, Dn as WEB_DEPLOY_VALUES, Dt as PackageManagerSchema, E as CSSFrameworkSchema, En as ValidationSchema, Et as PYTHON_WEB_FRAMEWORK_VALUES, F as DirectoryConflictSchema, Ft as PythonValidationSchema, G as FILE_STORAGE_VALUES, Gt as RealtimeSchema, H as EmailSchema, Ht as RUST_LIBRARIES_VALUES, I as ECOSYSTEM_VALUES, It as PythonWebFrameworkSchema, J as FRONTEND_VALUES, Jt as RustCliSchema, K as FILE_UPLOAD_VALUES, Kt as RuntimeSchema, L as EFFECT_VALUES, Lt as REALTIME_VALUES, M as DIRECTORY_CONFLICT_VALUES, Mt as PythonOrmSchema, N as DatabaseSchema, Nt as PythonQualitySchema, O as CachingSchema, On as WebDeploySchema, Ot as PaymentsSchema, P as DatabaseSetupSchema, Pt as PythonTaskQueueSchema, Q as FormsSchema, Qt as RustWebFrameworkSchema, R as EMAIL_VALUES, Rt as RUNTIME_VALUES, S as CACHING_VALUES, Sn as TestingSchema, St as PYTHON_ORM_VALUES, T as CMS_VALUES, Tn as VALIDATION_VALUES, Tt as PYTHON_VALIDATION_VALUES, U as ExamplesSchema, Ut as RUST_ORM_VALUES, V as EffectSchema, Vt as RUST_FRONTEND_VALUES, W as FEATURE_FLAGS_VALUES, Wt as RUST_WEB_FRAMEWORK_VALUES, X as FileStorageSchema, Xt as RustLibrariesSchema, Y as FeatureFlagsSchema, Yt as RustFrontendSchema, Z as FileUploadSchema, Zt as RustOrmSchema, _ as AuthSchema, _n as ShadcnStyleSchema, _t as ORM_VALUES, a as ANALYTICS_VALUES, an as SHADCN_ICON_LIBRARY_VALUES, at as GoApiSchema, b as BetterTStackConfigFileSchema, bn as TESTING_VALUES, bt as PAYMENTS_VALUES, c as API_VALUES, cn as STATE_MANAGEMENT_VALUES, ct as GoOrmSchema, d as AddInputSchema, dn as ShadcnBaseColorSchema, dt as JOB_QUEUE_VALUES, en as SERVER_DEPLOY_VALUES, et as GO_API_VALUES, f as AddonsSchema, fn as ShadcnBaseSchema, ft as JobQueueSchema, g as AstroIntegrationSchema, gn as ShadcnRadiusSchema, gt as ORMSchema, h as AnimationSchema, hn as ShadcnIconLibrarySchema, ht as OBSERVABILITY_VALUES, i as AI_VALUES, in as SHADCN_FONT_VALUES, it as GO_WEB_FRAMEWORK_VALUES, j as DATABASE_VALUES, jt as PythonAiSchema, k as CreateInputSchema, kt as ProjectConfigSchema, l as ASTRO_INTEGRATION_VALUES, ln as SearchSchema, lt as GoWebFrameworkSchema, m as AnalyticsSchema, mn as ShadcnFontSchema, mt as LoggingSchema, n as AISchema, nn as SHADCN_BASE_VALUES, nt as GO_LOGGING_VALUES, o as ANIMATION_VALUES, on as SHADCN_RADIUS_VALUES, ot as GoCliSchema, p as AiDocsSchema, pn as ShadcnColorThemeSchema, pt as LOGGING_VALUES, q as FORMS_VALUES, qt as RustApiSchema, r as AI_DOCS_VALUES, rn as SHADCN_COLOR_THEME_VALUES, rt as GO_ORM_VALUES, s as APISchema, sn as SHADCN_STYLE_VALUES, st as GoLoggingSchema, t as ADDONS_VALUES, tn as SHADCN_BASE_COLOR_VALUES, tt as GO_CLI_VALUES, u as AUTH_VALUES, un as ServerDeploySchema, ut as InitResultSchema, v as BACKEND_VALUES, vn as StateManagementSchema, vt as ObservabilitySchema, w as CMSSchema, wn as UI_LIBRARY_VALUES, wt as PYTHON_TASK_QUEUE_VALUES, x as BetterTStackConfigSchema, xn as TemplateSchema, xt as PYTHON_AI_VALUES, y as BackendSchema, yn as TEMPLATE_VALUES, yt as PACKAGE_MANAGER_VALUES, z as EXAMPLES_VALUES, zt as RUST_API_VALUES } from "./schemas-CdFUciyW.mjs";
 
-export { ADDONS_VALUES, AISchema, AI_DOCS_VALUES, AI_VALUES, ANALYTICS_VALUES, ANIMATION_VALUES, APISchema, API_VALUES, ASTRO_INTEGRATION_VALUES, AUTH_VALUES, AddInputSchema, AddonsSchema, AiDocsSchema, AnalyticsSchema, AnimationSchema, AstroIntegrationSchema, AuthSchema, BACKEND_VALUES, BackendSchema, BetterTStackConfigFileSchema, BetterTStackConfigSchema, CACHING_VALUES, CLIInputSchema, CMSSchema, CMS_VALUES, CSSFrameworkSchema, CSS_FRAMEWORK_VALUES, CachingSchema, CreateInputSchema, DATABASE_SETUP_VALUES, DATABASE_VALUES, DIRECTORY_CONFLICT_VALUES, DatabaseSchema, DatabaseSetupSchema, DirectoryConflictSchema, ECOSYSTEM_VALUES, EFFECT_VALUES, EMAIL_VALUES, EXAMPLES_VALUES, EcosystemSchema, EffectSchema, EmailSchema, ExamplesSchema, FEATURE_FLAGS_VALUES, FILE_STORAGE_VALUES, FILE_UPLOAD_VALUES, FORMS_VALUES, FRONTEND_VALUES, FeatureFlagsSchema, FileStorageSchema, FileUploadSchema, FormsSchema, FrontendSchema, GO_API_VALUES, GO_CLI_VALUES, GO_LOGGING_VALUES, GO_ORM_VALUES, GO_WEB_FRAMEWORK_VALUES, GoApiSchema, GoCliSchema, GoLoggingSchema, GoOrmSchema, GoWebFrameworkSchema, InitResultSchema, JOB_QUEUE_VALUES, JobQueueSchema, LOGGING_VALUES, LoggingSchema, OBSERVABILITY_VALUES, ORMSchema, ORM_VALUES, ObservabilitySchema, PACKAGE_MANAGER_VALUES, PAYMENTS_VALUES, PYTHON_AI_VALUES, PYTHON_ORM_VALUES, PYTHON_QUALITY_VALUES, PYTHON_TASK_QUEUE_VALUES, PYTHON_VALIDATION_VALUES, PYTHON_WEB_FRAMEWORK_VALUES, PackageManagerSchema, PaymentsSchema, ProjectConfigSchema, ProjectNameSchema, PythonAiSchema, PythonOrmSchema, PythonQualitySchema, PythonTaskQueueSchema, PythonValidationSchema, PythonWebFrameworkSchema, REALTIME_VALUES, RUNTIME_VALUES, RUST_API_VALUES, RUST_CLI_VALUES, RUST_FRONTEND_VALUES, RUST_LIBRARIES_VALUES, RUST_ORM_VALUES, RUST_WEB_FRAMEWORK_VALUES, RealtimeSchema, RuntimeSchema, RustApiSchema, RustCliSchema, RustFrontendSchema, RustLibrariesSchema, RustOrmSchema, RustWebFrameworkSchema, SEARCH_VALUES, SERVER_DEPLOY_VALUES, STATE_MANAGEMENT_VALUES, SearchSchema, ServerDeploySchema, StateManagementSchema, TEMPLATE_VALUES, TESTING_VALUES, TemplateSchema, TestingSchema, UILibrarySchema, UI_LIBRARY_VALUES, VALIDATION_VALUES, ValidationSchema, WEB_DEPLOY_VALUES, WebDeploySchema };
+//#region src/capabilities.ts
+const CAPABILITY_DEFINITIONS = { auth: [
+	{
+		id: "better-auth",
+		label: "Better-Auth",
+		description: "The most comprehensive authentication framework for TypeScript",
+		promptHint: "comprehensive auth framework for TypeScript",
+		icon: "/icon/better-auth.svg",
+		color: "from-green-400 to-green-600",
+		default: true
+	},
+	{
+		id: "go-better-auth",
+		label: "GoBetterAuth",
+		description: "Embedded auth routes for Go applications",
+		promptHint: "embedded auth routes for Go applications",
+		icon: "https://cdn.simpleicons.org/go/00ADD8",
+		color: "from-cyan-400 to-sky-600"
+	},
+	{
+		id: "clerk",
+		label: "Clerk",
+		description: "More than authentication, Complete User Management",
+		promptHint: "More than auth, Complete User Management",
+		icon: "https://cdn.simpleicons.org/clerk/6C47FF",
+		color: "from-blue-400 to-blue-600"
+	},
+	{
+		id: "nextauth",
+		label: "Auth.js (NextAuth)",
+		description: "Open source authentication for Next.js",
+		promptHint: "Authentication for Next.js (formerly NextAuth.js)",
+		icon: "/icon/nextauth.png",
+		color: "from-orange-400 to-orange-600"
+	},
+	{
+		id: "stack-auth",
+		label: "Stack Auth",
+		description: "Open-source Auth0/Clerk alternative with user management",
+		promptHint: "Open-source Auth0/Clerk alternative",
+		icon: "/icon/stack-auth.svg",
+		color: "from-purple-400 to-purple-600"
+	},
+	{
+		id: "supabase-auth",
+		label: "Supabase Auth",
+		description: "Open-source Auth with Supabase platform integration",
+		promptHint: "Auth with Supabase platform integration",
+		icon: "https://cdn.simpleicons.org/supabase/3FCF8E",
+		color: "from-emerald-400 to-emerald-600"
+	},
+	{
+		id: "auth0",
+		label: "Auth0",
+		description: "Flexible identity platform for authentication and authorization",
+		promptHint: "Flexible identity platform for authentication",
+		icon: "https://cdn.simpleicons.org/auth0/EB5424",
+		color: "from-orange-400 to-orange-600"
+	},
+	{
+		id: "none",
+		label: "No Auth",
+		description: "Skip authentication",
+		promptHint: "No authentication",
+		icon: "",
+		color: "from-red-400 to-red-600"
+	}
+] };
+const NATIVE_FRONTENDS = new Set([
+	"native-bare",
+	"native-uniwind",
+	"native-unistyles"
+]);
+const CONVEX_BETTER_AUTH_WEB = new Set([
+	"tanstack-router",
+	"tanstack-start",
+	"next"
+]);
+const CONVEX_CLERK_WEB = new Set([
+	"react-router",
+	"tanstack-router",
+	"tanstack-start",
+	"next"
+]);
+function capitalizeFirst(value) {
+	return value.charAt(0).toUpperCase() + value.slice(1);
+}
+function dedupe(values) {
+	return [...new Set(values)];
+}
+function getFrontendSets(context) {
+	if (context.frontend) {
+		const webFrontend = context.frontend.filter((frontend) => !NATIVE_FRONTENDS.has(frontend));
+		const nativeFrontend = context.frontend.filter((frontend) => NATIVE_FRONTENDS.has(frontend));
+		return {
+			webFrontend: dedupe(webFrontend),
+			nativeFrontend: dedupe(nativeFrontend)
+		};
+	}
+	return {
+		webFrontend: dedupe(context.webFrontend ?? []),
+		nativeFrontend: dedupe(context.nativeFrontend ?? [])
+	};
+}
+function isSelfBackend(backend) {
+	return backend === "self" || backend?.startsWith("self-") === true;
+}
+function getNextOnlyAuthLabel(optionId) {
+	switch (optionId) {
+		case "nextauth": return "Auth.js (NextAuth)";
+		case "stack-auth": return "Stack Auth";
+		case "supabase-auth": return "Supabase Auth";
+		case "auth0": return "Auth0";
+		default: {
+			const _exhaustive = optionId;
+			return String(_exhaustive);
+		}
+	}
+}
+function getAuthDisabledReason(context, optionId) {
+	if (optionId === "none") return null;
+	const ecosystem = context.ecosystem ?? "typescript";
+	const backend = context.backend;
+	const { webFrontend, nativeFrontend } = getFrontendSets(context);
+	const hasNextJs = webFrontend.includes("next");
+	const hasTanStackStart = webFrontend.includes("tanstack-start");
+	const hasNativeFrontend = nativeFrontend.some((frontend) => frontend !== "none");
+	if (optionId === "go-better-auth") return ecosystem === "go" ? null : "GoBetterAuth is available only for Go stacks";
+	if (ecosystem === "go") return "Go stacks currently support GoBetterAuth only";
+	if (ecosystem !== "typescript") return `${capitalizeFirst(ecosystem)} stacks do not support auth integrations yet`;
+	if (backend === "none") return "No backend selected";
+	if (optionId === "better-auth") {
+		if (backend === "convex") {
+			if (!(webFrontend.some((frontend) => CONVEX_BETTER_AUTH_WEB.has(frontend)) || nativeFrontend.some((frontend) => NATIVE_FRONTENDS.has(frontend)))) return "Better-Auth with Convex requires TanStack Router, TanStack Start, Next.js, or React Native";
+		}
+		return null;
+	}
+	if (optionId === "clerk") {
+		if (backend === "convex") {
+			if (!(webFrontend.some((frontend) => CONVEX_CLERK_WEB.has(frontend)) || nativeFrontend.some((frontend) => NATIVE_FRONTENDS.has(frontend)))) return "Clerk with Convex requires React Router, TanStack Router, TanStack Start, Next.js, or React Native";
+			return null;
+		}
+		if (isSelfBackend(backend)) {
+			if ((hasNextJs || hasTanStackStart) && hasNativeFrontend) return "In Better-Fullstack, Clerk with self backend is currently supported only for web-only Next.js or TanStack Start projects (no native companion app)";
+			if (hasNextJs || hasTanStackStart) return null;
+			if (backend === "self-astro" || webFrontend.includes("astro")) return "In Better-Fullstack, Clerk is not yet supported for Astro fullstack projects";
+			if (backend === "self-nuxt" || webFrontend.includes("nuxt")) return "In Better-Fullstack, Clerk is not yet supported for Nuxt fullstack projects";
+			if (backend === "self-svelte" || webFrontend.includes("svelte")) return "In Better-Fullstack, Clerk is not yet supported for SvelteKit fullstack projects";
+			if (backend === "self-solid-start" || webFrontend.includes("solid-start")) return "In Better-Fullstack, Clerk is not yet supported for SolidStart fullstack projects";
+			return "In Better-Fullstack, Clerk is currently supported with Convex, Next.js fullstack, or TanStack Start fullstack";
+		}
+		return "In Better-Fullstack, Clerk is currently supported with Convex, Next.js fullstack, or TanStack Start fullstack";
+	}
+	const nextOnlyLabel = getNextOnlyAuthLabel(optionId);
+	if (backend !== "self" && backend !== "self-next") return `In Better-Fullstack, ${nextOnlyLabel} is currently supported only with the 'self' backend (fullstack Next.js)`;
+	if (!hasNextJs) return `In Better-Fullstack, ${nextOnlyLabel} currently requires the Next.js frontend`;
+	return null;
+}
+function getCapabilityDefinitions(capability) {
+	return CAPABILITY_DEFINITIONS[capability];
+}
+function getCapabilityDisabledReason(capability, context, optionId) {
+	if (capability === "auth") return getAuthDisabledReason(context, optionId);
+	return null;
+}
+function getSupportedCapabilityOptions(capability, context) {
+	return getCapabilityDefinitions(capability).filter((definition) => getCapabilityDisabledReason(capability, context, definition.id) === null);
+}
+function normalizeCapabilitySelection(capability, context, optionId) {
+	const fallbackValue = "none";
+	if (!optionId || optionId === fallbackValue) return {
+		value: optionId ?? fallbackValue,
+		normalized: false,
+		reason: null,
+		message: null
+	};
+	const reason = getCapabilityDisabledReason(capability, context, optionId);
+	if (!reason) return {
+		value: optionId,
+		normalized: false,
+		reason: null,
+		message: null
+	};
+	return {
+		value: fallbackValue,
+		normalized: true,
+		reason,
+		message: `${capitalizeFirst(capability)} set to 'None' (${reason})`
+	};
+}
+
+//#endregion
+//#region src/compatibility.ts
+const CATEGORY_ORDER = [
+	...[
+		"webFrontend",
+		"nativeFrontend",
+		"astroIntegration",
+		"cssFramework",
+		"uiLibrary",
+		"backend",
+		"backendLibraries",
+		"runtime",
+		"api",
+		"database",
+		"orm",
+		"dbSetup",
+		"webDeploy",
+		"serverDeploy",
+		"auth",
+		"payments",
+		"email",
+		"fileUpload",
+		"logging",
+		"observability",
+		"featureFlags",
+		"analytics",
+		"ai",
+		"stateManagement",
+		"forms",
+		"validation",
+		"testing",
+		"realtime",
+		"jobQueue",
+		"caching",
+		"search",
+		"fileStorage",
+		"animation",
+		"cms",
+		"codeQuality",
+		"documentation",
+		"appPlatforms",
+		"packageManager",
+		"examples",
+		"aiDocs",
+		"git",
+		"install"
+	],
+	"rustWebFramework",
+	"rustFrontend",
+	"rustOrm",
+	"rustApi",
+	"rustCli",
+	"rustLibraries",
+	"pythonWebFramework",
+	"pythonOrm",
+	"pythonValidation",
+	"pythonAi",
+	"pythonTaskQueue",
+	"pythonQuality",
+	"goWebFramework",
+	"goOrm",
+	"goApi",
+	"goCli",
+	"goLogging"
+];
+const DEFAULT_RUNTIME = "bun";
+function validateProjectName(name) {
+	const INVALID_CHARS = [
+		"<",
+		">",
+		":",
+		"\"",
+		"|",
+		"?",
+		"*"
+	];
+	const MAX_LENGTH = 255;
+	if (name === ".") return void 0;
+	if (!name) return "Project name cannot be empty";
+	if (name.length > MAX_LENGTH) return `Project name must be less than ${MAX_LENGTH} characters`;
+	if (INVALID_CHARS.some((char) => name.includes(char))) return "Project name contains invalid characters";
+	if (name.startsWith(".") || name.startsWith("-")) return "Project name cannot start with a dot or dash";
+	if (name.toLowerCase() === "node_modules" || name.toLowerCase() === "favicon.ico") return "Project name is reserved";
+}
+const hasPWACompatibleFrontend = (webFrontend) => webFrontend.some((f) => [
+	"tanstack-router",
+	"react-router",
+	"solid",
+	"next",
+	"astro"
+].includes(f));
+const hasTauriCompatibleFrontend = (webFrontend) => webFrontend.some((f) => [
+	"tanstack-router",
+	"react-router",
+	"nuxt",
+	"svelte",
+	"solid",
+	"next",
+	"astro"
+].includes(f));
+const isChatSdkExampleSupported = (stack) => {
+	if (stack.ecosystem !== "typescript") return false;
+	if (stack.backend === "self-next" || stack.backend === "self-tanstack-start") return true;
+	if (stack.backend === "self-nuxt") return true;
+	if (stack.backend === "hono") return stack.runtime === "node";
+	return false;
+};
+const requiresChatSdkVercelAI = (stack) => {
+	return stack.examples.includes("chat-sdk") && (stack.backend === "self-nuxt" || stack.backend === "hono" && stack.runtime === "node");
+};
+const getCategoryDisplayName = (categoryKey) => {
+	const rustCategoryNames = {
+		rustWebFramework: "Rust Web Framework",
+		rustFrontend: "Rust Frontend (WASM)",
+		rustOrm: "Rust ORM / Database",
+		rustApi: "Rust API Layer",
+		rustCli: "Rust CLI Tools",
+		rustLibraries: "Rust Core Libraries"
+	};
+	const pythonCategoryNames = {
+		pythonWebFramework: "Python Web Framework",
+		pythonOrm: "Python ORM / Database",
+		pythonValidation: "Python Validation",
+		pythonAi: "Python AI / ML",
+		pythonTaskQueue: "Python Task Queue",
+		pythonQuality: "Python Code Quality"
+	};
+	const goCategoryNames = {
+		goWebFramework: "Go Web Framework",
+		goOrm: "Go ORM / Database",
+		goApi: "Go API Layer",
+		goCli: "Go CLI Tools",
+		goLogging: "Go Logging"
+	};
+	if (rustCategoryNames[categoryKey]) return rustCategoryNames[categoryKey];
+	if (pythonCategoryNames[categoryKey]) return pythonCategoryNames[categoryKey];
+	if (goCategoryNames[categoryKey]) return goCategoryNames[categoryKey];
+	const result = categoryKey.replace(/([A-Z])/g, " $1");
+	return result.charAt(0).toUpperCase() + result.slice(1);
+};
+/**
+* Analyzes the stack and auto-adjusts incompatible selections.
+* This follows the CLI approach: when you make a selection, dependent items adjust automatically.
+* The flow is: frontend -> backend -> runtime -> database -> orm -> api -> auth -> etc.
+*/
+const analyzeStackCompatibility = (stack) => {
+	if (stack.yolo === "true") return {
+		adjustedStack: null,
+		notes: {},
+		changes: []
+	};
+	const nextStack = { ...stack };
+	let changed = false;
+	const notes = {};
+	const changes = [];
+	for (const cat of CATEGORY_ORDER) notes[cat] = {
+		notes: [],
+		hasIssue: false
+	};
+	if (nextStack.backend === "convex") {
+		for (const [key, value] of Object.entries({
+			runtime: "none",
+			database: "none",
+			orm: "none",
+			api: "none",
+			dbSetup: "none",
+			serverDeploy: "none",
+			search: "none",
+			fileStorage: "none"
+		})) {
+			const catKey = key;
+			if (nextStack[catKey] !== value) {
+				nextStack[catKey] = value;
+				changed = true;
+				changes.push({
+					category: "backend",
+					message: `${getCategoryDisplayName(catKey)} set to '${value}' (Convex provides this)`
+				});
+			}
+		}
+		if (nextStack.webFrontend.includes("solid")) {
+			nextStack.webFrontend = nextStack.webFrontend.filter((f) => f !== "solid");
+			if (nextStack.webFrontend.length === 0) nextStack.webFrontend = ["none"];
+			changed = true;
+			changes.push({
+				category: "backend",
+				message: "Removed Solid (incompatible with Convex)"
+			});
+		}
+		if (nextStack.webFrontend.includes("solid-start")) {
+			nextStack.webFrontend = nextStack.webFrontend.filter((f) => f !== "solid-start");
+			if (nextStack.webFrontend.length === 0) nextStack.webFrontend = ["none"];
+			changed = true;
+			changes.push({
+				category: "backend",
+				message: "Removed SolidStart (incompatible with Convex)"
+			});
+		}
+		if (nextStack.webFrontend.includes("astro")) {
+			nextStack.webFrontend = nextStack.webFrontend.filter((f) => f !== "astro");
+			if (nextStack.webFrontend.length === 0) nextStack.webFrontend = ["none"];
+			nextStack.astroIntegration = "none";
+			changed = true;
+			changes.push({
+				category: "backend",
+				message: "Removed Astro (incompatible with Convex)"
+			});
+		}
+		if (nextStack.examples.includes("ai")) {
+			if (nextStack.webFrontend.some((f) => [
+				"solid",
+				"svelte",
+				"nuxt"
+			].includes(f))) {
+				nextStack.examples = nextStack.examples.filter((e) => e !== "ai");
+				if (nextStack.examples.length === 0) nextStack.examples = ["none"];
+				changed = true;
+				changes.push({
+					category: "examples",
+					message: "AI example removed (Convex AI only supports React-based frontends)"
+				});
+			}
+		}
+	}
+	if (nextStack.backend === "none") {
+		const noneOverrides = {
+			runtime: "none",
+			database: "none",
+			orm: "none",
+			api: "none",
+			dbSetup: "none",
+			serverDeploy: "none",
+			payments: "none",
+			search: "none",
+			fileStorage: "none"
+		};
+		if (nextStack.ecosystem !== "go") noneOverrides.auth = "none";
+		for (const [key, value] of Object.entries(noneOverrides)) {
+			const catKey = key;
+			if (nextStack[catKey] !== value) {
+				nextStack[catKey] = value;
+				changed = true;
+				changes.push({
+					category: "backend",
+					message: `${getCategoryDisplayName(catKey)} set to '${value}' (no backend)`
+				});
+			}
+		}
+		if (nextStack.examples.length > 0 && !(nextStack.examples.length === 1 && nextStack.examples[0] === "none")) {
+			nextStack.examples = ["none"];
+			changed = true;
+			changes.push({
+				category: "backend",
+				message: "Examples cleared (no backend)"
+			});
+		}
+	}
+	if (nextStack.backend === "self-next" || nextStack.backend === "self-tanstack-start" || nextStack.backend === "self-astro" || nextStack.backend === "self-nuxt" || nextStack.backend === "self-svelte" || nextStack.backend === "self-solid-start") {
+		if (nextStack.runtime !== "none") {
+			nextStack.runtime = "none";
+			changed = true;
+			changes.push({
+				category: "backend",
+				message: "Runtime set to 'None' (fullstack uses frontend's API routes)"
+			});
+		}
+		if (nextStack.serverDeploy !== "none") {
+			nextStack.serverDeploy = "none";
+			changed = true;
+			changes.push({
+				category: "backend",
+				message: "Server deploy set to 'None' (fullstack uses frontend deployment)"
+			});
+		}
+		if (nextStack.backend === "self-next" && !nextStack.webFrontend.includes("next")) {
+			nextStack.webFrontend = ["next"];
+			changed = true;
+			changes.push({
+				category: "backend",
+				message: "Frontend set to 'Next.js' (required for Next.js fullstack)"
+			});
+		}
+		if (nextStack.backend === "self-tanstack-start" && !nextStack.webFrontend.includes("tanstack-start")) {
+			nextStack.webFrontend = ["tanstack-start"];
+			changed = true;
+			changes.push({
+				category: "backend",
+				message: "Frontend set to 'TanStack Start' (required for TanStack Start fullstack)"
+			});
+		}
+		if (nextStack.backend === "self-astro" && !nextStack.webFrontend.includes("astro")) {
+			nextStack.webFrontend = ["astro"];
+			if (nextStack.astroIntegration === "none") nextStack.astroIntegration = "react";
+			changed = true;
+			changes.push({
+				category: "backend",
+				message: "Frontend set to 'Astro' (required for Astro fullstack)"
+			});
+		}
+		if (nextStack.backend === "self-nuxt" && !nextStack.webFrontend.includes("nuxt")) {
+			nextStack.webFrontend = ["nuxt"];
+			changed = true;
+			changes.push({
+				category: "backend",
+				message: "Frontend set to 'Nuxt' (required for Nuxt fullstack)"
+			});
+		}
+		if (nextStack.backend === "self-svelte" && !nextStack.webFrontend.includes("svelte")) {
+			nextStack.webFrontend = ["svelte"];
+			changed = true;
+			changes.push({
+				category: "backend",
+				message: "Frontend set to 'SvelteKit' (required for SvelteKit fullstack)"
+			});
+		}
+		if (nextStack.backend === "self-solid-start" && !nextStack.webFrontend.includes("solid-start")) {
+			nextStack.webFrontend = ["solid-start"];
+			changed = true;
+			changes.push({
+				category: "backend",
+				message: "Frontend set to 'SolidStart' (required for SolidStart fullstack)"
+			});
+		}
+	}
+	if (nextStack.runtime === "workers" && nextStack.backend !== "hono") {
+		nextStack.backend = "hono";
+		changed = true;
+		changes.push({
+			category: "runtime",
+			message: "Backend set to 'Hono' (required for Workers)"
+		});
+	}
+	if (nextStack.runtime === "workers" && nextStack.serverDeploy === "none") {
+		nextStack.serverDeploy = "cloudflare";
+		changed = true;
+		changes.push({
+			category: "runtime",
+			message: "Server deploy set to 'Cloudflare' (required for Workers)"
+		});
+	}
+	if (nextStack.runtime === "workers" && nextStack.database === "mongodb") {
+		nextStack.database = "sqlite";
+		nextStack.orm = "drizzle";
+		nextStack.dbSetup = "d1";
+		changed = true;
+		changes.push({
+			category: "runtime",
+			message: "Database changed to SQLite with D1 (Better-Fullstack doesn't support MongoDB with Workers)"
+		});
+	}
+	if (nextStack.runtime === "none" && nextStack.backend !== "convex" && nextStack.backend !== "none" && nextStack.backend !== "self-next" && nextStack.backend !== "self-tanstack-start" && nextStack.backend !== "self-astro" && nextStack.backend !== "self-nuxt" && nextStack.backend !== "self-svelte" && nextStack.backend !== "self-solid-start") {
+		nextStack.runtime = DEFAULT_RUNTIME;
+		changed = true;
+		changes.push({
+			category: "runtime",
+			message: `Runtime set to '${DEFAULT_RUNTIME}' (required for this backend)`
+		});
+	}
+	if (nextStack.backend !== "convex" && nextStack.backend !== "none") {
+		if (nextStack.database === "none") {
+			if (nextStack.orm !== "none") {
+				nextStack.orm = "none";
+				changed = true;
+				changes.push({
+					category: "database",
+					message: "ORM set to 'None' (no database selected)"
+				});
+			}
+			if (nextStack.dbSetup !== "none") {
+				nextStack.dbSetup = "none";
+				changed = true;
+				changes.push({
+					category: "database",
+					message: "DB Setup set to 'None' (no database selected)"
+				});
+			}
+		}
+		if (nextStack.database === "mongodb") {
+			if (nextStack.orm !== "prisma" && nextStack.orm !== "mongoose") {
+				nextStack.orm = "prisma";
+				changed = true;
+				changes.push({
+					category: "database",
+					message: "ORM set to 'Prisma' (required for MongoDB)"
+				});
+			}
+			if (nextStack.dbSetup !== "mongodb-atlas" && nextStack.dbSetup !== "none" && nextStack.dbSetup !== "docker") {
+				nextStack.dbSetup = "none";
+				changed = true;
+				changes.push({
+					category: "database",
+					message: "DB Setup set to 'None' (incompatible with MongoDB)"
+				});
+			}
+		}
+		if ([
+			"sqlite",
+			"postgres",
+			"mysql"
+		].includes(nextStack.database)) {
+			if (nextStack.orm === "none") {
+				nextStack.orm = "drizzle";
+				changed = true;
+				changes.push({
+					category: "database",
+					message: "ORM set to 'Drizzle' (required for database)"
+				});
+			}
+			if (nextStack.orm === "mongoose") {
+				nextStack.orm = "drizzle";
+				changed = true;
+				changes.push({
+					category: "database",
+					message: "ORM set to 'Drizzle' (Mongoose only works with MongoDB)"
+				});
+			}
+		}
+		if (nextStack.orm !== "none" && nextStack.database === "none") if (nextStack.orm === "mongoose") {
+			nextStack.database = "mongodb";
+			changed = true;
+			changes.push({
+				category: "orm",
+				message: "Database set to 'MongoDB' (required for Mongoose)"
+			});
+		} else {
+			nextStack.database = "sqlite";
+			changed = true;
+			changes.push({
+				category: "orm",
+				message: "Database set to 'SQLite' (required for ORM)"
+			});
+		}
+		if (nextStack.dbSetup === "turso" && nextStack.database !== "sqlite") {
+			nextStack.database = "sqlite";
+			changed = true;
+			changes.push({
+				category: "dbSetup",
+				message: "Database set to 'SQLite' (required for Turso)"
+			});
+		}
+		if (nextStack.dbSetup === "d1") {
+			if (nextStack.database !== "sqlite") {
+				nextStack.database = "sqlite";
+				changed = true;
+				changes.push({
+					category: "dbSetup",
+					message: "Database set to 'SQLite' (required for D1)"
+				});
+			}
+			if (nextStack.runtime !== "workers") {
+				nextStack.runtime = "workers";
+				nextStack.backend = "hono";
+				changed = true;
+				changes.push({
+					category: "dbSetup",
+					message: "Runtime set to 'Workers' with 'Hono' (required for D1)"
+				});
+			}
+		}
+		if (nextStack.dbSetup === "neon" && nextStack.database !== "postgres") {
+			nextStack.database = "postgres";
+			changed = true;
+			changes.push({
+				category: "dbSetup",
+				message: "Database set to 'PostgreSQL' (required for Neon)"
+			});
+		}
+		if (nextStack.dbSetup === "supabase" && nextStack.database !== "postgres") {
+			nextStack.database = "postgres";
+			changed = true;
+			changes.push({
+				category: "dbSetup",
+				message: "Database set to 'PostgreSQL' (required for Supabase)"
+			});
+		}
+		if (nextStack.dbSetup === "prisma-postgres" && nextStack.database !== "postgres") {
+			nextStack.database = "postgres";
+			changed = true;
+			changes.push({
+				category: "dbSetup",
+				message: "Database set to 'PostgreSQL' (required for Prisma Postgres)"
+			});
+		}
+		if (nextStack.dbSetup === "mongodb-atlas" && nextStack.database !== "mongodb") {
+			nextStack.database = "mongodb";
+			if (nextStack.orm !== "prisma" && nextStack.orm !== "mongoose") nextStack.orm = "prisma";
+			changed = true;
+			changes.push({
+				category: "dbSetup",
+				message: "Database set to 'MongoDB' (required for MongoDB Atlas)"
+			});
+		}
+		if (nextStack.dbSetup === "planetscale" && nextStack.database !== "postgres" && nextStack.database !== "mysql") {
+			nextStack.database = "postgres";
+			changed = true;
+			changes.push({
+				category: "dbSetup",
+				message: "Database set to 'PostgreSQL' (required for PlanetScale)"
+			});
+		}
+		if (nextStack.dbSetup === "docker") {
+			if (nextStack.database === "sqlite") {
+				nextStack.dbSetup = "none";
+				changed = true;
+				changes.push({
+					category: "dbSetup",
+					message: "DB Setup set to 'None' (SQLite doesn't need Docker)"
+				});
+			}
+			if (nextStack.runtime === "workers") {
+				nextStack.dbSetup = "d1";
+				changed = true;
+				changes.push({
+					category: "dbSetup",
+					message: "DB Setup set to 'D1' (Better-Fullstack doesn't support Docker setup with Workers)"
+				});
+			}
+		}
+	}
+	if (nextStack.backend !== "convex" && nextStack.backend !== "none") {
+		if (nextStack.webFrontend.some((f) => [
+			"nuxt",
+			"svelte",
+			"solid",
+			"solid-start"
+		].includes(f)) && nextStack.api === "trpc") {
+			nextStack.api = "orpc";
+			changed = true;
+			changes.push({
+				category: "api",
+				message: "API set to 'oRPC' (required for this frontend)"
+			});
+		}
+		if (nextStack.webFrontend.includes("astro") && nextStack.astroIntegration !== "react" && nextStack.api === "trpc") {
+			nextStack.api = "orpc";
+			changed = true;
+			changes.push({
+				category: "api",
+				message: "API set to 'oRPC' (tRPC requires React integration with Astro)"
+			});
+		}
+	}
+	if (!nextStack.webFrontend.includes("astro") && nextStack.astroIntegration !== "none") {
+		nextStack.astroIntegration = "none";
+		changed = true;
+		changes.push({
+			category: "astroIntegration",
+			message: "Astro integration reset (Astro not selected)"
+		});
+	}
+	if (nextStack.webFrontend.includes("astro") && nextStack.astroIntegration === "none") {
+		if (nextStack.api === "trpc") {
+			nextStack.astroIntegration = "react";
+			changed = true;
+			changes.push({
+				category: "astroIntegration",
+				message: "Astro integration set to 'React' (required for tRPC)"
+			});
+		}
+	}
+	const normalizedAuth = normalizeCapabilitySelection("auth", {
+		ecosystem: nextStack.ecosystem,
+		backend: nextStack.backend,
+		webFrontend: nextStack.webFrontend,
+		nativeFrontend: nextStack.nativeFrontend
+	}, nextStack.auth);
+	if (normalizedAuth.normalized && nextStack.auth !== normalizedAuth.value) {
+		nextStack.auth = normalizedAuth.value;
+		changed = true;
+		changes.push({
+			category: "auth",
+			message: normalizedAuth.message ?? "Auth set to 'None'"
+		});
+	}
+	if (nextStack.payments === "polar") {
+		if (nextStack.auth !== "better-auth") {
+			nextStack.payments = "none";
+			changed = true;
+			changes.push({
+				category: "payments",
+				message: "Payments set to 'None' (Polar requires Better Auth)"
+			});
+		}
+		if (nextStack.backend === "convex") {
+			nextStack.payments = "none";
+			changed = true;
+			changes.push({
+				category: "payments",
+				message: "Payments set to 'None' (Polar incompatible with Convex)"
+			});
+		}
+		if (!nextStack.webFrontend.some((f) => f !== "none")) {
+			nextStack.payments = "none";
+			changed = true;
+			changes.push({
+				category: "payments",
+				message: "Payments set to 'None' (Polar requires web frontend)"
+			});
+		}
+	}
+	if (nextStack.email !== "none") {
+		if (nextStack.backend === "convex") {
+			nextStack.email = "none";
+			changed = true;
+			changes.push({
+				category: "email",
+				message: "Email set to 'None' (incompatible with Convex)"
+			});
+		}
+		if (nextStack.backend === "none") {
+			nextStack.email = "none";
+			changed = true;
+			changes.push({
+				category: "email",
+				message: "Email set to 'None' (requires backend)"
+			});
+		}
+	}
+	if (!nextStack.webFrontend.some((f) => f !== "none")) {
+		if (nextStack.cssFramework !== "none") {
+			nextStack.cssFramework = "none";
+			changed = true;
+			changes.push({
+				category: "cssFramework",
+				message: "CSS framework set to 'None' (no web frontend)"
+			});
+		}
+		if (nextStack.uiLibrary !== "none") {
+			nextStack.uiLibrary = "none";
+			changed = true;
+			changes.push({
+				category: "uiLibrary",
+				message: "UI library set to 'None' (no web frontend)"
+			});
+		}
+	}
+	if ([
+		"shadcn-ui",
+		"daisyui",
+		"nextui"
+	].includes(nextStack.uiLibrary) && nextStack.cssFramework !== "tailwind") {
+		nextStack.cssFramework = "tailwind";
+		changed = true;
+		changes.push({
+			category: "cssFramework",
+			message: `CSS framework set to 'Tailwind' (required by ${nextStack.uiLibrary})`
+		});
+	}
+	const reactOnlyLibraries = [
+		"shadcn-ui",
+		"radix-ui",
+		"chakra-ui",
+		"nextui"
+	];
+	const reactFrontends = [
+		"tanstack-router",
+		"react-router",
+		"tanstack-start",
+		"next"
+	];
+	if (reactOnlyLibraries.includes(nextStack.uiLibrary)) {
+		const hasReactFrontend = nextStack.webFrontend.some((f) => reactFrontends.includes(f));
+		const hasAstroReact = nextStack.webFrontend.includes("astro") && nextStack.astroIntegration === "react";
+		if (!hasReactFrontend && !hasAstroReact && nextStack.webFrontend.some((f) => f !== "none")) {
+			nextStack.uiLibrary = "daisyui";
+			changed = true;
+			changes.push({
+				category: "uiLibrary",
+				message: "UI library changed to 'daisyUI' (React-only library incompatible with this frontend)"
+			});
+		}
+	}
+	if (nextStack.uiLibrary === "headless-ui") {
+		const hasReactFrontend = nextStack.webFrontend.some((f) => reactFrontends.includes(f));
+		const hasVueFrontend = nextStack.webFrontend.includes("nuxt");
+		const hasAstroReactOrVue = nextStack.webFrontend.includes("astro") && ["react", "vue"].includes(nextStack.astroIntegration);
+		if (!hasReactFrontend && !hasVueFrontend && !hasAstroReactOrVue) {
+			nextStack.uiLibrary = "daisyui";
+			changed = true;
+			changes.push({
+				category: "uiLibrary",
+				message: "UI library changed to 'daisyUI' (Headless UI requires React or Vue)"
+			});
+		}
+	}
+	if (nextStack.uiLibrary === "park-ui") {
+		const hasReactFrontend = nextStack.webFrontend.some((f) => reactFrontends.includes(f));
+		const hasVueFrontend = nextStack.webFrontend.includes("nuxt");
+		const hasSolidFrontend = nextStack.webFrontend.includes("solid");
+		const hasAstroCompatible = nextStack.webFrontend.includes("astro") && [
+			"react",
+			"vue",
+			"solid"
+		].includes(nextStack.astroIntegration);
+		if (!hasReactFrontend && !hasVueFrontend && !hasSolidFrontend && !hasAstroCompatible && nextStack.webFrontend.some((f) => f !== "none")) {
+			nextStack.uiLibrary = "daisyui";
+			changed = true;
+			changes.push({
+				category: "uiLibrary",
+				message: "UI library changed to 'daisyUI' (Park UI requires React, Vue, or Solid)"
+			});
+		}
+	}
+	const pwaCompat = hasPWACompatibleFrontend(nextStack.webFrontend);
+	const tauriCompat = hasTauriCompatibleFrontend(nextStack.webFrontend);
+	if (!pwaCompat && nextStack.appPlatforms.includes("pwa")) {
+		nextStack.appPlatforms = nextStack.appPlatforms.filter((a) => a !== "pwa");
+		changed = true;
+		changes.push({
+			category: "appPlatforms",
+			message: "PWA removed (requires compatible frontend)"
+		});
+	}
+	if (!tauriCompat && nextStack.appPlatforms.includes("tauri")) {
+		nextStack.appPlatforms = nextStack.appPlatforms.filter((a) => a !== "tauri");
+		changed = true;
+		changes.push({
+			category: "appPlatforms",
+			message: "Tauri removed (requires compatible frontend)"
+		});
+	}
+	if (nextStack.examples.includes("ai")) {
+		if (nextStack.webFrontend.includes("solid") || nextStack.webFrontend.includes("solid-start")) {
+			nextStack.examples = nextStack.examples.filter((e) => e !== "ai");
+			if (nextStack.examples.length === 0) nextStack.examples = ["none"];
+			changed = true;
+			changes.push({
+				category: "examples",
+				message: "AI removed (not compatible with Solid frontend)"
+			});
+		}
+		if (nextStack.backend === "convex") {
+			if (nextStack.webFrontend.some((f) => ["svelte", "nuxt"].includes(f))) {
+				nextStack.examples = nextStack.examples.filter((e) => e !== "ai");
+				if (nextStack.examples.length === 0) nextStack.examples = ["none"];
+				changed = true;
+				changes.push({
+					category: "examples",
+					message: "AI removed (Convex AI only supports React-based frontends)"
+				});
+			}
+		}
+	}
+	if (nextStack.examples.includes("chat-sdk")) {
+		if (!isChatSdkExampleSupported(nextStack)) {
+			nextStack.examples = nextStack.examples.filter((e) => e !== "chat-sdk");
+			if (nextStack.examples.length === 0) nextStack.examples = ["none"];
+			changed = true;
+			let reason = "unsupported stack";
+			if (nextStack.ecosystem !== "typescript") reason = "TypeScript ecosystem only";
+			else if (nextStack.backend === "convex") reason = "Convex backend not supported in v1";
+			else if (nextStack.backend === "none") reason = "requires a backend";
+			else if (nextStack.backend === "hono" && nextStack.runtime !== "node") reason = "Hono profile requires Node runtime";
+			else if (nextStack.backend.startsWith("self-")) reason = "self backend only supports Next.js, TanStack Start, or Nuxt in v1";
+			changes.push({
+				category: "examples",
+				message: `Chat SDK removed (${reason})`
+			});
+		} else if (requiresChatSdkVercelAI(nextStack) && nextStack.aiSdk !== "vercel-ai") {
+			nextStack.aiSdk = "vercel-ai";
+			changed = true;
+			changes.push({
+				category: "ai",
+				message: "AI SDK set to 'Vercel AI SDK' (required by Chat SDK Nuxt/Hono profile in v1)"
+			});
+		}
+	}
+	if (nextStack.webFrontend.includes("fresh")) {
+		if (nextStack.forms === "tanstack-form") {
+			nextStack.forms = "none";
+			changed = true;
+			changes.push({
+				category: "forms",
+				message: "Forms set to 'None' (TanStack Form has no Preact adapter)"
+			});
+		}
+		if ([
+			"nanostores",
+			"xstate",
+			"tanstack-store"
+		].includes(nextStack.stateManagement)) {
+			const oldValue = nextStack.stateManagement;
+			nextStack.stateManagement = "none";
+			changed = true;
+			changes.push({
+				category: "stateManagement",
+				message: `State management set to 'None' (${oldValue} requires React bindings)`
+			});
+		}
+		if (nextStack.animation === "lottie") {
+			nextStack.animation = "none";
+			changed = true;
+			changes.push({
+				category: "animation",
+				message: "Animation set to 'None' (Lottie requires lottie-react)"
+			});
+		}
+	}
+	if (nextStack.webDeploy !== "none" && !nextStack.webFrontend.some((f) => f !== "none")) {
+		nextStack.webDeploy = "none";
+		changed = true;
+		changes.push({
+			category: "webDeploy",
+			message: "Web deploy set to 'None' (no web frontend)"
+		});
+	}
+	if (nextStack.serverDeploy === "cloudflare") {
+		if (nextStack.runtime !== "workers" || nextStack.backend !== "hono") {
+			nextStack.serverDeploy = "none";
+			changed = true;
+			changes.push({
+				category: "serverDeploy",
+				message: "Server deploy set to 'None' (Cloudflare requires Workers + Hono)"
+			});
+		}
+	}
+	if (nextStack.serverDeploy !== "none" && [
+		"none",
+		"convex",
+		"self-next",
+		"self-tanstack-start",
+		"self-astro",
+		"self-nuxt",
+		"self-svelte",
+		"self-solid-start"
+	].includes(nextStack.backend)) {
+		nextStack.serverDeploy = "none";
+		changed = true;
+		changes.push({
+			category: "serverDeploy",
+			message: "Server deploy set to 'None' (not needed for this backend)"
+		});
+	}
+	return {
+		adjustedStack: changed ? nextStack : null,
+		notes,
+		changes
+	};
+};
+/**
+* Returns a reason why an option is disabled, or null if it's enabled.
+*
+* PHILOSOPHY: Only disable options that are TRULY incompatible.
+* - Don't create circular dependencies
+* - Allow users to select options that will trigger auto-adjustments
+* - Follow CLI behavior: filter options based on UPSTREAM selections only
+*/
+const getDisabledReason = (currentStack, category, optionId) => {
+	if (currentStack.backend === "convex") {
+		if (category === "runtime" && optionId !== "none") return "Convex provides its own runtime";
+		if (category === "database" && optionId !== "none") return "Convex provides its own database";
+		if (category === "orm" && optionId !== "none") return "Convex has built-in data access";
+		if (category === "api" && optionId !== "none") return "Convex provides its own API layer";
+		if (category === "dbSetup" && optionId !== "none") return "Convex handles database setup";
+		if (category === "serverDeploy" && optionId !== "none") return "Convex has its own deployment";
+		if (category === "search" && optionId !== "none") return "Search requires a standalone backend";
+		if (category === "fileStorage" && optionId !== "none") return "File storage requires a standalone backend";
+		if (category === "webFrontend" && optionId === "solid") return "In Better-Fullstack, the Convex backend is currently not available with Solid";
+		if (category === "webFrontend" && optionId === "astro") return "In Better-Fullstack, the Convex backend is currently not available with Astro";
+		if (category === "examples" && optionId === "ai") {
+			if (currentStack.webFrontend.some((f) => [
+				"solid",
+				"svelte",
+				"nuxt"
+			].includes(f))) return `Convex AI example only supports React-based frontends (not ${currentStack.webFrontend.find((f) => [
+				"solid",
+				"svelte",
+				"nuxt"
+			].includes(f))})`;
+		}
+		if (category === "payments" && optionId === "polar") return "In Better-Fullstack, Polar is currently not available with the Convex backend";
+	}
+	if (currentStack.backend === "none") {
+		if (category === "runtime" && optionId !== "none") return "No backend selected";
+		if (category === "database" && optionId !== "none") return "No backend selected";
+		if (category === "orm" && optionId !== "none") return "No backend selected";
+		if (category === "api" && optionId !== "none") return "No backend selected";
+		if (category === "dbSetup" && optionId !== "none") return "No backend selected";
+		if (category === "serverDeploy" && optionId !== "none") return "No backend selected";
+		if (category === "payments" && optionId !== "none") return "No backend selected";
+		if (category === "search" && optionId !== "none") return "No backend selected";
+		if (category === "fileStorage" && optionId !== "none") return "No backend selected";
+		if (category === "examples" && optionId !== "none") return "No backend selected";
+	}
+	if (currentStack.backend === "self-next") {
+		if (category === "runtime" && optionId !== "none") return "Next.js fullstack uses built-in API routes";
+		if (category === "webFrontend" && optionId !== "next" && optionId !== "none") return "Next.js fullstack requires Next.js frontend";
+		if (category === "serverDeploy" && optionId !== "none") return "Fullstack uses frontend deployment";
+	}
+	if (currentStack.backend === "self-tanstack-start") {
+		if (category === "runtime" && optionId !== "none") return "TanStack Start fullstack uses built-in API routes";
+		if (category === "webFrontend" && optionId !== "tanstack-start" && optionId !== "none") return "TanStack Start fullstack requires TanStack Start frontend";
+		if (category === "serverDeploy" && optionId !== "none") return "Fullstack uses frontend deployment";
+	}
+	if (currentStack.backend === "self-astro") {
+		if (category === "runtime" && optionId !== "none") return "Astro fullstack uses built-in API routes";
+		if (category === "webFrontend" && optionId !== "astro" && optionId !== "none") return "Astro fullstack requires Astro frontend";
+		if (category === "serverDeploy" && optionId !== "none") return "Fullstack uses frontend deployment";
+	}
+	if (currentStack.backend === "self-nuxt") {
+		if (category === "runtime" && optionId !== "none") return "Nuxt fullstack uses built-in API routes";
+		if (category === "webFrontend" && optionId !== "nuxt" && optionId !== "none") return "Nuxt fullstack requires Nuxt frontend";
+		if (category === "serverDeploy" && optionId !== "none") return "Fullstack uses frontend deployment";
+	}
+	if (currentStack.backend === "self-svelte") {
+		if (category === "runtime" && optionId !== "none") return "SvelteKit fullstack uses built-in API routes";
+		if (category === "webFrontend" && optionId !== "svelte" && optionId !== "none") return "SvelteKit fullstack requires SvelteKit frontend";
+		if (category === "serverDeploy" && optionId !== "none") return "Fullstack uses frontend deployment";
+	}
+	if (currentStack.backend === "self-solid-start") {
+		if (category === "runtime" && optionId !== "none") return "SolidStart fullstack uses built-in API routes";
+		if (category === "webFrontend" && optionId !== "solid-start" && optionId !== "none") return "SolidStart fullstack requires SolidStart frontend";
+		if (category === "serverDeploy" && optionId !== "none") return "Fullstack uses frontend deployment";
+	}
+	if (category === "backend") {
+		if (optionId === "self-next" && !currentStack.webFrontend.includes("next")) return "Requires Next.js frontend";
+		if (optionId === "self-tanstack-start" && !currentStack.webFrontend.includes("tanstack-start")) return "Requires TanStack Start frontend";
+		if (optionId === "self-astro" && !currentStack.webFrontend.includes("astro")) return "Requires Astro frontend";
+		if (optionId === "self-nuxt" && !currentStack.webFrontend.includes("nuxt")) return "Requires Nuxt frontend";
+		if (optionId === "self-svelte" && !currentStack.webFrontend.includes("svelte")) return "Requires SvelteKit frontend";
+		if (optionId === "self-solid-start" && !currentStack.webFrontend.includes("solid-start")) return "Requires SolidStart frontend";
+		if (optionId === "convex" && currentStack.webFrontend.includes("solid")) return "In Better-Fullstack, Convex is currently not available with Solid";
+		if (optionId === "convex" && currentStack.webFrontend.includes("solid-start")) return "In Better-Fullstack, Convex is currently not available with SolidStart";
+		if (optionId === "convex" && currentStack.webFrontend.includes("astro")) return "In Better-Fullstack, Convex is currently not available with Astro";
+		if (currentStack.runtime === "workers" && optionId !== "hono" && optionId !== "none") return "In Better-Fullstack, Workers runtime is currently supported only with Hono";
+	}
+	if (category === "runtime") {
+		if (optionId === "workers" && currentStack.backend !== "hono") return "In Better-Fullstack, Workers runtime currently requires the Hono backend";
+		if (optionId === "none") {
+			if (![
+				"convex",
+				"none",
+				"self-next",
+				"self-tanstack-start",
+				"self-astro",
+				"self-nuxt",
+				"self-svelte",
+				"self-solid-start"
+			].includes(currentStack.backend)) return "Runtime 'None' only for Convex or fullstack backends";
+		}
+	}
+	if (category === "database") {
+		if (optionId === "mongodb" && currentStack.runtime === "workers") return "In Better-Fullstack, MongoDB is currently not available with Workers runtime";
+	}
+	if (category === "orm") {
+		if (optionId === "mongoose") {
+			if (currentStack.runtime === "workers") return "Mongoose requires MongoDB, and Better-Fullstack currently doesn't support MongoDB with Workers runtime";
+			if (currentStack.database !== "none" && currentStack.database !== "mongodb") return "Mongoose only works with MongoDB";
+		}
+		if (optionId === "drizzle" && currentStack.database === "mongodb") return "Drizzle does not support MongoDB";
+		if (optionId === "none" && currentStack.database !== "none") return "Database requires an ORM";
+	}
+	if (category === "dbSetup" && optionId !== "none") {
+		if (currentStack.database === "none") return "Select a database first";
+		if (optionId === "turso" && currentStack.database !== "sqlite") return "Turso requires SQLite";
+		if (optionId === "d1") {
+			if (currentStack.database !== "sqlite") return "D1 requires SQLite";
+			if (currentStack.runtime !== "workers") return "D1 requires Workers runtime";
+		}
+		if (optionId === "neon" && currentStack.database !== "postgres") return "Neon requires PostgreSQL";
+		if (optionId === "supabase" && currentStack.database !== "postgres") return "Supabase requires PostgreSQL";
+		if (optionId === "prisma-postgres" && currentStack.database !== "postgres") return "Prisma Postgres requires PostgreSQL";
+		if (optionId === "mongodb-atlas" && currentStack.database !== "mongodb") return "MongoDB Atlas requires MongoDB";
+		if (optionId === "planetscale" && currentStack.database !== "postgres" && currentStack.database !== "mysql") return "PlanetScale requires PostgreSQL or MySQL";
+		if (optionId === "docker") {
+			if (currentStack.database === "sqlite") return "SQLite doesn't need Docker";
+			if (currentStack.runtime === "workers") return "Docker is incompatible with Workers";
+		}
+	}
+	if (category === "api" && optionId === "trpc") {
+		if (currentStack.webFrontend.some((f) => [
+			"nuxt",
+			"svelte",
+			"solid",
+			"solid-start"
+		].includes(f))) return `${currentStack.webFrontend.find((f) => [
+			"nuxt",
+			"svelte",
+			"solid",
+			"solid-start"
+		].includes(f))} requires oRPC, not tRPC`;
+		if (currentStack.webFrontend.includes("astro") && currentStack.astroIntegration !== "react" && currentStack.astroIntegration !== "none") return `Astro with ${currentStack.astroIntegration} integration requires oRPC, not tRPC`;
+	}
+	if (category === "astroIntegration") {
+		if (!currentStack.webFrontend.includes("astro") && optionId !== "none") return "Astro integration requires Astro frontend";
+		if (currentStack.api === "trpc" && optionId !== "react" && optionId !== "none") return "tRPC requires React integration with Astro";
+	}
+	if (category === "auth") return getCapabilityDisabledReason("auth", {
+		ecosystem: currentStack.ecosystem,
+		backend: currentStack.backend,
+		webFrontend: currentStack.webFrontend,
+		nativeFrontend: currentStack.nativeFrontend
+	}, optionId);
+	if (category === "payments" && optionId === "polar") {
+		if (currentStack.auth !== "better-auth") return "Polar requires Better Auth";
+		if (!currentStack.webFrontend.some((f) => f !== "none")) return "Polar requires a web frontend";
+	}
+	if (category === "email" && optionId !== "none") {
+		if (currentStack.backend === "convex") return "Email integration is not available with Convex backend";
+		if (currentStack.backend === "none") return "Email integration requires a backend";
+	}
+	if (category === "ai" && requiresChatSdkVercelAI(currentStack) && optionId !== "vercel-ai") return "Chat SDK example (Nuxt/Hono profile) requires Vercel AI SDK in v1";
+	if (category === "appPlatforms") {
+		if (optionId === "pwa" && !hasPWACompatibleFrontend(currentStack.webFrontend)) return "PWA requires TanStack Router, React Router, Solid, Next.js, or Astro";
+		if (optionId === "tauri" && !hasTauriCompatibleFrontend(currentStack.webFrontend)) return "Tauri requires TanStack Router, React Router, Nuxt, Svelte, Solid, Next.js, or Astro";
+	}
+	if (category === "examples") {
+		if (optionId === "ai") {
+			if (currentStack.webFrontend.includes("solid") || currentStack.webFrontend.includes("solid-start")) return "AI example not compatible with Solid frontend";
+			if (currentStack.backend === "convex") {
+				if (currentStack.webFrontend.some((f) => ["svelte", "nuxt"].includes(f))) return `Convex AI example only supports React-based frontends (not ${currentStack.webFrontend.find((f) => ["svelte", "nuxt"].includes(f))})`;
+			}
+		}
+		if (optionId === "chat-sdk") {
+			if (currentStack.ecosystem !== "typescript") return "Chat SDK example is currently available only for TypeScript stacks";
+			if (currentStack.backend === "convex") return "Chat SDK example is not supported with Convex backend in v1";
+			if (currentStack.backend === "self-astro" || currentStack.backend === "self-svelte" || currentStack.backend === "self-solid-start") return "Chat SDK self backend profile supports Next.js, TanStack Start, or Nuxt in v1";
+			if (currentStack.backend === "self-next" || currentStack.backend === "self-tanstack-start") return null;
+			if (currentStack.backend === "self-nuxt") return null;
+			if (currentStack.backend === "hono") {
+				if (currentStack.runtime !== "node") return "Chat SDK Hono profile requires Node runtime in v1";
+				return null;
+			}
+			if (currentStack.backend.startsWith("self-")) return "Chat SDK self backend profile supports Next.js, TanStack Start, or Nuxt in v1";
+			if (currentStack.backend !== "none") return "Chat SDK example is only supported for self (Next/TanStack Start/Nuxt) or Hono+Node in v1";
+		}
+	}
+	const isFresh = currentStack.webFrontend.includes("fresh");
+	if (category === "forms" && optionId === "tanstack-form" && isFresh) return "TanStack Form has no Preact adapter (Fresh uses Preact)";
+	if (category === "stateManagement" && isFresh) {
+		if (optionId === "nanostores") return "Nanostores requires @nanostores/react (no Preact support)";
+		if (optionId === "xstate") return "XState requires @xstate/react (no Preact support)";
+		if (optionId === "tanstack-store") return "TanStack Store requires @tanstack/react-store (no Preact support)";
+	}
+	if (category === "animation" && optionId === "lottie" && isFresh) return "Lottie uses lottie-react which requires React (not Preact)";
+	if (category === "cssFramework") {
+		if (!currentStack.webFrontend.some((f) => f !== "none")) {
+			if (optionId !== "none") return "CSS framework requires a web frontend";
+		}
+		if ([
+			"shadcn-ui",
+			"daisyui",
+			"nextui"
+		].includes(currentStack.uiLibrary) && optionId !== "tailwind") return `${currentStack.uiLibrary === "shadcn-ui" ? "shadcn/ui" : currentStack.uiLibrary === "daisyui" ? "daisyUI" : "NextUI"} requires Tailwind CSS`;
+	}
+	if (category === "uiLibrary") {
+		if (!currentStack.webFrontend.some((f) => f !== "none")) {
+			if (optionId !== "none") return "UI library requires a web frontend";
+		}
+		const reactOnlyLibraries = [
+			"shadcn-ui",
+			"radix-ui",
+			"chakra-ui",
+			"nextui"
+		];
+		const reactFrontends = [
+			"tanstack-router",
+			"react-router",
+			"tanstack-start",
+			"next"
+		];
+		if (reactOnlyLibraries.includes(optionId)) {
+			const hasReactFrontend = currentStack.webFrontend.some((f) => reactFrontends.includes(f));
+			const hasAstroReact = currentStack.webFrontend.includes("astro") && currentStack.astroIntegration === "react";
+			if (!hasReactFrontend && !hasAstroReact) return `${optionId === "shadcn-ui" ? "shadcn/ui" : optionId === "radix-ui" ? "Radix UI" : optionId === "chakra-ui" ? "Chakra UI" : "NextUI"} requires a React-based frontend`;
+		}
+		if (optionId === "headless-ui") {
+			const hasReactFrontend = currentStack.webFrontend.some((f) => reactFrontends.includes(f));
+			const hasVueFrontend = currentStack.webFrontend.includes("nuxt");
+			const hasAstroReactOrVue = currentStack.webFrontend.includes("astro") && ["react", "vue"].includes(currentStack.astroIntegration);
+			if (!hasReactFrontend && !hasVueFrontend && !hasAstroReactOrVue) return "Headless UI requires React or Vue frontend";
+		}
+		if (optionId === "park-ui") {
+			const hasReactFrontend = currentStack.webFrontend.some((f) => reactFrontends.includes(f));
+			const hasVueFrontend = currentStack.webFrontend.includes("nuxt");
+			const hasSolidFrontend = currentStack.webFrontend.includes("solid") || currentStack.webFrontend.includes("solid-start");
+			const hasAstroCompatible = currentStack.webFrontend.includes("astro") && [
+				"react",
+				"vue",
+				"solid"
+			].includes(currentStack.astroIntegration);
+			if (!hasReactFrontend && !hasVueFrontend && !hasSolidFrontend && !hasAstroCompatible) return "Park UI requires React, Vue, or Solid frontend";
+			if (currentStack.cssFramework === "none") return "Park UI requires a CSS framework";
+		}
+		if ([
+			"shadcn-ui",
+			"daisyui",
+			"nextui"
+		].includes(optionId)) {
+			if (currentStack.cssFramework !== "tailwind") return `${optionId === "shadcn-ui" ? "shadcn/ui" : optionId === "daisyui" ? "daisyUI" : "NextUI"} requires Tailwind CSS`;
+		}
+	}
+	if (category === "webDeploy" && optionId !== "none") {
+		if (!currentStack.webFrontend.some((f) => f !== "none")) return "Web deployment requires a web frontend";
+	}
+	if (category === "serverDeploy") {
+		if (optionId === "cloudflare") {
+			if (currentStack.runtime !== "workers") return "In Better-Fullstack, Cloudflare server deploy currently requires Workers runtime";
+			if (currentStack.backend !== "hono") return "In Better-Fullstack, Cloudflare server deploy is currently supported only with Hono";
+		}
+		if (optionId !== "none") {
+			if ([
+				"none",
+				"convex",
+				"self-next",
+				"self-tanstack-start",
+				"self-astro",
+				"self-nuxt",
+				"self-svelte",
+				"self-solid-start"
+			].includes(currentStack.backend)) return "Server deployment not needed for this backend";
+		}
+		if (optionId === "none" && currentStack.runtime === "workers") return "Workers requires server deployment";
+	}
+	return null;
+};
+const isOptionCompatible = (currentStack, category, optionId) => {
+	if (currentStack.yolo === "true") return true;
+	return getDisabledReason(currentStack, category, optionId) === null;
+};
+const WEB_FRAMEWORKS = [
+	"tanstack-router",
+	"react-router",
+	"tanstack-start",
+	"next",
+	"nuxt",
+	"svelte",
+	"solid",
+	"solid-start",
+	"astro",
+	"qwik",
+	"angular",
+	"redwood",
+	"fresh",
+	"none"
+];
+const UI_LIBRARY_COMPATIBILITY = {
+	"shadcn-ui": {
+		frontends: [
+			"tanstack-router",
+			"react-router",
+			"tanstack-start",
+			"next",
+			"astro"
+		],
+		cssFrameworks: ["tailwind"]
+	},
+	daisyui: {
+		frontends: [
+			"tanstack-router",
+			"react-router",
+			"tanstack-start",
+			"next",
+			"nuxt",
+			"svelte",
+			"solid",
+			"solid-start",
+			"astro",
+			"qwik",
+			"angular",
+			"redwood",
+			"fresh"
+		],
+		cssFrameworks: ["tailwind"]
+	},
+	"radix-ui": {
+		frontends: [
+			"tanstack-router",
+			"react-router",
+			"tanstack-start",
+			"next",
+			"astro"
+		],
+		cssFrameworks: [
+			"tailwind",
+			"scss",
+			"less",
+			"postcss-only",
+			"none"
+		]
+	},
+	"headless-ui": {
+		frontends: [
+			"tanstack-router",
+			"react-router",
+			"tanstack-start",
+			"next",
+			"nuxt",
+			"astro"
+		],
+		cssFrameworks: [
+			"tailwind",
+			"scss",
+			"less",
+			"postcss-only",
+			"none"
+		]
+	},
+	"park-ui": {
+		frontends: [
+			"tanstack-router",
+			"react-router",
+			"tanstack-start",
+			"next",
+			"nuxt",
+			"solid",
+			"solid-start",
+			"astro"
+		],
+		cssFrameworks: [
+			"tailwind",
+			"scss",
+			"less",
+			"postcss-only"
+		]
+	},
+	"chakra-ui": {
+		frontends: [
+			"tanstack-router",
+			"react-router",
+			"tanstack-start",
+			"next",
+			"astro"
+		],
+		cssFrameworks: [
+			"tailwind",
+			"scss",
+			"less",
+			"postcss-only",
+			"none"
+		]
+	},
+	nextui: {
+		frontends: [
+			"tanstack-router",
+			"react-router",
+			"tanstack-start",
+			"next",
+			"astro"
+		],
+		cssFrameworks: ["tailwind"]
+	},
+	mantine: {
+		frontends: [
+			"tanstack-router",
+			"react-router",
+			"tanstack-start",
+			"next",
+			"astro"
+		],
+		cssFrameworks: [
+			"tailwind",
+			"scss",
+			"less",
+			"postcss-only",
+			"none"
+		]
+	},
+	"base-ui": {
+		frontends: [
+			"tanstack-router",
+			"react-router",
+			"tanstack-start",
+			"next",
+			"astro"
+		],
+		cssFrameworks: [
+			"tailwind",
+			"scss",
+			"less",
+			"postcss-only",
+			"none"
+		]
+	},
+	"ark-ui": {
+		frontends: [
+			"tanstack-router",
+			"react-router",
+			"tanstack-start",
+			"next",
+			"nuxt",
+			"svelte",
+			"solid",
+			"solid-start",
+			"astro"
+		],
+		cssFrameworks: [
+			"tailwind",
+			"scss",
+			"less",
+			"postcss-only",
+			"none"
+		]
+	},
+	"react-aria": {
+		frontends: [
+			"tanstack-router",
+			"react-router",
+			"tanstack-start",
+			"next",
+			"astro"
+		],
+		cssFrameworks: [
+			"tailwind",
+			"scss",
+			"less",
+			"postcss-only",
+			"none"
+		]
+	},
+	none: {
+		frontends: WEB_FRAMEWORKS,
+		cssFrameworks: [
+			"tailwind",
+			"scss",
+			"less",
+			"postcss-only",
+			"none"
+		]
+	}
+};
+const ADDON_COMPATIBILITY = {
+	pwa: [
+		"tanstack-router",
+		"react-router",
+		"solid",
+		"next",
+		"astro",
+		"qwik",
+		"angular",
+		"redwood",
+		"fresh"
+	],
+	tauri: [
+		"tanstack-router",
+		"react-router",
+		"nuxt",
+		"svelte",
+		"solid",
+		"next",
+		"astro",
+		"qwik",
+		"angular",
+		"redwood",
+		"fresh"
+	],
+	biome: [],
+	husky: [],
+	lefthook: [],
+	turborepo: [],
+	starlight: [],
+	ultracite: [],
+	ruler: [],
+	mcp: [],
+	skills: [],
+	oxlint: [],
+	fumadocs: [],
+	opentui: [],
+	wxt: [],
+	msw: [],
+	storybook: [
+		"tanstack-router",
+		"react-router",
+		"next",
+		"nuxt",
+		"svelte",
+		"solid"
+	],
+	none: []
+};
+function isWebFrontend(value) {
+	return WEB_FRAMEWORKS.includes(value);
+}
+function splitFrontends(values = []) {
+	return {
+		web: values.filter((f) => isWebFrontend(f)),
+		native: values.filter((f) => f === "native-bare" || f === "native-uniwind" || f === "native-unistyles")
+	};
+}
+function allowedApisForFrontends(frontends = [], astroIntegration) {
+	const includesNuxt = frontends.includes("nuxt");
+	const includesSvelte = frontends.includes("svelte");
+	const includesSolid = frontends.includes("solid");
+	const includesAstro = frontends.includes("astro");
+	const includesQwik = frontends.includes("qwik");
+	const includesAngular = frontends.includes("angular");
+	const includesRedwood = frontends.includes("redwood");
+	const includesFresh = frontends.includes("fresh");
+	const base = [
+		"trpc",
+		"orpc",
+		"ts-rest",
+		"garph",
+		"none"
+	];
+	if (includesQwik || includesAngular || includesRedwood || includesFresh) return ["none"];
+	const includesSolidStartApi = frontends.includes("solid-start");
+	if (includesNuxt || includesSvelte || includesSolid || includesSolidStartApi) return ["orpc", "none"];
+	if (includesAstro && astroIntegration && astroIntegration !== "react") return ["orpc", "none"];
+	return base;
+}
+function isFrontendAllowedWithBackend(frontend, backend, auth) {
+	if (backend === "convex" && frontend === "solid") return false;
+	if (backend === "convex" && frontend === "solid-start") return false;
+	if (backend === "convex" && frontend === "astro") return false;
+	if (backend === "convex" && frontend === "qwik") return false;
+	if (backend === "convex" && frontend === "angular") return false;
+	if (backend === "convex" && frontend === "redwood") return false;
+	if (backend === "convex" && frontend === "fresh") return false;
+	if (frontend === "qwik" && backend && backend !== "none") return false;
+	if (frontend === "angular" && backend && backend !== "none") return false;
+	if (frontend === "redwood" && backend && backend !== "none") return false;
+	if (frontend === "fresh" && backend && backend !== "none") return false;
+	if (auth && auth !== "none") return getCapabilityDisabledReason("auth", {
+		ecosystem: "typescript",
+		backend,
+		frontend: [frontend]
+	}, auth) === null;
+	return true;
+}
+function isExampleAIAllowed(backend, frontends = []) {
+	const includesSolid = frontends.includes("solid");
+	const includesSolidStart = frontends.includes("solid-start");
+	if (includesSolid || includesSolidStart) return false;
+	if (backend === "convex") {
+		const includesNuxt = frontends.includes("nuxt");
+		const includesSvelte = frontends.includes("svelte");
+		if (includesNuxt || includesSvelte) return false;
+	}
+	return true;
+}
+function hasExampleChatSdkSelfFrontend(frontends = []) {
+	return frontends.some((f) => [
+		"next",
+		"tanstack-start",
+		"nuxt"
+	].includes(f));
+}
+function isExampleChatSdkAllowed(backend, frontends = [], runtime) {
+	if (!backend || backend === "none" || backend === "convex") return false;
+	if (backend === "self") return hasExampleChatSdkSelfFrontend(frontends);
+	if (backend === "self-next" || backend === "self-tanstack-start" || backend === "self-nuxt") return true;
+	if (backend === "self-astro" || backend === "self-svelte" || backend === "self-solid-start") return false;
+	if (backend === "hono") return runtime === "node";
+	return false;
+}
+function requiresChatSdkVercelAIForSelection(backend, frontends = [], runtime) {
+	if (backend === "self" && frontends.includes("nuxt")) return true;
+	if (backend === "self-nuxt") return true;
+	if (backend === "hono" && runtime === "node") return true;
+	return false;
+}
+function validateAddonCompatibility(addon, frontend, _auth) {
+	const compatibleFrontends = ADDON_COMPATIBILITY[addon];
+	if (compatibleFrontends.length > 0) {
+		if (!frontend.some((f) => compatibleFrontends.includes(f))) return {
+			isCompatible: false,
+			reason: `${addon} addon requires one of these frontends: ${compatibleFrontends.join(", ")}`
+		};
+	}
+	return { isCompatible: true };
+}
+function getCompatibleAddons(allAddons, frontend, existingAddons = [], auth) {
+	return allAddons.filter((addon) => {
+		if (existingAddons.includes(addon)) return false;
+		if (addon === "none") return false;
+		const { isCompatible } = validateAddonCompatibility(addon, frontend, auth);
+		return isCompatible;
+	});
+}
+function getCompatibleUILibraries(frontends = [], astroIntegration) {
+	const { web } = splitFrontends(frontends);
+	if (web.length === 0) return ["none"];
+	const webFrontend = web[0];
+	return Object.keys(UI_LIBRARY_COMPATIBILITY).filter((lib) => {
+		if (lib === "none") return true;
+		const compatibility = UI_LIBRARY_COMPATIBILITY[lib];
+		if (webFrontend === "astro") {
+			if (astroIntegration === "react") return compatibility.frontends.some((f) => [
+				"tanstack-router",
+				"react-router",
+				"tanstack-start",
+				"next",
+				"astro"
+			].includes(f));
+			return compatibility.frontends.some((f) => [
+				"nuxt",
+				"svelte",
+				"solid",
+				"qwik",
+				"angular"
+			].includes(f));
+		}
+		return compatibility.frontends.includes(webFrontend);
+	});
+}
+function getCompatibleCSSFrameworks(uiLibrary) {
+	if (!uiLibrary || uiLibrary === "none") return [
+		"tailwind",
+		"scss",
+		"less",
+		"postcss-only",
+		"none"
+	];
+	return UI_LIBRARY_COMPATIBILITY[uiLibrary].cssFrameworks;
+}
+function hasWebStyling(frontends = []) {
+	const { web } = splitFrontends(frontends);
+	return web.length > 0;
+}
+function getCompatibleFormLibraries(frontends = []) {
+	const hasSolid = frontends.includes("solid");
+	const hasSolidStart = frontends.includes("solid-start");
+	const hasQwik = frontends.includes("qwik");
+	const hasFresh = frontends.includes("fresh");
+	const all = [
+		"tanstack-form",
+		"react-hook-form",
+		"formik",
+		"final-form",
+		"conform",
+		"modular-forms",
+		"none"
+	];
+	if (hasFresh) return all.filter((f) => f !== "tanstack-form" && f !== "react-hook-form" && f !== "formik");
+	if (hasSolid || hasSolidStart || hasQwik) return all.filter((f) => f !== "react-hook-form" && f !== "formik" && f !== "final-form");
+	return all;
+}
+function evaluateCompatibility(input) {
+	const issues = [];
+	const scalarChecks = [
+		["runtime", input.runtime],
+		["backend", input.backend],
+		["database", input.database],
+		["orm", input.orm],
+		["dbSetup", input.dbSetup],
+		["api", input.api],
+		["auth", input.auth],
+		["payments", input.payments],
+		["email", input.email],
+		["cssFramework", input.cssFramework],
+		["uiLibrary", input.uiLibrary],
+		["webDeploy", input.webDeploy],
+		["serverDeploy", input.serverDeploy],
+		["forms", input.forms],
+		["stateManagement", input.stateManagement],
+		["animation", input.animation],
+		["ai", input.aiSdk]
+	];
+	for (const [category, optionId] of scalarChecks) {
+		const reason = getDisabledReason(input, category, optionId);
+		if (reason) issues.push({
+			code: `INCOMPATIBLE_${category.toUpperCase()}`,
+			message: reason,
+			category,
+			optionId
+		});
+	}
+	for (const frontend of input.webFrontend) {
+		const reason = getDisabledReason(input, "webFrontend", frontend);
+		if (reason) issues.push({
+			code: "INCOMPATIBLE_FRONTEND",
+			message: reason,
+			category: "webFrontend",
+			optionId: frontend
+		});
+	}
+	for (const addon of [
+		...input.codeQuality,
+		...input.documentation,
+		...input.appPlatforms
+	]) {
+		const reason = getDisabledReason(input, "appPlatforms", addon);
+		if (reason) issues.push({
+			code: "INCOMPATIBLE_ADDON",
+			message: reason,
+			category: "appPlatforms",
+			optionId: addon
+		});
+	}
+	return { issues };
+}
+
+//#endregion
+//#region src/option-metadata.ts
+const WEB_FRONTEND_VALUES = [
+	"tanstack-router",
+	"react-router",
+	"tanstack-start",
+	"next",
+	"nuxt",
+	"svelte",
+	"solid",
+	"solid-start",
+	"astro",
+	"qwik",
+	"angular",
+	"redwood",
+	"fresh",
+	"none"
+];
+const NATIVE_FRONTEND_VALUES = [
+	"native-bare",
+	"native-uniwind",
+	"native-unistyles",
+	"none"
+];
+const BACKEND_BUILDER_VALUES = [
+	"hono",
+	"express",
+	"fastify",
+	"elysia",
+	"fets",
+	"nestjs",
+	"adonisjs",
+	"nitro",
+	"encore",
+	"convex",
+	"self-next",
+	"self-tanstack-start",
+	"self-astro",
+	"self-nuxt",
+	"self-svelte",
+	"self-solid-start",
+	"none"
+];
+const CODE_QUALITY_VALUES = [
+	"biome",
+	"oxlint",
+	"ultracite",
+	"lefthook",
+	"husky",
+	"ruler"
+];
+const DOCUMENTATION_VALUES = ["starlight", "fumadocs"];
+const APP_PLATFORM_VALUES = [
+	"turborepo",
+	"pwa",
+	"tauri",
+	"wxt",
+	"opentui",
+	"mcp",
+	"skills",
+	"msw",
+	"storybook"
+];
+const EXAMPLE_VALUES = ["ai", "chat-sdk"];
+const BOOLEAN_OPTION_VALUES = ["true", "false"];
+const MULTI_SELECT_CATEGORIES = new Set([
+	"webFrontend",
+	"nativeFrontend",
+	"codeQuality",
+	"documentation",
+	"appPlatforms",
+	"examples",
+	"aiDocs"
+]);
+const CATEGORY_VALUE_IDS = {
+	api: API_VALUES,
+	webFrontend: WEB_FRONTEND_VALUES,
+	nativeFrontend: NATIVE_FRONTEND_VALUES,
+	astroIntegration: ASTRO_INTEGRATION_VALUES,
+	runtime: RUNTIME_VALUES,
+	backend: BACKEND_BUILDER_VALUES,
+	database: DATABASE_VALUES,
+	orm: ORM_VALUES,
+	dbSetup: DATABASE_SETUP_VALUES,
+	webDeploy: WEB_DEPLOY_VALUES,
+	serverDeploy: SERVER_DEPLOY_VALUES,
+	auth: AUTH_VALUES,
+	payments: PAYMENTS_VALUES,
+	email: EMAIL_VALUES,
+	fileUpload: FILE_UPLOAD_VALUES,
+	logging: LOGGING_VALUES,
+	observability: OBSERVABILITY_VALUES,
+	backendLibraries: EFFECT_VALUES,
+	stateManagement: STATE_MANAGEMENT_VALUES,
+	forms: FORMS_VALUES,
+	validation: VALIDATION_VALUES,
+	testing: TESTING_VALUES,
+	realtime: REALTIME_VALUES,
+	jobQueue: JOB_QUEUE_VALUES,
+	caching: CACHING_VALUES,
+	search: SEARCH_VALUES,
+	fileStorage: FILE_STORAGE_VALUES,
+	animation: ANIMATION_VALUES,
+	cssFramework: CSS_FRAMEWORK_VALUES,
+	uiLibrary: UI_LIBRARY_VALUES,
+	cms: CMS_VALUES,
+	featureFlags: FEATURE_FLAGS_VALUES,
+	analytics: ANALYTICS_VALUES,
+	codeQuality: CODE_QUALITY_VALUES,
+	documentation: DOCUMENTATION_VALUES,
+	appPlatforms: APP_PLATFORM_VALUES,
+	packageManager: PACKAGE_MANAGER_VALUES,
+	examples: EXAMPLE_VALUES,
+	ai: AI_VALUES,
+	aiDocs: AI_DOCS_VALUES,
+	git: BOOLEAN_OPTION_VALUES,
+	install: BOOLEAN_OPTION_VALUES,
+	effect: EFFECT_VALUES,
+	shadcnBase: SHADCN_BASE_VALUES,
+	shadcnStyle: SHADCN_STYLE_VALUES,
+	shadcnIconLibrary: SHADCN_ICON_LIBRARY_VALUES,
+	shadcnColorTheme: SHADCN_COLOR_THEME_VALUES,
+	shadcnBaseColor: SHADCN_BASE_COLOR_VALUES,
+	shadcnFont: SHADCN_FONT_VALUES,
+	shadcnRadius: SHADCN_RADIUS_VALUES,
+	rustWebFramework: RUST_WEB_FRAMEWORK_VALUES,
+	rustFrontend: RUST_FRONTEND_VALUES,
+	rustOrm: RUST_ORM_VALUES,
+	rustApi: RUST_API_VALUES,
+	rustCli: RUST_CLI_VALUES,
+	rustLibraries: RUST_LIBRARIES_VALUES,
+	pythonWebFramework: PYTHON_WEB_FRAMEWORK_VALUES,
+	pythonOrm: PYTHON_ORM_VALUES,
+	pythonValidation: PYTHON_VALIDATION_VALUES,
+	pythonAi: PYTHON_AI_VALUES,
+	pythonTaskQueue: PYTHON_TASK_QUEUE_VALUES,
+	pythonQuality: PYTHON_QUALITY_VALUES,
+	goWebFramework: GO_WEB_FRAMEWORK_VALUES,
+	goOrm: GO_ORM_VALUES,
+	goApi: GO_API_VALUES,
+	goCli: GO_CLI_VALUES,
+	goLogging: GO_LOGGING_VALUES
+};
+const EXACT_LABEL_OVERRIDES = {
+	api: {
+		trpc: "tRPC",
+		orpc: "oRPC"
+	},
+	webFrontend: {
+		next: "Next.js",
+		svelte: "SvelteKit",
+		redwood: "RedwoodJS"
+	},
+	nativeFrontend: {
+		"native-bare": "Expo + Bare",
+		"native-uniwind": "Expo + Uniwind",
+		"native-unistyles": "Expo + Unistyles"
+	},
+	runtime: {
+		node: "Node.js",
+		workers: "Cloudflare Workers"
+	},
+	backend: {
+		fets: "feTS",
+		nestjs: "NestJS",
+		encore: "Encore.ts",
+		"self-next": "Fullstack Next.js",
+		"self-tanstack-start": "Fullstack TanStack Start",
+		"self-astro": "Fullstack Astro",
+		"self-nuxt": "Fullstack Nuxt",
+		"self-svelte": "Fullstack SvelteKit",
+		"self-solid-start": "Fullstack SolidStart"
+	},
+	database: {
+		sqlite: "SQLite",
+		postgres: "PostgreSQL",
+		mongodb: "MongoDB",
+		edgedb: "EdgeDB"
+	},
+	orm: {
+		typeorm: "TypeORM",
+		mikroorm: "MikroORM"
+	},
+	dbSetup: {
+		d1: "Cloudflare D1",
+		neon: "Neon Postgres",
+		"prisma-postgres": "Prisma PostgreSQL",
+		"mongodb-atlas": "MongoDB Atlas",
+		planetscale: "PlanetScale"
+	},
+	webDeploy: {
+		cloudflare: "Cloudflare",
+		fly: "Fly.io",
+		sst: "SST"
+	},
+	serverDeploy: {
+		cloudflare: "Cloudflare",
+		fly: "Fly.io",
+		sst: "SST"
+	},
+	auth: {},
+	payments: {
+		"lemon-squeezy": "Lemon Squeezy",
+		dodo: "Dodo Payments"
+	},
+	email: {
+		"react-email": "React Email",
+		sendgrid: "SendGrid",
+		"aws-ses": "AWS SES"
+	},
+	fileUpload: {
+		uploadthing: "UploadThing",
+		filepond: "FilePond",
+		uppy: "Uppy"
+	},
+	observability: { opentelemetry: "OpenTelemetry" },
+	backendLibraries: {
+		effect: "Effect (Core)",
+		"effect-full": "Effect Full"
+	},
+	stateManagement: {
+		"redux-toolkit": "Redux Toolkit",
+		xstate: "XState"
+	},
+	forms: {
+		"react-hook-form": "React Hook Form",
+		"tanstack-form": "TanStack Form",
+		"final-form": "Final Form",
+		"modular-forms": "Modular Forms"
+	},
+	validation: {
+		zod: "Zod",
+		arktype: "ArkType",
+		typebox: "TypeBox",
+		"effect-schema": "@effect/schema"
+	},
+	testing: { "vitest-playwright": "Vitest + Playwright" },
+	realtime: {
+		"socket-io": "Socket.IO",
+		yjs: "Y.js"
+	},
+	jobQueue: {
+		bullmq: "BullMQ",
+		"trigger-dev": "Trigger.dev"
+	},
+	cssFramework: {
+		tailwind: "Tailwind CSS",
+		scss: "SCSS",
+		"postcss-only": "PostCSS Only"
+	},
+	uiLibrary: {
+		"shadcn-ui": "shadcn/ui",
+		daisyui: "daisyUI",
+		"radix-ui": "Radix UI",
+		"headless-ui": "Headless UI",
+		"park-ui": "Park UI",
+		"chakra-ui": "Chakra UI",
+		nextui: "NextUI",
+		"base-ui": "Base UI",
+		"ark-ui": "Ark UI",
+		"react-aria": "React Aria"
+	},
+	featureFlags: {
+		growthbook: "GrowthBook",
+		posthog: "PostHog"
+	},
+	analytics: {
+		plausible: "Plausible",
+		umami: "Umami"
+	},
+	codeQuality: {
+		biome: "Biome",
+		oxlint: "Oxlint",
+		ultracite: "Ultracite",
+		lefthook: "Lefthook",
+		husky: "Husky",
+		ruler: "Ruler"
+	},
+	documentation: {
+		starlight: "Starlight",
+		fumadocs: "Fumadocs"
+	},
+	appPlatforms: {
+		pwa: "PWA",
+		wxt: "WXT",
+		opentui: "OpenTUI",
+		mcp: "MCP",
+		msw: "MSW"
+	},
+	examples: {
+		ai: "AI Example",
+		"chat-sdk": "Chat SDK Bots"
+	},
+	ai: {
+		"vercel-ai": "Vercel AI SDK",
+		voltagent: "VoltAgent",
+		langgraph: "LangGraph.js",
+		"openai-agents": "OpenAI Agents SDK",
+		"google-adk": "Google ADK",
+		modelfusion: "ModelFusion",
+		langchain: "LangChain",
+		llamaindex: "LlamaIndex"
+	},
+	aiDocs: {
+		"claude-md": "CLAUDE.md",
+		"agents-md": "Agents.md",
+		cursorrules: ".cursorrules"
+	},
+	git: {
+		true: "Git",
+		false: "No Git"
+	},
+	install: {
+		true: "Install Dependencies",
+		false: "Skip Install"
+	},
+	effect: {
+		effect: "Effect (Core)",
+		"effect-full": "Effect Full"
+	},
+	shadcnBase: {
+		radix: "Radix UI",
+		base: "Base UI"
+	},
+	shadcnStyle: {
+		vega: "Vega",
+		nova: "Nova",
+		maia: "Maia",
+		lyra: "Lyra",
+		mira: "Mira"
+	},
+	shadcnIconLibrary: {
+		lucide: "Lucide",
+		tabler: "Tabler Icons",
+		hugeicons: "HugeIcons",
+		phosphor: "Phosphor Icons",
+		remixicon: "Remix Icon"
+	},
+	shadcnColorTheme: { neutral: "Neutral" },
+	shadcnBaseColor: { neutral: "Neutral" },
+	shadcnFont: {
+		inter: "Inter",
+		geist: "Geist",
+		figtree: "Figtree",
+		"noto-sans": "Noto Sans",
+		"nunito-sans": "Nunito Sans",
+		roboto: "Roboto",
+		raleway: "Raleway",
+		"dm-sans": "DM Sans",
+		"public-sans": "Public Sans",
+		outfit: "Outfit",
+		"jetbrains-mono": "JetBrains Mono",
+		"geist-mono": "Geist Mono"
+	},
+	shadcnRadius: { default: "Default" },
+	rustWebFramework: {
+		axum: "Axum",
+		"actix-web": "Actix-web"
+	},
+	rustFrontend: {
+		leptos: "Leptos",
+		dioxus: "Dioxus"
+	},
+	rustOrm: {
+		"sea-orm": "SeaORM",
+		sqlx: "SQLx"
+	},
+	rustApi: {
+		"async-graphql": "async-graphql",
+		tonic: "Tonic"
+	},
+	rustCli: {
+		clap: "Clap",
+		ratatui: "Ratatui"
+	},
+	rustLibraries: {
+		serde: "Serde",
+		validator: "Validator",
+		jsonwebtoken: "jsonwebtoken",
+		argon2: "Argon2",
+		"tokio-test": "Tokio Test",
+		mockall: "Mockall"
+	},
+	pythonWebFramework: {
+		fastapi: "FastAPI",
+		django: "Django"
+	},
+	pythonOrm: {
+		sqlalchemy: "SQLAlchemy",
+		sqlmodel: "SQLModel"
+	},
+	pythonValidation: { pydantic: "Pydantic" },
+	pythonAi: {
+		langchain: "LangChain",
+		llamaindex: "LlamaIndex",
+		"openai-sdk": "OpenAI SDK",
+		"anthropic-sdk": "Anthropic SDK",
+		langgraph: "LangGraph",
+		crewai: "CrewAI"
+	},
+	pythonTaskQueue: { celery: "Celery" },
+	pythonQuality: { ruff: "Ruff" },
+	goWebFramework: {
+		gin: "Gin",
+		echo: "Echo"
+	},
+	goOrm: {
+		gorm: "GORM",
+		sqlc: "sqlc"
+	},
+	goApi: { "grpc-go": "gRPC-Go" },
+	goCli: {
+		cobra: "Cobra",
+		bubbletea: "Bubble Tea"
+	},
+	goLogging: { zap: "Zap" }
+};
+const OPTION_ALIASES = {
+	webFrontend: { svelte: ["sveltekit"] },
+	backend: { "self-svelte": ["self-sveltekit"] }
+};
+const CLI_VALUE_OVERRIDES = { backend: {
+	"self-next": "self",
+	"self-tanstack-start": "self",
+	"self-astro": "self",
+	"self-nuxt": "self",
+	"self-svelte": "self",
+	"self-solid-start": "self"
+} };
+const TOKEN_LABELS = {
+	ai: "AI",
+	api: "API",
+	auth: "Auth",
+	css: "CSS",
+	db: "DB",
+	graphql: "GraphQL",
+	grpc: "gRPC",
+	js: "JS",
+	md: "MD",
+	orm: "ORM",
+	sdk: "SDK",
+	ses: "SES",
+	sql: "SQL",
+	ui: "UI"
+};
+function toStartCaseToken(token) {
+	const lower = token.toLowerCase();
+	if (TOKEN_LABELS[lower]) return TOKEN_LABELS[lower];
+	return lower.charAt(0).toUpperCase() + lower.slice(1);
+}
+function humanizeOptionId(id) {
+	return id.split("-").filter(Boolean).map(toStartCaseToken).join(" ");
+}
+function getOptionLabel(category, id) {
+	if (category === "auth") return getCapabilityDefinitions("auth").find((option) => option.id === id)?.label ?? humanizeOptionId(id);
+	return EXACT_LABEL_OVERRIDES[category]?.[id] ?? humanizeOptionId(id);
+}
+function getOptionAliases(category, id) {
+	return OPTION_ALIASES[category]?.[id] ?? [];
+}
+function getCliValue(category, id) {
+	return CLI_VALUE_OVERRIDES[category]?.[id] ?? id;
+}
+function buildCategoryMetadata(category) {
+	return {
+		selectionMode: MULTI_SELECT_CATEGORIES.has(category) ? "multiple" : "single",
+		options: CATEGORY_VALUE_IDS[category].map((id) => ({
+			id,
+			label: getOptionLabel(category, id),
+			aliases: getOptionAliases(category, id),
+			cliValue: getCliValue(category, id)
+		}))
+	};
+}
+const OPTION_CATEGORY_METADATA = {
+	api: buildCategoryMetadata("api"),
+	webFrontend: buildCategoryMetadata("webFrontend"),
+	nativeFrontend: buildCategoryMetadata("nativeFrontend"),
+	astroIntegration: buildCategoryMetadata("astroIntegration"),
+	runtime: buildCategoryMetadata("runtime"),
+	backend: buildCategoryMetadata("backend"),
+	database: buildCategoryMetadata("database"),
+	orm: buildCategoryMetadata("orm"),
+	dbSetup: buildCategoryMetadata("dbSetup"),
+	webDeploy: buildCategoryMetadata("webDeploy"),
+	serverDeploy: buildCategoryMetadata("serverDeploy"),
+	auth: buildCategoryMetadata("auth"),
+	payments: buildCategoryMetadata("payments"),
+	email: buildCategoryMetadata("email"),
+	fileUpload: buildCategoryMetadata("fileUpload"),
+	logging: buildCategoryMetadata("logging"),
+	observability: buildCategoryMetadata("observability"),
+	backendLibraries: buildCategoryMetadata("backendLibraries"),
+	stateManagement: buildCategoryMetadata("stateManagement"),
+	forms: buildCategoryMetadata("forms"),
+	validation: buildCategoryMetadata("validation"),
+	testing: buildCategoryMetadata("testing"),
+	realtime: buildCategoryMetadata("realtime"),
+	jobQueue: buildCategoryMetadata("jobQueue"),
+	caching: buildCategoryMetadata("caching"),
+	search: buildCategoryMetadata("search"),
+	fileStorage: buildCategoryMetadata("fileStorage"),
+	animation: buildCategoryMetadata("animation"),
+	cssFramework: buildCategoryMetadata("cssFramework"),
+	uiLibrary: buildCategoryMetadata("uiLibrary"),
+	cms: buildCategoryMetadata("cms"),
+	featureFlags: buildCategoryMetadata("featureFlags"),
+	analytics: buildCategoryMetadata("analytics"),
+	codeQuality: buildCategoryMetadata("codeQuality"),
+	documentation: buildCategoryMetadata("documentation"),
+	appPlatforms: buildCategoryMetadata("appPlatforms"),
+	packageManager: buildCategoryMetadata("packageManager"),
+	examples: buildCategoryMetadata("examples"),
+	ai: buildCategoryMetadata("ai"),
+	aiDocs: buildCategoryMetadata("aiDocs"),
+	git: buildCategoryMetadata("git"),
+	install: buildCategoryMetadata("install"),
+	effect: buildCategoryMetadata("effect"),
+	shadcnBase: buildCategoryMetadata("shadcnBase"),
+	shadcnStyle: buildCategoryMetadata("shadcnStyle"),
+	shadcnIconLibrary: buildCategoryMetadata("shadcnIconLibrary"),
+	shadcnColorTheme: buildCategoryMetadata("shadcnColorTheme"),
+	shadcnBaseColor: buildCategoryMetadata("shadcnBaseColor"),
+	shadcnFont: buildCategoryMetadata("shadcnFont"),
+	shadcnRadius: buildCategoryMetadata("shadcnRadius"),
+	rustWebFramework: buildCategoryMetadata("rustWebFramework"),
+	rustFrontend: buildCategoryMetadata("rustFrontend"),
+	rustOrm: buildCategoryMetadata("rustOrm"),
+	rustApi: buildCategoryMetadata("rustApi"),
+	rustCli: buildCategoryMetadata("rustCli"),
+	rustLibraries: buildCategoryMetadata("rustLibraries"),
+	pythonWebFramework: buildCategoryMetadata("pythonWebFramework"),
+	pythonOrm: buildCategoryMetadata("pythonOrm"),
+	pythonValidation: buildCategoryMetadata("pythonValidation"),
+	pythonAi: buildCategoryMetadata("pythonAi"),
+	pythonTaskQueue: buildCategoryMetadata("pythonTaskQueue"),
+	pythonQuality: buildCategoryMetadata("pythonQuality"),
+	goWebFramework: buildCategoryMetadata("goWebFramework"),
+	goOrm: buildCategoryMetadata("goOrm"),
+	goApi: buildCategoryMetadata("goApi"),
+	goCli: buildCategoryMetadata("goCli"),
+	goLogging: buildCategoryMetadata("goLogging")
+};
+const OPTION_LOOKUP = Object.fromEntries(Object.entries(OPTION_CATEGORY_METADATA).map(([category, metadata]) => [category, new Map(metadata.options.flatMap((option) => [[option.id.toLowerCase(), option.id], ...option.aliases.map((alias) => [alias.toLowerCase(), option.id])]))]));
+function isMultiSelectCategory(category) {
+	return OPTION_CATEGORY_METADATA[category].selectionMode === "multiple";
+}
+function getOptionMetadata(category, optionId) {
+	return OPTION_CATEGORY_METADATA[category].options.find((option) => option.id === optionId);
+}
+function getCategoryOptionIds(category) {
+	return OPTION_CATEGORY_METADATA[category].options.map((option) => option.id);
+}
+function getCategoryCliValues(category) {
+	return [...new Set(OPTION_CATEGORY_METADATA[category].options.map((option) => option.cliValue))];
+}
+function normalizeOptionId(category, value) {
+	return OPTION_LOOKUP[category].get(value.toLowerCase()) ?? value;
+}
+
+//#endregion
+//#region src/local-dev.ts
+const VITE_WEB_FRONTENDS = new Set([
+	"react-router",
+	"svelte",
+	"fresh"
+]);
+function getLocalWebDevPort(frontend) {
+	return frontend.some((entry) => VITE_WEB_FRONTENDS.has(entry)) ? 5173 : 3001;
+}
+
+//#endregion
+export { ADDONS_VALUES, AISchema, AI_DOCS_VALUES, AI_VALUES, ANALYTICS_VALUES, ANIMATION_VALUES, APISchema, API_VALUES, ASTRO_INTEGRATION_VALUES, AUTH_VALUES, AddInputSchema, AddonsSchema, AiDocsSchema, AnalyticsSchema, AnimationSchema, AstroIntegrationSchema, AuthSchema, BACKEND_VALUES, BackendSchema, BetterTStackConfigFileSchema, BetterTStackConfigSchema, CACHING_VALUES, CLIInputSchema, CMSSchema, CMS_VALUES, CSSFrameworkSchema, CSS_FRAMEWORK_VALUES, CachingSchema, CreateInputSchema, DATABASE_SETUP_VALUES, DATABASE_VALUES, DIRECTORY_CONFLICT_VALUES, DatabaseSchema, DatabaseSetupSchema, DirectoryConflictSchema, ECOSYSTEM_VALUES, EFFECT_VALUES, EMAIL_VALUES, EXAMPLES_VALUES, EcosystemSchema, EffectSchema, EmailSchema, ExamplesSchema, FEATURE_FLAGS_VALUES, FILE_STORAGE_VALUES, FILE_UPLOAD_VALUES, FORMS_VALUES, FRONTEND_VALUES, FeatureFlagsSchema, FileStorageSchema, FileUploadSchema, FormsSchema, FrontendSchema, GO_API_VALUES, GO_CLI_VALUES, GO_LOGGING_VALUES, GO_ORM_VALUES, GO_WEB_FRAMEWORK_VALUES, GoApiSchema, GoCliSchema, GoLoggingSchema, GoOrmSchema, GoWebFrameworkSchema, InitResultSchema, JOB_QUEUE_VALUES, JobQueueSchema, LOGGING_VALUES, LoggingSchema, OBSERVABILITY_VALUES, OPTION_CATEGORY_METADATA, ORMSchema, ORM_VALUES, ObservabilitySchema, PACKAGE_MANAGER_VALUES, PAYMENTS_VALUES, PYTHON_AI_VALUES, PYTHON_ORM_VALUES, PYTHON_QUALITY_VALUES, PYTHON_TASK_QUEUE_VALUES, PYTHON_VALIDATION_VALUES, PYTHON_WEB_FRAMEWORK_VALUES, PackageManagerSchema, PaymentsSchema, ProjectConfigSchema, ProjectNameSchema, PythonAiSchema, PythonOrmSchema, PythonQualitySchema, PythonTaskQueueSchema, PythonValidationSchema, PythonWebFrameworkSchema, REALTIME_VALUES, RUNTIME_VALUES, RUST_API_VALUES, RUST_CLI_VALUES, RUST_FRONTEND_VALUES, RUST_LIBRARIES_VALUES, RUST_ORM_VALUES, RUST_WEB_FRAMEWORK_VALUES, RealtimeSchema, RuntimeSchema, RustApiSchema, RustCliSchema, RustFrontendSchema, RustLibrariesSchema, RustOrmSchema, RustWebFrameworkSchema, SEARCH_VALUES, SERVER_DEPLOY_VALUES, SHADCN_BASE_COLOR_VALUES, SHADCN_BASE_VALUES, SHADCN_COLOR_THEME_VALUES, SHADCN_FONT_VALUES, SHADCN_ICON_LIBRARY_VALUES, SHADCN_RADIUS_VALUES, SHADCN_STYLE_VALUES, STATE_MANAGEMENT_VALUES, SearchSchema, ServerDeploySchema, ShadcnBaseColorSchema, ShadcnBaseSchema, ShadcnColorThemeSchema, ShadcnFontSchema, ShadcnIconLibrarySchema, ShadcnRadiusSchema, ShadcnStyleSchema, StateManagementSchema, TEMPLATE_VALUES, TESTING_VALUES, TemplateSchema, TestingSchema, UILibrarySchema, UI_LIBRARY_VALUES, VALIDATION_VALUES, ValidationSchema, WEB_DEPLOY_VALUES, WebDeploySchema, allowedApisForFrontends, analyzeStackCompatibility, evaluateCompatibility, getCapabilityDefinitions, getCapabilityDisabledReason, getCategoryCliValues, getCategoryDisplayName, getCategoryOptionIds, getCompatibleAddons, getCompatibleCSSFrameworks, getCompatibleFormLibraries, getCompatibleUILibraries, getDisabledReason, getLocalWebDevPort, getOptionMetadata, getSupportedCapabilityOptions, hasPWACompatibleFrontend, hasTauriCompatibleFrontend, hasWebStyling, isExampleAIAllowed, isExampleChatSdkAllowed, isFrontendAllowedWithBackend, isMultiSelectCategory, isOptionCompatible, isWebFrontend, normalizeCapabilitySelection, normalizeOptionId, requiresChatSdkVercelAI, requiresChatSdkVercelAIForSelection, splitFrontends, validateAddonCompatibility, validateProjectName };
+//# sourceMappingURL=index.mjs.map