@kosmojs/lib 0.5.0 → 0.6.2

package/README.md

@@ -1,16 +1,23 @@
 # @kosmojs/lib
 
-TODO: Add package description
+Internal toolkit shared by the CLI and the generators.
 
-## Installation
+## Scope
 
-```sh
-npm install -D @kosmojs/lib
-```
+Published because [`@kosmojs/cli`](https://www.npmjs.com/package/@kosmojs/cli),
+[`@kosmojs/dev`](https://www.npmjs.com/package/@kosmojs/dev) and the generators depend on it - **not** intended for direct use.
+It carries no stability guarantee across releases and can change shape in a patch.
+
+It holds the pieces those packages need in common: TypeScript AST helpers for resolving validation types,
+the generator base and file-deployment helpers, path and route utilities, the Handlebars render layer, and Vite helpers.
+
+If you are writing a generator, depend on the documented contract in `@kosmojs/core/generators` instead.
 
 ## Documentation
 
-See [kosmojs.dev](https://kosmojs.dev)
+- [Why code generation](https://kosmojs.dev/essentials/why-codegen.html)
+
+Full documentation at [kosmojs.dev](https://kosmojs.dev).
 
 ## License
 

package/package.json

@@ -1,7 +1,8 @@
 {
   "type": "module",
   "name": "@kosmojs/lib",
-  "version": "0.5.0",
+  "version": "0.6.2",
+  "description": "Shared internals for the KosmoJS CLI and generators (not a public API)",
   "author": "Slee Woo",
   "license": "MIT",
   "repository": {
@@ -16,14 +17,16 @@
     ".": {
       "types": "./pkg/index.d.ts",
       "default": "./pkg/index.js"
-    }
+    },
+    "./package.json": "./package.json"
   },
   "dependencies": {
-    "@kosmojs/core": "^0.5.0",
+    "@kosmojs/core": "^0.6.2",
     "@topcli/spinner": "^5.0.0",
     "crc": "^4.3.2",
-    "handlebars": "^4.7.9",
+    "handlebars": "^4.7.10",
     "mrmime": "^2.0.1",
+    "oxfmt": "^0.72.0",
     "path-to-regexp": "^8.4.2",
     "picomatch": "^4.0.7",
     "tfusion": "^0.2.2",
@@ -32,11 +35,11 @@
   },
   "devDependencies": {
     "@koa/router": "^15.7.0",
-    "@kosmojs/lib": "^0.5.0",
+    "@kosmojs/lib": "^0.6.2",
     "@types/picomatch": "^4.0.3",
-    "hono": "^4.13.7",
-    "rou3": "^0.9.2",
-    "vite": "^8.2.2"
+    "hono": "^4.13.13",
+    "rou3": "^1.0.0",
+    "vite": "^8.3.4"
   },
   "scripts": {
     "build": "wsbuild src/index.ts",

package/pkg/ast.d.ts

@@ -1,6 +1,6 @@
 import flattener from "tfusion";
 import { type CallExpression, Project, type ProjectOptions, type SourceFile } from "ts-morph";
-import type { ResolvedTypeSignature } from "@kosmojs/core";
+import type { ProjectSettings, ResolvedTypeSignature } from "@kosmojs/core";
 import { type ApiRoute, type SourceFolder, type TypeDeclaration, type ValidationDefinition } from "@kosmojs/core";
 import { type HTTPMethod } from "@kosmojs/core/api";
 type PathResolver = (path: string) => string;
@@ -33,7 +33,7 @@ export declare const astFactory: () => {
         validationDefinitions: ValidationDefinition[];
         referencedFiles: string[] | undefined;
     }>;
-    typeResolverFactory: (sourceFolder: SourceFolder) => {
+    typeResolverFactory: (projectSettings: ProjectSettings, sourceFolder: SourceFolder) => {
         getSourceFile: (fileFullpath: string) => SourceFile;
         refreshSourceFile: (fileFullpath: string) => Promise<void>;
         literalTypesResolver: (literalTypes: string, options: Parameters<typeof flattener>[2]) => Array<ResolvedTypeSignature>;

package/pkg/format.d.ts

@@ -0,0 +1,2 @@
+import { type FormatConfig } from "oxfmt";
+export declare const formatCode: (code: string, filename: string, config?: FormatConfig) => Promise<string>;

package/pkg/generators.d.ts

@@ -1,8 +1,8 @@
-import type { GeneratorFactory, GeneratorSignature, ResolvedEntry, SourceFolder, WatcherEvent } from "@kosmojs/core";
+import type { GeneratorFactory, GeneratorSignature, ProjectSettings, ResolvedEntry, SourceFolder, WatcherEvent } from "@kosmojs/core";
 export declare const defineGenerator: <O extends object, R extends boolean = false>({ meta, factory, dependencies, devDependencies, }: Omit<GeneratorSignature<O>, "factory"> & {
-    factory: (f: SourceFolder, o?: O) => GeneratorFactory;
-}) => [R] extends [true] ? ((o: O) => GeneratorSignature<O>) & Pick<GeneratorSignature, "meta" | "dependencies" | "devDependencies"> : ((o?: O) => GeneratorSignature<O>) & Pick<GeneratorSignature<O>, "meta" | "dependencies" | "devDependencies">;
-export declare const defineGeneratorFactory: <O extends object>(factory: (f: SourceFolder, o?: O) => GeneratorFactory) => (f: SourceFolder, o?: O) => GeneratorFactory;
+    factory: (s: ProjectSettings, f: SourceFolder, o?: O) => GeneratorFactory;
+}) => [R] extends [true] ? (o: O) => GeneratorSignature<O> : (o?: O) => GeneratorSignature<O>;
+export declare const defineGeneratorFactory: <O extends object>(factory: (s: ProjectSettings, f: SourceFolder, o?: O) => GeneratorFactory) => (s: ProjectSettings, f: SourceFolder, o?: O) => GeneratorFactory;
 /**
  * Filter watched API routes by event.
  * Handle 3 cases:

package/pkg/generic.d.ts

@@ -1,4 +1,7 @@
 import { type UserConfig } from "vite";
+import { type KosmoSettings } from "@kosmojs/core";
 export declare const mergeConfigs: (...configs: Array<UserConfig | undefined>) => UserConfig;
 export declare const escapeTemplateLiterals: (origin: string) => string;
 export declare const containsPathTraversalPatterns: (str: string) => boolean;
+export declare const configFilePattern: (folder: string) => string;
+export declare const resolveHostAddress: (settings: KosmoSettings | undefined, key: "devHost" | "previewHost") => string;

package/pkg/index.d.ts

@@ -1,8 +1,20 @@
+/**
+ * Read the installed package.json at runtime to get the actual version.
+ * A static import would be inlined by the bundler with the pre-bump version.
+ *
+ * INFO: For best compatibility, all packages should share the same version.
+ * When bumping the version (even a patch) for a single package,
+ * bump it for all packages to keep versions fully synchronized across the project.
+ * */
+export declare const VERSION: any;
 export * from "./ast";
+export * from "./format";
 export * from "./generators";
 export * from "./generic";
 export * from "./paths";
+export * from "./ports";
 export * from "./render";
 export * from "./routes";
 export * from "./spinner";
+export * from "./tsconfig";
 export * from "./vite";

package/pkg/index.js

@@ -1,14 +1,17 @@
-import { builtinModules } from "node:module";
+import { builtinModules, createRequire } from "node:module";
+import { readFileSync } from "node:fs";
 import { styleText } from "node:util";
 import crc from "crc/crc32";
 import flattener from "tfusion";
 import { ModuleResolutionKind, Project, SyntaxKind } from "ts-morph";
-import { RequestValidationTargets, defaults } from "@kosmojs/core";
+import { DEFAULT_DIST, DEFAULT_HOST, DEFAULT_PORT, DEFAULT_PREVIEW_HOST, DEFAULT_PREVIEW_PORT, RequestValidationTargets, defaults } from "@kosmojs/core";
 import { HTTPMethods } from "@kosmojs/core/api";
+import { basename, dirname, isAbsolute, join, parse, posix, resolve } from "node:path";
 import { mergeConfig } from "vite";
 import { access, constants, mkdir, readFile, stat, writeFile } from "node:fs/promises";
-import { basename, dirname, isAbsolute, join, parse, posix, resolve } from "node:path";
 import handlebars from "handlebars";
+import { format } from "oxfmt";
+import net from "node:net";
 import picomatch from "picomatch";
 import { glob } from "tinyglobby";
 import { compile, parse as parse$1 } from "path-to-regexp";
@@ -24,15 +27,27 @@ var escapeTemplateLiterals = (origin) => {
 var containsPathTraversalPatterns = (str) => {
 	return [/\.\.\//, /\/\.\//].some((e) => e.test(str));
 };
+var configFilePattern = (folder) => {
+	return posix.join(defaults.srcDir, folder, "kosmo.config.ts");
+};
+var resolveHostAddress = (settings, key) => {
+	let [host, port] = key === "devHost" ? [DEFAULT_HOST, DEFAULT_PORT] : [DEFAULT_PREVIEW_HOST, DEFAULT_PREVIEW_PORT];
+	if (settings?.[key]) {
+		const url = new URL(`http://${settings[key]}`);
+		if (url.hostname) host = url.hostname;
+		if (url.port) port = Number(url.port);
+	}
+	return [host, port].join(":");
+};
 //#endregion
 //#region src/paths.ts
-var pathResolver = (sourceFolder) => {
+var pathResolver = ({ root, distDir = DEFAULT_DIST }, { name }) => {
 	const createPath = (...a) => {
-		return sourceFolder.root ? resolve(sourceFolder.root, join(...a)) : join(...a);
+		return root ? resolve(root, join(...a)) : join(...a);
 	};
 	const createImport = {
 		src(a, { origin }) {
-			return origin === "src" ? join(defaults.srcPrefix, ...a) : join(defaults.appPrefix, defaults.srcDir, sourceFolder.name, ...a);
+			return origin === "src" ? join(defaults.srcPrefix, ...a) : join(defaults.appPrefix, defaults.srcDir, name, ...a);
 		},
 		api(a, o) {
 			return this.src([defaults.apiDir, ...a], o);
@@ -44,7 +59,7 @@ var pathResolver = (sourceFolder) => {
 			return this.src([defaults.pagesDir, ...a], o);
 		},
 		lib(a, { origin }) {
-			return origin === "src" ? join(defaults.libPrefix, ...a) : join(defaults.appPrefix, defaults.libDir, sourceFolder.name, ...a);
+			return origin === "src" ? join(defaults.libPrefix, ...a) : join(defaults.appPrefix, defaults.libDir, name, ...a);
 		},
 		libCore(a, o) {
 			return this.lib(["core", ...a], o);
@@ -59,7 +74,7 @@ var pathResolver = (sourceFolder) => {
 	return {
 		createPath: {
 			src(...a) {
-				return createPath(defaults.srcDir, sourceFolder.name, ...a);
+				return createPath(defaults.srcDir, name, ...a);
 			},
 			api(...a) {
 				return this.src(defaults.apiDir, ...a);
@@ -71,7 +86,7 @@ var pathResolver = (sourceFolder) => {
 				return this.src(defaults.entryDir, ...a);
 			},
 			lib(...a) {
-				return createPath(defaults.libDir, sourceFolder.name, ...a);
+				return createPath(defaults.libDir, name, ...a);
 			},
 			libCore(...a) {
 				return this.lib("core", ...a);
@@ -86,7 +101,7 @@ var pathResolver = (sourceFolder) => {
 				return this.lib(defaults.pagesDir, ...a);
 			},
 			distDir(...a) {
-				return createPath(sourceFolder.distDir, sourceFolder.name, ...a);
+				return createPath(distDir, name, ...a);
 			}
 		},
 		createImport,
@@ -446,15 +461,15 @@ var astFactory = () => {
 	const extractGenerics = (callExpression) => {
 		return callExpression.getTypeArguments();
 	};
-	const typeResolverFactory = (sourceFolder) => {
-		const { createPath } = pathResolver(sourceFolder);
+	const typeResolverFactory = (projectSettings, sourceFolder) => {
+		const { createPath } = pathResolver(projectSettings, sourceFolder);
 		const project = createProject({ compilerOptions: {
 			moduleResolution: ModuleResolutionKind.Bundler,
 			types: [],
 			noLib: true,
 			skipLibCheck: true,
 			paths: {
-				[`${defaults.appPrefix}/*`]: [`${sourceFolder.root}/*`],
+				[`${defaults.appPrefix}/*`]: [`${projectSettings.root}/*`],
 				[`${defaults.srcPrefix}/*`]: [createPath.src("*")],
 				[`${defaults.libPrefix}/*`]: [createPath.lib("*")]
 			}
@@ -625,23 +640,27 @@ var renderTypeboxSchema = (typeNode, refineTypeName = defaults.refineTypeName) =
 	return escapeTemplateLiterals(traverse(typeNode));
 };
 //#endregion
+//#region src/format.ts
+var formatCode = async (code, filename, config) => {
+	return format(filename, code, {
+		sortImports: true,
+		...config
+	}).then((e) => e.errors.length ? code : e.code);
+};
+//#endregion
 //#region src/generators.ts
 var defineGenerator = ({ meta, factory, dependencies, devDependencies }) => {
-	const wrapper = ((options) => {
+	return ((options) => {
 		return {
 			meta,
-			factory: (folder) => factory(folder, options),
+			factory: (settings, folder) => {
+				return factory(settings, folder, options);
+			},
 			dependencies,
 			devDependencies,
 			options
 		};
 	});
-	Object.assign(wrapper, {
-		meta,
-		dependencies,
-		devDependencies
-	});
-	return wrapper;
 };
 var defineGeneratorFactory = (factory) => factory;
 /**
@@ -680,6 +699,51 @@ var createWatchedPageRouteEntriesFilter = (event, eventsOfInterest) => {
 	};
 };
 //#endregion
+//#region src/ports.ts
+/**
+* Probe whether a single TCP port is free on given host.
+*
+* Resolves `true` only after the probe server has fully closed,
+* so the caller can immediately rebind without racing the OS.
+* `unref()` keeps a dangling probe from holding the event loop open.
+* */
+var isPortFree = (host, port, timeoutMs = 2e3) => {
+	return new Promise((resolve) => {
+		const server = net.createServer();
+		const done = (result) => {
+			clearTimeout(timer);
+			resolve(result);
+		};
+		const timer = setTimeout(() => {
+			server.close(() => done(false));
+		}, timeoutMs);
+		server.unref();
+		server.once("error", () => done(false));
+		server.once("listening", () => server.close(() => done(true)));
+		server.listen({
+			host,
+			port
+		});
+	});
+};
+/**
+* Find `count` consecutive free ports by probing random offsets within minPort..maxPort.
+* Each attempt picks a uniformly random start, probes the whole window,
+* and returns it only if every port is free.
+* Failed attempts are cheap because only the window is probed - no full-range scan.
+* */
+var findFreePortRange = async (host, count, { minPort = 2e4, maxPort = 29e3, attempts = 32 } = {}) => {
+	if (count < 1) throw new Error("count must be >= 1");
+	const span = maxPort - minPort - count + 1;
+	if (span <= 0) throw new Error(`Port range ${minPort}-${maxPort} is too small for a window of ${count}`);
+	for (let attempt = 0; attempt < attempts; attempt++) {
+		const start = minPort + Math.floor(Math.random() * span);
+		const range = Array.from({ length: count }, (_, i) => start + i);
+		if ((await Promise.all(range.map((p) => isPortFree(host, p)))).every(Boolean)) return range;
+	}
+	throw new Error(`No run of ${count} free ports found in range ${minPort}-${maxPort} after ${attempts} random attempts`);
+};
+//#endregion
 //#region src/routes/paths.ts
 /**
 * Parse a filesystem route path into structured PathToken array.
@@ -813,7 +877,7 @@ var createH3Pattern = (tokens) => {
 		return tokens.flatMap((t) => {
 			if (t.type === "text") return t.value === "/" ? [] : [escapeStatic(t.value)];
 			if (t.type === "param") return [`:${t.name}`];
-			if (t.type === "wildcard") return [`/**:${t.name}?`];
+			if (t.type === "wildcard") return [`/**:${t.name}`];
 			if (t.type === "group") return [`{${tokensToPattern(t.tokens)}}?`];
 			return [];
 		}).join("");
@@ -851,8 +915,8 @@ var ROUTE_FILE_PATTERNS = [
 	`${defaults.pagesDir}/**/${PAGE_INDEX_PATTERN}`,
 	`${defaults.pagesDir}/**/${PAGE_LAYOUT_PATTERN}`
 ];
-var scanRoutes = async (sourceFolder) => {
-	const { createPath } = pathResolver(sourceFolder);
+var scanRoutes = async (projectSettings, sourceFolder) => {
+	const { createPath } = pathResolver(projectSettings, sourceFolder);
 	return glob(ROUTE_FILE_PATTERNS, {
 		cwd: createPath.src(),
 		absolute: true,
@@ -866,8 +930,8 @@ var scanRoutes = async (sourceFolder) => {
 		]
 	});
 };
-var isRouteFile = (file, sourceFolder) => {
-	const [_sourceFolder, _folder, ...rest] = resolve(sourceFolder.root, file).replace(`${sourceFolder.root}/${defaults.srcDir}/`, "").split("/");
+var isRouteFile = (projectSettings, sourceFolder, file) => {
+	const [_sourceFolder, _folder, ...rest] = resolve(projectSettings.root, file).replace(`${projectSettings.root}/${defaults.srcDir}/`, "").split("/");
 	/**
 	* Ensure the file:
 	* - is under the correct source root
@@ -889,8 +953,8 @@ var isPageRoute = (file) => {
 var isPageLayout = (file) => {
 	return picomatch.matchBase(file, `**/${PAGE_LAYOUT_PATTERN}`);
 };
-var createRouteEntry = (fileFullpath, sourceFolder) => {
-	const resolvedPaths = isRouteFile(fileFullpath, sourceFolder);
+var createRouteEntry = (projectSettings, sourceFolder, fileFullpath) => {
+	const resolvedPaths = isRouteFile(projectSettings, sourceFolder, fileFullpath);
 	if (!resolvedPaths) return;
 	const [folder, file] = resolvedPaths;
 	const id = `${file.replace(/\W+/g, "_")}_${crc(file)}`;
@@ -999,12 +1063,12 @@ var sortRoutesForResolution = (a, b) => {
 };
 //#endregion
 //#region src/routes/resolve.ts
-var resolverFactory = (sourceFolder, cacheFactory) => {
-	const { generators } = sourceFolder.config;
+var resolverFactory = (projectSettings, sourceFolder, cacheFactory) => {
+	const { generators } = sourceFolder;
 	const { refineTypeName = defaults.refineTypeName } = typeof sourceFolder.config.validation === "object" ? { ...sourceFolder.config.validation } : {};
 	const { typeResolverFactory, resolveRouteSignature } = astFactory();
 	const resolveTypes = generators.some(({ meta }) => meta.resolveTypes);
-	const { literalTypesResolver, getSourceFile, refreshSourceFile } = typeResolverFactory(sourceFolder);
+	const { literalTypesResolver, getSourceFile, refreshSourceFile } = typeResolverFactory(projectSettings, sourceFolder);
 	return {
 		pageLayoutResolver(entry) {
 			const { name } = entry;
@@ -1067,11 +1131,11 @@ var resolverFactory = (sourceFolder, cacheFactory) => {
 					});
 				});
 				const optionalParams = paramsSchema.length ? paramsSchema.filter((e) => e.kind === "required").length === 0 : true;
-				const cacheStore = cacheFactory ? cacheFactory({
+				const cacheStore = cacheFactory ? cacheFactory(projectSettings, sourceFolder, {
 					id,
 					file,
 					fileFullpath
-				}, sourceFolder, { resolveTypes }) : void 0;
+				}, { resolveTypes }) : void 0;
 				let cache = cacheStore ? await cacheStore.get({ validate: true }) : void 0;
 				if (!cache) {
 					if (updatedFile === fileFullpath) await refreshSourceFile(fileFullpath);
@@ -1095,7 +1159,7 @@ var resolverFactory = (sourceFolder, cacheFactory) => {
 							}] : [];
 						}) : [def.schema];
 					});
-					const typesFile = pathResolver(sourceFolder).createPath.libApi(dirname(file), "types.ts");
+					const typesFile = pathResolver(projectSettings, sourceFolder).createPath.libApi(dirname(file), "types.ts");
 					const params = {
 						id: ["ParamsT", crc(name)].join(""),
 						schema: paramsSchema,
@@ -1208,7 +1272,7 @@ var resolverFactory = (sourceFolder, cacheFactory) => {
 						methods: cache.methods,
 						typeDeclarations: cache.typeDeclarations,
 						validationDefinitions,
-						referencedFiles: Object.keys(cache.referencedFiles).map((e) => resolve(sourceFolder.root, e))
+						referencedFiles: Object.keys(cache.referencedFiles).map((e) => resolve(projectSettings.root, e))
 					}
 				};
 			};
@@ -1288,12 +1352,12 @@ var nestedRoutesFactory = (routeEntries) => {
 };
 //#endregion
 //#region src/routes/index.ts
-var routesFactory = async (sourceFolder, cacheFactory) => {
-	const { apiRouteResolver, apiUseResolver, pageRouteResolver, pageLayoutResolver } = resolverFactory(sourceFolder, cacheFactory);
+var routesFactory = async (projectSettings, sourceFolder, cacheFactory) => {
+	const { apiRouteResolver, apiUseResolver, pageRouteResolver, pageLayoutResolver } = resolverFactory(projectSettings, sourceFolder, cacheFactory);
 	const resolversFactory = (routeFiles) => {
 		const resolvers = /* @__PURE__ */ new Map();
 		const entries = routeFiles.flatMap((file) => {
-			const entry = createRouteEntry(file, sourceFolder);
+			const entry = createRouteEntry(projectSettings, sourceFolder, file);
 			return entry ? [entry] : [];
 		});
 		for (const entry of entries) if (entry.folder === defaults.apiDir) {
@@ -1306,7 +1370,7 @@ var routesFactory = async (sourceFolder, cacheFactory) => {
 		return resolvers;
 	};
 	return {
-		resolvers: resolversFactory(await scanRoutes(sourceFolder)),
+		resolvers: resolversFactory(await scanRoutes(projectSettings, sourceFolder)),
 		resolversFactory
 	};
 };
@@ -1341,6 +1405,70 @@ var spinnerFactory = (startText) => {
 	};
 };
 //#endregion
+//#region src/tsconfig.ts
+var generateTsconfig = ({ dependencies, devDependencies }, sourceFolder) => {
+	const rootDir = "${configDir}";
+	const deps = Object.keys({
+		...dependencies,
+		...devDependencies
+	});
+	const compilerOptions = {
+		types: ["vite/client", ...[
+			"node",
+			"deno",
+			"bun"
+		].flatMap((e) => {
+			return deps.includes(`@types/${e}`) ? [`@types/${e}`] : [];
+		})],
+		moduleResolution: "bundler",
+		module: "ESNext",
+		target: "ESNext",
+		strict: true,
+		exactOptionalPropertyTypes: true,
+		noImplicitAny: true,
+		noImplicitThis: true,
+		noImplicitOverride: true,
+		noImplicitReturns: true,
+		noUnusedLocals: false,
+		noUnusedParameters: false,
+		allowArbitraryExtensions: true,
+		allowImportingTsExtensions: true,
+		allowUnreachableCode: false,
+		allowUnusedLabels: false,
+		useUnknownInCatchVariables: true,
+		noFallthroughCasesInSwitch: true,
+		noUncheckedSideEffectImports: true,
+		resolveJsonModule: true,
+		esModuleInterop: true,
+		verbatimModuleSyntax: true,
+		skipLibCheck: true,
+		noEmit: true
+	};
+	if (sourceFolder) return {
+		include: [
+			`${rootDir}/`,
+			`${rootDir}/../../${defaults.libDir}/${sourceFolder}/`,
+			`${rootDir}/../../${defaults.libDir}/*.d.ts`
+		],
+		compilerOptions: {
+			...compilerOptions,
+			types: [...compilerOptions.types],
+			paths: {
+				[`${defaults.appPrefix}/*`]: [`${rootDir}/../../*`],
+				[`${defaults.srcPrefix}/*`]: [`${rootDir}/*`],
+				[`${defaults.libPrefix}/*`]: [`${rootDir}/../../${defaults.libDir}/${sourceFolder}/*`]
+			}
+		}
+	};
+	return {
+		exclude: [`${rootDir}/${defaults.srcDir}/`],
+		compilerOptions: {
+			...compilerOptions,
+			paths: { [`${defaults.appPrefix}/*`]: [`${rootDir}/*`] }
+		}
+	};
+};
+//#endregion
 //#region src/vite.ts
 /**
 * Resolves Kosmo's generated import prefixes to absolute file paths.
@@ -1394,7 +1522,7 @@ var spinnerFactory = (startText) => {
 * tsconfig generator uses, so alias resolution here can never drift from the
 * paths that were written into the generated tsconfig.
 * */
-var tsconfigPaths = (sourceFolder) => {
+var tsconfigPaths = (projectSettings, sourceFolder) => {
 	/**
 	* Candidate extensions for an extensionless specifier, in resolution priority order.
 	* Mirrors the renderable file types the generators emit;
@@ -1412,11 +1540,11 @@ var tsconfigPaths = (sourceFolder) => {
 		".mdx",
 		".json"
 	];
-	const { createPath } = pathResolver(sourceFolder);
+	const { createPath } = pathResolver(projectSettings, sourceFolder);
 	const table = [
 		[`${defaults.srcPrefix}/`, createPath.src()],
 		[`${defaults.libPrefix}/`, createPath.lib()],
-		[`${defaults.appPrefix}/`, sourceFolder.root]
+		[`${defaults.appPrefix}/`, projectSettings.root]
 	];
 	const resolveWithin = async (baseDir, rest) => {
 		const target = join(baseDir, rest);
@@ -1463,14 +1591,15 @@ var nodePrefix = () => {
 *
 * Generators declare their modules via `factory.virtualModules()`.
 * */
-var virtualModules = (sourceFolder, { kind, command }) => {
+var virtualModules = (projectSettings, sourceFolder, { kind, command }) => {
 	/**
 	* Rollup's / Rolldown's convention for ids owned by a plugin:
 	* the NUL prefix keeps other plugins and Node resolution from touching them.
 	* */
 	const VIRTUAL_PREFIX = "\0";
-	const modules = sourceFolder.config.generators.flatMap(({ factory }) => {
-		return factory(sourceFolder).virtualModules?.() || [];
+	const modules = sourceFolder.generators.flatMap(({ factory }) => {
+		const { virtualModules } = factory(projectSettings, sourceFolder);
+		return virtualModules ? virtualModules(command) : [];
 	});
 	const virtualSources = /* @__PURE__ */ new Map();
 	for (const { specifier, csr, ssr } of modules) virtualSources.set(specifier, {
@@ -1503,7 +1632,21 @@ var vitePlugins = {
 var isFile = async (path) => {
 	return stat(path).then((e) => e.isFile()).catch(() => false);
 };
+var cacheDir = ({ root }, { name }, target) => {
+	return join(root, defaults.varDir, ".vite", name, target);
+};
+//#endregion
+//#region src/index.ts
+/**
+* Read the installed package.json at runtime to get the actual version.
+* A static import would be inlined by the bundler with the pre-bump version.
+*
+* INFO: For best compatibility, all packages should share the same version.
+* When bumping the version (even a patch) for a single package,
+* bump it for all packages to keep versions fully synchronized across the project.
+* */
+var { version: VERSION } = JSON.parse(readFileSync(createRequire(import.meta.url).resolve("@kosmojs/lib/package.json"), "utf-8"));
 //#endregion
-export { API_INDEX_BASENAME, API_INDEX_PATTERN, API_USE_BASENAME, API_USE_PATTERN, PAGE_INDEX_BASENAME, PAGE_INDEX_PATTERN, PAGE_LAYOUT_BASENAME, PAGE_LAYOUT_PATTERN, astFactory, containsPathTraversalPatterns, createAliasPatterns, createH3Pattern, createHonoPattern, createPathPattern, createRouteEntry, createWatchedApiRouteEntriesFilter, createWatchedPageRouteEntriesFilter, defineGenerator, defineGeneratorFactory, escapeTemplateLiterals, isApiRoute, isApiUse, isPageLayout, isPageRoute, isRouteFile, mergeConfigs, nestedRoutesFactory, pathExists, pathResolver, pathTokensFactory, render, renderFactory, renderToFile, routesFactory, scanRoutes, sortRoutes, sortRoutesForResolution, spinnerFactory, tsconfigPaths, virtualModules, vitePlugins };
+export { API_INDEX_BASENAME, API_INDEX_PATTERN, API_USE_BASENAME, API_USE_PATTERN, PAGE_INDEX_BASENAME, PAGE_INDEX_PATTERN, PAGE_LAYOUT_BASENAME, PAGE_LAYOUT_PATTERN, VERSION, astFactory, cacheDir, configFilePattern, containsPathTraversalPatterns, createAliasPatterns, createH3Pattern, createHonoPattern, createPathPattern, createRouteEntry, createWatchedApiRouteEntriesFilter, createWatchedPageRouteEntriesFilter, defineGenerator, defineGeneratorFactory, escapeTemplateLiterals, findFreePortRange, formatCode, generateTsconfig, isApiRoute, isApiUse, isPageLayout, isPageRoute, isPortFree, isRouteFile, mergeConfigs, nestedRoutesFactory, pathExists, pathResolver, pathTokensFactory, render, renderFactory, renderToFile, resolveHostAddress, routesFactory, scanRoutes, sortRoutes, sortRoutesForResolution, spinnerFactory, tsconfigPaths, virtualModules, vitePlugins };
 
 //# sourceMappingURL=index.js.map