@azure-net/cli 5.0.0 → 5.1.0

package/bin/azure-net.js

@@ -179,6 +179,13 @@ generateCommand
 		const handler = (await import('../src/generate/module/generateModulePreset.js')).default;
 		await handler();
 	});
+generateCommand
+	.command('routes')
+	.description('Generate typed SvelteKit routes list')
+	.action(async () => {
+		const handler = (await import('../src/generate/routes/generateRoutes.js')).default;
+		await handler();
+	});
 checkCommand
 	.command('presenter-names')
 	.description('Check duplicate presenter names in src')

package/bin/azure-net.ts

@@ -209,6 +209,14 @@ generateCommand
 		await handler();
 	});
 
+generateCommand
+	.command('routes')
+	.description('Generate typed SvelteKit routes list')
+	.action(async () => {
+		const handler = (await import('../src/generate/routes/generateRoutes.js')).default;
+		await handler();
+	});
+
 checkCommand
 	.command('presenter-names')
 	.description('Check duplicate presenter names in src')

package/package.json

@@ -1,12 +1,18 @@
 {
   "name": "@azure-net/cli",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "type": "module",
   "bin": {
     "azure-net": "bin/azure-net.js"
   },
+  "license": "MIT",
+  "author": "Pixel1917",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "peerDependencies": {
-    "@azure-net/kit": "^4.0.0"
+    "@azure-net/kit": ">=5.0.0-4"
   },
   "dependencies": {
     "commander": "^11",
@@ -16,6 +22,7 @@
     "@eslint/js": "^9.31.0",
     "@types/node": "^24.0.3",
     "@types/prompts": "^2.4.9",
+    "env-cmd": "^11.0.0",
     "eslint": "^9.31.0",
     "prettier": "^3.6.2",
     "typescript": "^5",

package/src/generate/module/generatePresenter.js

@@ -119,6 +119,7 @@ const normalizePresenterName = (rawName, fallbackUseCasesName) => {
 const isPrimitive = (typeName) => PRIMITIVE_TYPES.has(String(typeName ?? '').trim());
 const normalizeTypeImports = (types) => Array.from(new Set(types.filter((typeName) => !isPrimitive(typeName))));
 const isPathParamName = (name) => name === 'pathParam' || name === 'path';
+const toTypeFileName = (typeName) => String(typeName ?? '').replace(/^I/, '') || 'Type';
 const buildMethodInvocation = (method, useCasesName, schemaByMethod) => {
 	const paramsSignature = method.params.map((item) => `${item.name}: ${item.type}`).join(', ');
 	const argNames = method.params.map((item) => item.name);
@@ -153,6 +154,34 @@ const getApplicationProviderFile = async (contextName) => {
 		return candidate ? path.join(providersPath, candidate) : null;
 	}
 };
+const resolveDomainInterfaceFile = async ({ contextName, domainName, interfaceName }) => {
+	const portsPath = path.join(process.cwd(), 'src', 'app', contextName, 'layers', 'domain', domainName, 'ports');
+	const preferredPath = path.join(portsPath, `${toTypeFileName(interfaceName)}.ts`);
+	const legacyPath = path.join(portsPath, `${interfaceName}.ts`);
+	for (const candidate of [preferredPath, legacyPath]) {
+		try {
+			await fs.access(candidate);
+			return candidate;
+		} catch {
+			// Try the next candidate.
+		}
+	}
+	try {
+		const files = await fs.readdir(portsPath);
+		for (const fileName of files) {
+			if (!fileName.endsWith('.ts') || fileName === 'index.ts') continue;
+			const candidate = path.join(portsPath, fileName);
+			const content = await fs.readFile(candidate, 'utf-8');
+			const escapedName = interfaceName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+			if (new RegExp(`export\\s+interface\\s+${escapedName}\\b`).test(content)) {
+				return candidate;
+			}
+		}
+	} catch {
+		return null;
+	}
+	return null;
+};
 export default async function generatePresenter(options = {}) {
 	let contextName = options.contextName ? String(options.contextName) : null;
 	if (!contextName) {
@@ -216,17 +245,18 @@ export default async function generatePresenter(options = {}) {
 		return;
 	}
 	const repositoryHttpMethods = parseRepositoryHttpMethods(repositoryInfo.content);
-	const domainPortsInterfacePath = path.join(
-		process.cwd(),
-		'src',
-		'app',
+	const domainPortsInterfacePath = await resolveDomainInterfaceFile({
 		contextName,
-		'layers',
-		'domain',
-		useCasesInfo.domainName,
-		'ports',
-		`${useCasesInfo.repositoryInterfaceName}.ts`
-	);
+		domainName: useCasesInfo.domainName,
+		interfaceName: useCasesInfo.repositoryInterfaceName
+	});
+	if (!domainPortsInterfacePath) {
+		console.error(
+			`❌ Repository interface "${useCasesInfo.repositoryInterfaceName}" was not found in ${path.join(process.cwd(), 'src', 'app', contextName, 'layers', 'domain', useCasesInfo.domainName, 'ports')}`
+		);
+		process.exitCode = 1;
+		return;
+	}
 	const repositoryInterfaceContent = await fs.readFile(domainPortsInterfacePath, 'utf-8');
 	const repositoryMethods = parseRepositoryInterfaceMethods(repositoryInterfaceContent).filter((method) =>
 		useCasesInfo.methods.includes(method.name)

package/src/generate/module/generatePresenter.ts

@@ -142,6 +142,7 @@ const isPrimitive = (typeName: string): boolean => PRIMITIVE_TYPES.has(String(ty
 
 const normalizeTypeImports = (types: string[]): string[] => Array.from(new Set(types.filter((typeName) => !isPrimitive(typeName))));
 const isPathParamName = (name: string): boolean => name === 'pathParam' || name === 'path';
+const toTypeFileName = (typeName: string): string => String(typeName ?? '').replace(/^I/, '') || 'Type';
 
 const buildMethodInvocation = (
 	method: RepositoryMethod & { httpMethod: string },
@@ -186,6 +187,46 @@ const getApplicationProviderFile = async (contextName: string): Promise<string |
 	}
 };
 
+const resolveDomainInterfaceFile = async ({
+	contextName,
+	domainName,
+	interfaceName
+}: {
+	contextName: string;
+	domainName: string;
+	interfaceName: string;
+}): Promise<string | null> => {
+	const portsPath = path.join(process.cwd(), 'src', 'app', contextName, 'layers', 'domain', domainName, 'ports');
+	const preferredPath = path.join(portsPath, `${toTypeFileName(interfaceName)}.ts`);
+	const legacyPath = path.join(portsPath, `${interfaceName}.ts`);
+
+	for (const candidate of [preferredPath, legacyPath]) {
+		try {
+			await fs.access(candidate);
+			return candidate;
+		} catch {
+			// Try the next candidate.
+		}
+	}
+
+	try {
+		const files = await fs.readdir(portsPath);
+		for (const fileName of files) {
+			if (!fileName.endsWith('.ts') || fileName === 'index.ts') continue;
+			const candidate = path.join(portsPath, fileName);
+			const content = await fs.readFile(candidate, 'utf-8');
+			const escapedName = interfaceName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+			if (new RegExp(`export\\s+interface\\s+${escapedName}\\b`).test(content)) {
+				return candidate;
+			}
+		}
+	} catch {
+		return null;
+	}
+
+	return null;
+};
+
 type GeneratePresenterOptions = {
 	contextName?: string;
 	useCasesName?: string;
@@ -263,17 +304,27 @@ export default async function generatePresenter(options: GeneratePresenterOption
 	}
 
 	const repositoryHttpMethods = parseRepositoryHttpMethods(repositoryInfo.content);
-	const domainPortsInterfacePath = path.join(
-		process.cwd(),
-		'src',
-		'app',
+	const domainPortsInterfacePath = await resolveDomainInterfaceFile({
 		contextName,
-		'layers',
-		'domain',
-		useCasesInfo.domainName,
-		'ports',
-		`${useCasesInfo.repositoryInterfaceName}.ts`
-	);
+		domainName: useCasesInfo.domainName,
+		interfaceName: useCasesInfo.repositoryInterfaceName
+	});
+	if (!domainPortsInterfacePath) {
+		console.error(
+			`❌ Repository interface "${useCasesInfo.repositoryInterfaceName}" was not found in ${path.join(
+				process.cwd(),
+				'src',
+				'app',
+				contextName,
+				'layers',
+				'domain',
+				useCasesInfo.domainName,
+				'ports'
+			)}`
+		);
+		process.exitCode = 1;
+		return;
+	}
 	const repositoryInterfaceContent = await fs.readFile(domainPortsInterfacePath, 'utf-8');
 	const repositoryMethods = parseRepositoryInterfaceMethods(repositoryInterfaceContent).filter((method) =>
 		useCasesInfo.methods.includes(method.name)

package/src/generate/routes/generateRoutes.js

@@ -0,0 +1,217 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import prompts from 'prompts';
+import { loadUserConfig } from '../../utils/loadConfig.js';
+import { getSharedContextRootPath, getSharedState } from '../../utils/sharedFoundation.js';
+import { toCamelCase } from '../../utils/contextUtils.js';
+const ROUTES_DIR = path.join(process.cwd(), 'src', 'routes');
+const ROUTE_FILE_PATTERN = /^\+(page|server)(?:\.server)?\.(?:svelte|ts|js)$/;
+const PAGE_FILE_PATTERN = /^\+page(?:\.server)?\.(?:svelte|ts|js)$/;
+const SERVER_FILE_PATTERN = /^\+server\.(?:ts|js)$/;
+const isRouteGroup = (segment) => /^\(.+\)$/.test(segment);
+const getRouteGroupName = (segment) => segment.slice(1, -1).trim();
+const extractParamName = (rawParam) => {
+	const withoutRest = rawParam.startsWith('...') ? rawParam.slice(3) : rawParam;
+	const matcherIndex = withoutRest.indexOf('=');
+	return matcherIndex === -1 ? withoutRest : withoutRest.slice(0, matcherIndex);
+};
+const convertDynamicSegments = (segment) => {
+	const optionalMatch = segment.match(/^\[\[(.+)\]\]$/);
+	if (optionalMatch?.[1]) {
+		const paramName = extractParamName(optionalMatch[1]);
+		return { variants: ['', `{${paramName}}`], params: [paramName] };
+	}
+	const params = [];
+	const converted = segment.replace(/\[(.+?)\]/g, (_match, rawParam) => {
+		const paramName = extractParamName(rawParam);
+		if (paramName.length) params.push(paramName);
+		return `{${paramName}}`;
+	});
+	return { variants: [converted], params };
+};
+const normalizeUrl = (segments) => {
+	const filtered = segments.filter(Boolean);
+	return filtered.length ? `/${filtered.join('/')}` : '/';
+};
+const createRouteVariants = (segments) => {
+	let variants = [[]];
+	const dynamicParams = new Set();
+	for (const segment of segments) {
+		if (isRouteGroup(segment)) continue;
+		const converted = convertDynamicSegments(segment);
+		for (const param of converted.params) {
+			dynamicParams.add(param);
+		}
+		const nextVariants = [];
+		for (const variant of variants) {
+			for (const nextSegment of converted.variants) {
+				nextVariants.push(nextSegment ? [...variant, nextSegment] : [...variant]);
+			}
+		}
+		variants = nextVariants;
+	}
+	return {
+		urls: [...new Set(variants.map(normalizeUrl))],
+		dynamicParams: [...dynamicParams]
+	};
+};
+const hasRouteFile = (files) => files.some((file) => ROUTE_FILE_PATTERN.test(file));
+const hasPageFile = (files) => files.some((file) => PAGE_FILE_PATTERN.test(file));
+const hasServerFile = (files) => files.some((file) => SERVER_FILE_PATTERN.test(file));
+const readDirSafe = async (dir) => {
+	try {
+		return await fs.readdir(dir, { withFileTypes: true });
+	} catch {
+		return [];
+	}
+};
+const collectRoutes = async (dir, segments = [], groupStack = [], rootGroup) => {
+	const entries = (await readDirSafe(dir)).sort((a, b) => a.name.localeCompare(b.name));
+	const files = entries.filter((entry) => entry.isFile()).map((entry) => entry.name);
+	const dirs = entries.filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'));
+	const routes = [];
+	const routeVariants = createRouteVariants(segments);
+	if (hasRouteFile(files)) {
+		for (const url of routeVariants.urls) {
+			routes.push({
+				url,
+				routeDir: dir,
+				relativeDir: path.relative(ROUTES_DIR, dir) || '.',
+				segments,
+				dynamicParams: routeVariants.dynamicParams,
+				rootGroup,
+				groupStack,
+				depth: segments.length,
+				hasChildren: dirs.length > 0,
+				hasPage: hasPageFile(files),
+				hasServer: hasServerFile(files)
+			});
+		}
+	}
+	for (const child of dirs) {
+		const childGroupName = isRouteGroup(child.name) ? getRouteGroupName(child.name) : undefined;
+		const nextGroupStack = childGroupName ? [...groupStack, childGroupName] : groupStack;
+		const nextRootGroup = rootGroup ?? (segments.length === 0 ? childGroupName : undefined);
+		const childRoutes = await collectRoutes(path.join(dir, child.name), [...segments, child.name], nextGroupStack, nextRootGroup);
+		routes.push(...childRoutes);
+	}
+	return routes;
+};
+const sanitizeGroupName = (value) => {
+	const trimmed = value.trim();
+	return trimmed.length ? trimmed : 'routes';
+};
+const toRouteVariableName = (groupName) => {
+	const base = toCamelCase(sanitizeGroupName(groupName).replace(/[^\p{L}\p{N}_-]+/gu, '-'));
+	return `${base || 'routes'}Routes`;
+};
+const ensureUniqueVariableName = (name, used) => {
+	if (!used.has(name)) {
+		used.add(name);
+		return name;
+	}
+	let index = 2;
+	let nextName = `${name}${index}`;
+	while (used.has(nextName)) {
+		index += 1;
+		nextName = `${name}${index}`;
+	}
+	used.add(nextName);
+	return nextName;
+};
+const createGroupMap = (routes, mode, resolver) => {
+	const groups = new Map();
+	for (const route of routes) {
+		const groupName =
+			mode === 'none'
+				? 'routes'
+				: mode === 'root-groups'
+					? (route.rootGroup ?? 'routes')
+					: (sanitizeGroupName(String(resolver?.(route) ?? 'routes')) ?? 'routes');
+		const list = groups.get(groupName) ?? [];
+		list.push(route);
+		groups.set(groupName, list);
+	}
+	return groups;
+};
+const createStringArray = (items, indent = '\t') => {
+	if (!items.length) return '[]';
+	return `[\n${items.map((item) => `${indent}'${item}'`).join(',\n')}\n]`;
+};
+const createGeneratedFile = (groups) => {
+	const usedVariables = new Set();
+	const groupEntries = [...groups.entries()].map(([groupName, routes]) => ({
+		groupName,
+		variableName: ensureUniqueVariableName(
+			groupName === 'routes' ? (groups.size === 1 ? 'routes' : 'ungroupedRoutes') : toRouteVariableName(groupName),
+			usedVariables
+		),
+		routes: [...new Set(routes.map((route) => route.url))].sort((a, b) => a.localeCompare(b))
+	}));
+	const lines = ['// This file is generated by `azure-net generate routes`.', '// Do not edit it manually.', ''];
+	for (const group of groupEntries) {
+		lines.push(`export const ${group.variableName} = ${createStringArray(group.routes)} as const;`);
+		lines.push('');
+	}
+	if (groupEntries.length !== 1 || groupEntries[0]?.variableName !== 'routes') {
+		lines.push(`export const routes = [${groupEntries.map((group) => `...${group.variableName}`).join(', ')}] as const;`);
+		lines.push('');
+	}
+	lines.push('export const routeGroups = {');
+	lines.push(
+		...groupEntries.map((group, index) => `\t'${group.groupName}': ${group.variableName}${index === groupEntries.length - 1 ? '' : ','}`)
+	);
+	lines.push('} as const;');
+	lines.push('');
+	lines.push('export type Route = (typeof routes)[number];');
+	lines.push('export type RouteGroupName = keyof typeof routeGroups;');
+	lines.push('');
+	return `${lines.join('\n')}\n`;
+};
+const selectGroupingMode = async () => {
+	const { mode } = await prompts({
+		type: 'select',
+		name: 'mode',
+		message: 'How should routes be grouped?',
+		choices: [
+			{ title: 'By root route groups: (account), (landing), ...', value: 'root-groups' },
+			{ title: 'By azure-net.config.ts groupRoutesFunc', value: 'config-function' },
+			{ title: 'Do not group, generate one routes array', value: 'none' }
+		]
+	});
+	return mode ? mode : null;
+};
+const getConfigRouteGroupResolver = async () => {
+	const config = await loadUserConfig();
+	if (typeof config.groupRoutesFunc !== 'function') {
+		console.error('❌ `groupRoutesFunc` is missing in azure-net.config.ts/js or is not a function.');
+		console.error('Example:');
+		console.error('export default {');
+		console.error("\tgroupRoutesFunc: (route) => route.rootGroup ?? 'app'");
+		console.error('};');
+		return null;
+	}
+	return config.groupRoutesFunc;
+};
+export default async function generateRoutes() {
+	const mode = await selectGroupingMode();
+	if (!mode) return;
+	const { sharedContext } = await getSharedState();
+	const resolver = mode === 'config-function' ? await getConfigRouteGroupResolver() : undefined;
+	if (mode === 'config-function' && !resolver) {
+		process.exitCode = 1;
+		return;
+	}
+	const routes = await collectRoutes(ROUTES_DIR);
+	if (!routes.length) {
+		console.warn('⚠️ No SvelteKit routes found in src/routes');
+		return;
+	}
+	const groups = createGroupMap(routes, mode, resolver ?? undefined);
+	const outputDir = path.join(getSharedContextRootPath(sharedContext.name), 'runtime', 'routes');
+	const outputFile = path.join(outputDir, 'index.ts');
+	await fs.mkdir(outputDir, { recursive: true });
+	await fs.writeFile(outputFile, createGeneratedFile(groups), 'utf-8');
+	console.log(`✅ Routes generated: ${outputFile}`);
+}
+//# sourceMappingURL=generateRoutes.js.map

package/src/generate/routes/generateRoutes.ts

@@ -0,0 +1,282 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import prompts from 'prompts';
+import { loadUserConfig } from '../../utils/loadConfig.js';
+import { getSharedContextRootPath, getSharedState } from '../../utils/sharedFoundation.js';
+import { toCamelCase } from '../../utils/contextUtils.js';
+
+type RouteGroupingMode = 'root-groups' | 'config-function' | 'none';
+
+export type RouteGenerationMeta = {
+	url: string;
+	routeDir: string;
+	relativeDir: string;
+	segments: string[];
+	dynamicParams: string[];
+	rootGroup?: string;
+	groupStack: string[];
+	depth: number;
+	hasChildren: boolean;
+	hasPage: boolean;
+	hasServer: boolean;
+};
+
+type RouteRecord = RouteGenerationMeta;
+type RouteGroupResolver = (route: RouteGenerationMeta) => string | null | undefined;
+
+const ROUTES_DIR = path.join(process.cwd(), 'src', 'routes');
+const ROUTE_FILE_PATTERN = /^\+(page|server)(?:\.server)?\.(?:svelte|ts|js)$/;
+const PAGE_FILE_PATTERN = /^\+page(?:\.server)?\.(?:svelte|ts|js)$/;
+const SERVER_FILE_PATTERN = /^\+server\.(?:ts|js)$/;
+
+const isRouteGroup = (segment: string): boolean => /^\(.+\)$/.test(segment);
+const getRouteGroupName = (segment: string): string => segment.slice(1, -1).trim();
+
+const extractParamName = (rawParam: string): string => {
+	const withoutRest = rawParam.startsWith('...') ? rawParam.slice(3) : rawParam;
+	const matcherIndex = withoutRest.indexOf('=');
+	return matcherIndex === -1 ? withoutRest : withoutRest.slice(0, matcherIndex);
+};
+
+const convertDynamicSegments = (segment: string): { variants: string[]; params: string[] } => {
+	const optionalMatch = segment.match(/^\[\[(.+)\]\]$/);
+	if (optionalMatch?.[1]) {
+		const paramName = extractParamName(optionalMatch[1]);
+		return { variants: ['', `{${paramName}}`], params: [paramName] };
+	}
+
+	const params: string[] = [];
+	const converted = segment.replace(/\[(.+?)\]/g, (_match, rawParam: string) => {
+		const paramName = extractParamName(rawParam);
+		if (paramName.length) params.push(paramName);
+		return `{${paramName}}`;
+	});
+
+	return { variants: [converted], params };
+};
+
+const normalizeUrl = (segments: string[]): string => {
+	const filtered = segments.filter(Boolean);
+	return filtered.length ? `/${filtered.join('/')}` : '/';
+};
+
+const createRouteVariants = (segments: string[]): { urls: string[]; dynamicParams: string[] } => {
+	let variants: string[][] = [[]];
+	const dynamicParams = new Set<string>();
+
+	for (const segment of segments) {
+		if (isRouteGroup(segment)) continue;
+
+		const converted = convertDynamicSegments(segment);
+		for (const param of converted.params) {
+			dynamicParams.add(param);
+		}
+
+		const nextVariants: string[][] = [];
+		for (const variant of variants) {
+			for (const nextSegment of converted.variants) {
+				nextVariants.push(nextSegment ? [...variant, nextSegment] : [...variant]);
+			}
+		}
+		variants = nextVariants;
+	}
+
+	return {
+		urls: [...new Set(variants.map(normalizeUrl))],
+		dynamicParams: [...dynamicParams]
+	};
+};
+
+const hasRouteFile = (files: string[]): boolean => files.some((file) => ROUTE_FILE_PATTERN.test(file));
+const hasPageFile = (files: string[]): boolean => files.some((file) => PAGE_FILE_PATTERN.test(file));
+const hasServerFile = (files: string[]): boolean => files.some((file) => SERVER_FILE_PATTERN.test(file));
+
+const readDirSafe = async (dir: string): Promise<import('node:fs').Dirent[]> => {
+	try {
+		return await fs.readdir(dir, { withFileTypes: true });
+	} catch {
+		return [];
+	}
+};
+
+const collectRoutes = async (
+	dir: string,
+	segments: string[] = [],
+	groupStack: string[] = [],
+	rootGroup?: string
+): Promise<RouteRecord[]> => {
+	const entries = (await readDirSafe(dir)).sort((a, b) => a.name.localeCompare(b.name));
+	const files = entries.filter((entry) => entry.isFile()).map((entry) => entry.name);
+	const dirs = entries.filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'));
+	const routes: RouteRecord[] = [];
+	const routeVariants = createRouteVariants(segments);
+
+	if (hasRouteFile(files)) {
+		for (const url of routeVariants.urls) {
+			routes.push({
+				url,
+				routeDir: dir,
+				relativeDir: path.relative(ROUTES_DIR, dir) || '.',
+				segments,
+				dynamicParams: routeVariants.dynamicParams,
+				rootGroup,
+				groupStack,
+				depth: segments.length,
+				hasChildren: dirs.length > 0,
+				hasPage: hasPageFile(files),
+				hasServer: hasServerFile(files)
+			});
+		}
+	}
+
+	for (const child of dirs) {
+		const childGroupName = isRouteGroup(child.name) ? getRouteGroupName(child.name) : undefined;
+		const nextGroupStack = childGroupName ? [...groupStack, childGroupName] : groupStack;
+		const nextRootGroup = rootGroup ?? (segments.length === 0 ? childGroupName : undefined);
+		const childRoutes = await collectRoutes(path.join(dir, child.name), [...segments, child.name], nextGroupStack, nextRootGroup);
+		routes.push(...childRoutes);
+	}
+
+	return routes;
+};
+
+const sanitizeGroupName = (value: string): string => {
+	const trimmed = value.trim();
+	return trimmed.length ? trimmed : 'routes';
+};
+
+const toRouteVariableName = (groupName: string): string => {
+	const base = toCamelCase(sanitizeGroupName(groupName).replace(/[^\p{L}\p{N}_-]+/gu, '-'));
+	return `${base || 'routes'}Routes`;
+};
+
+const ensureUniqueVariableName = (name: string, used: Set<string>): string => {
+	if (!used.has(name)) {
+		used.add(name);
+		return name;
+	}
+
+	let index = 2;
+	let nextName = `${name}${index}`;
+	while (used.has(nextName)) {
+		index += 1;
+		nextName = `${name}${index}`;
+	}
+	used.add(nextName);
+	return nextName;
+};
+
+const createGroupMap = (routes: RouteRecord[], mode: RouteGroupingMode, resolver?: RouteGroupResolver): Map<string, RouteRecord[]> => {
+	const groups = new Map<string, RouteRecord[]>();
+
+	for (const route of routes) {
+		const groupName =
+			mode === 'none'
+				? 'routes'
+				: mode === 'root-groups'
+					? (route.rootGroup ?? 'routes')
+					: (sanitizeGroupName(String(resolver?.(route) ?? 'routes')) ?? 'routes');
+		const list = groups.get(groupName) ?? [];
+		list.push(route);
+		groups.set(groupName, list);
+	}
+
+	return groups;
+};
+
+const createStringArray = (items: string[], indent = '\t'): string => {
+	if (!items.length) return '[]';
+	return `[\n${items.map((item) => `${indent}'${item}'`).join(',\n')}\n]`;
+};
+
+const createGeneratedFile = (groups: Map<string, RouteRecord[]>): string => {
+	const usedVariables = new Set<string>();
+	const groupEntries = [...groups.entries()].map(([groupName, routes]) => ({
+		groupName,
+		variableName: ensureUniqueVariableName(
+			groupName === 'routes' ? (groups.size === 1 ? 'routes' : 'ungroupedRoutes') : toRouteVariableName(groupName),
+			usedVariables
+		),
+		routes: [...new Set(routes.map((route) => route.url))].sort((a, b) => a.localeCompare(b))
+	}));
+
+	const lines: string[] = ['// This file is generated by `azure-net generate routes`.', '// Do not edit it manually.', ''];
+
+	for (const group of groupEntries) {
+		lines.push(`export const ${group.variableName} = ${createStringArray(group.routes)} as const;`);
+		lines.push('');
+	}
+
+	if (groupEntries.length !== 1 || groupEntries[0]?.variableName !== 'routes') {
+		lines.push(`export const routes = [${groupEntries.map((group) => `...${group.variableName}`).join(', ')}] as const;`);
+		lines.push('');
+	}
+
+	lines.push('export const routeGroups = {');
+	lines.push(
+		...groupEntries.map((group, index) => `\t'${group.groupName}': ${group.variableName}${index === groupEntries.length - 1 ? '' : ','}`)
+	);
+	lines.push('} as const;');
+	lines.push('');
+	lines.push('export type Route = (typeof routes)[number];');
+	lines.push('export type RouteGroupName = keyof typeof routeGroups;');
+	lines.push('');
+
+	return `${lines.join('\n')}\n`;
+};
+
+const selectGroupingMode = async (): Promise<RouteGroupingMode | null> => {
+	const { mode } = await prompts({
+		type: 'select',
+		name: 'mode',
+		message: 'How should routes be grouped?',
+		choices: [
+			{ title: 'By root route groups: (account), (landing), ...', value: 'root-groups' },
+			{ title: 'By azure-net.config.ts groupRoutesFunc', value: 'config-function' },
+			{ title: 'Do not group, generate one routes array', value: 'none' }
+		]
+	});
+
+	return mode ? (mode as RouteGroupingMode) : null;
+};
+
+const getConfigRouteGroupResolver = async (): Promise<RouteGroupResolver | null> => {
+	const config = await loadUserConfig();
+	if (typeof config.groupRoutesFunc !== 'function') {
+		console.error('❌ `groupRoutesFunc` is missing in azure-net.config.ts/js or is not a function.');
+		console.error('Example:');
+		console.error('export default {');
+		console.error("\tgroupRoutesFunc: (route) => route.rootGroup ?? 'app'");
+		console.error('};');
+		return null;
+	}
+
+	return config.groupRoutesFunc as RouteGroupResolver;
+};
+
+export default async function generateRoutes(): Promise<void> {
+	const mode = await selectGroupingMode();
+	if (!mode) return;
+
+	const { sharedContext } = await getSharedState();
+	const resolver = mode === 'config-function' ? await getConfigRouteGroupResolver() : undefined;
+	if (mode === 'config-function' && !resolver) {
+		process.exitCode = 1;
+		return;
+	}
+
+	const routes = await collectRoutes(ROUTES_DIR);
+	if (!routes.length) {
+		console.warn('⚠️ No SvelteKit routes found in src/routes');
+		return;
+	}
+
+	const groups = createGroupMap(routes, mode, resolver ?? undefined);
+	const outputDir = path.join(getSharedContextRootPath(sharedContext.name), 'runtime', 'routes');
+	const outputFile = path.join(outputDir, 'index.ts');
+
+	await fs.mkdir(outputDir, { recursive: true });
+	await fs.writeFile(outputFile, createGeneratedFile(groups), 'utf-8');
+
+	console.log(`✅ Routes generated: ${outputFile}`);
+}

package/src/scaffolds/createPresenterFactory.js

@@ -7,9 +7,9 @@ import { toPascalCase } from '../utils/contextUtils.js';
 import { getFoundationConstructPath, getSharedState } from '../utils/sharedFoundation.js';
 const createPresenterFactoryTemplate = (
 	factoryName
-) => `import { createErrorHandler, createAsyncHelpers, createPresenterFactory } from '@azure-net/kit/delivery';
+) => `import { createAsyncHelpers, createPresenterFactory } from '@azure-net/kit/delivery';
 
-export const AsyncHelpers = createAsyncHelpers({ handler: createErrorHandler() });
+export const AsyncHelpers = createAsyncHelpers();
 
 export const ${factoryName} = createPresenterFactory({ ...AsyncHelpers });
 `;

package/src/scaffolds/createPresenterFactory.ts

@@ -10,9 +10,9 @@ type ConfigPath = 'ts' | 'js';
 
 const createPresenterFactoryTemplate = (
 	factoryName: string
-): string => `import { createErrorHandler, createAsyncHelpers, createPresenterFactory } from '@azure-net/kit/delivery';
+): string => `import { createAsyncHelpers, createPresenterFactory } from '@azure-net/kit/delivery';
 
-export const AsyncHelpers = createAsyncHelpers({ handler: createErrorHandler() });
+export const AsyncHelpers = createAsyncHelpers();
 
 export const ${factoryName} = createPresenterFactory({ ...AsyncHelpers });
 `;

package/src/utils/loadConfig.ts

@@ -9,6 +9,7 @@ export type AzureNetConfig = {
 	packageManager?: string;
 	defaultSchemaFactory?: string;
 	defaultPresenterFactory?: string;
+	groupRoutesFunc?: unknown;
 	[key: string]: unknown;
 };