@timber-js/app 0.2.0-alpha.112 → 0.2.0-alpha.113

package/dist/index.js

@@ -1979,6 +1979,52 @@ function timberMdx(ctx) {
 	};
 }
 //#endregion
+//#region src/routing/segment-codegen.ts
+/**
+* _segment type generation and directory-to-route mapping.
+*
+* Generates per-route _segment.d.ts files in .timber/types/ that mirror
+* the app/ directory structure. TypeScript's rootDirs feature makes these
+* importable as './_segment' from route files.
+*
+* Design doc: design/41-global-params.md §The _segment Module
+*/
+/**
+* Build a map of absolute filesystem directory → route pattern.
+* Used by resolveId to map a _segment import's importer to the correct route.
+*
+* Walks every segment (not just leaves) so layouts and middleware
+* at any depth can import _segment.
+*/
+function buildDirToRouteMap(tree, appDir) {
+	const map = /* @__PURE__ */ new Map();
+	function walk(node, fsPath) {
+		const routePattern = node.urlPath || "/";
+		map.set(fsPath, routePattern);
+		for (const child of node.children) walk(child, join(fsPath, child.segmentName));
+		for (const [slotName, slotNode] of Object.entries(node.slots)) walk(slotNode, join(fsPath, slotName));
+	}
+	walk(tree.root, appDir);
+	return map;
+}
+/**
+* Generate per-route _segment.d.ts files in .timber/types/ mirroring
+* the app/ directory structure. These files are importable via TypeScript's
+* rootDirs feature.
+*/
+async function writeSegmentTypes(routeTree, appDir, root) {
+	const typesBase = join(root, ".timber", "types", appDir.slice(root.length + 1));
+	const map = buildDirToRouteMap(routeTree, appDir);
+	const writes = [];
+	for (const [fsDir, routePattern] of map) {
+		const segmentDir = join(typesBase, fsDir.slice(appDir.length));
+		const segmentPath = join(segmentDir, "_segment.d.ts");
+		const content = `export const route: '${routePattern}';\n`;
+		writes.push(mkdir(segmentDir, { recursive: true }).then(() => writeFile(segmentPath, content, "utf-8")));
+	}
+	await Promise.all(writes);
+}
+//#endregion
 //#region src/routing/convention-lint.ts
 /**
 * Convention linter — validates common misconfigurations in the route tree.
@@ -2217,6 +2263,7 @@ var SEARCH_PARAMS_REGISTRY_ID = "virtual:timber-search-params-registry";
 var RESOLVED_SEARCH_PARAMS_REGISTRY_ID = `\0${SEARCH_PARAMS_REGISTRY_ID}`;
 var SCHEMA_ID = "virtual:timber-schema";
 var RESOLVED_SCHEMA_ID = `\0${SCHEMA_ID}`;
+var SEGMENT_PREFIX = "\0_segment:";
 /**
 * File convention names we track for changes that require manifest regeneration.
 */
@@ -2257,13 +2304,19 @@ function writeCodegen(ctx) {
 	});
 	const routesPath = join(ctx.root, CODEGEN_OUTPUT);
 	const envPath = join(ctx.root, "timber-env.d.ts");
-	mkdir(timberDir, { recursive: true }).then(() => Promise.all([writeFile(routesPath, content, "utf-8"), writeFile(envPath, TIMBER_ENV_DTS, "utf-8")])).catch((err) => {
+	mkdir(timberDir, { recursive: true }).then(() => Promise.all([
+		writeFile(routesPath, content, "utf-8"),
+		writeFile(envPath, TIMBER_ENV_DTS, "utf-8"),
+		writeSegmentTypes(ctx.routeTree, ctx.appDir, ctx.root)
+	])).catch((err) => {
 		console.warn("[timber] Failed to write codegen output:", err);
 	});
 }
 function timberRouting(ctx) {
 	/** Track warned files to avoid repeating warnings on rescan. */
 	const warnedFiles = /* @__PURE__ */ new Set();
+	/** Maps absolute filesystem directory → route pattern for _segment resolution. */
+	let dirToRoute = /* @__PURE__ */ new Map();
 	function rescan() {
 		const appDirWarning = checkAppDirExists(ctx.appDir);
 		if (appDirWarning) {
@@ -2281,6 +2334,7 @@ function timberRouting(ctx) {
 		ctx.timer.start("route-scan");
 		ctx.routeTree = scanRoutes(ctx.appDir, { pageExtensions: ctx.config.pageExtensions });
 		ctx.timer.end("route-scan");
+		dirToRoute = buildDirToRouteMap(ctx.routeTree, ctx.appDir);
 		writeCodegen(ctx);
 		warnUnregisteredSegments(ctx);
 		const newConventionWarnings = lintConventions(ctx.routeTree, ctx.appDir).filter((w) => !warnedFiles.has(w.id));
@@ -2292,12 +2346,18 @@ function timberRouting(ctx) {
 	}
 	return {
 		name: "timber-routing",
-		resolveId(id) {
+		resolveId(id, importer) {
 			const cleanId = id.startsWith("\0") ? id.slice(1) : id;
 			if (cleanId === VIRTUAL_MODULE_ID$1) return RESOLVED_VIRTUAL_ID$1;
 			if (cleanId.endsWith(`/${VIRTUAL_MODULE_ID$1}`)) return RESOLVED_VIRTUAL_ID$1;
 			if (cleanId === SEARCH_PARAMS_REGISTRY_ID || cleanId.endsWith(`/${SEARCH_PARAMS_REGISTRY_ID}`)) return RESOLVED_SEARCH_PARAMS_REGISTRY_ID;
 			if (cleanId === SCHEMA_ID || cleanId.endsWith(`/${SCHEMA_ID}`)) return RESOLVED_SCHEMA_ID;
+			if (importer && (cleanId === "./_segment" || cleanId === "./_segment.js" || cleanId === "./_segment.ts")) {
+				const cleanImporter = importer.startsWith("\0") ? importer.slice(1) : importer;
+				const importerDir = cleanImporter.substring(0, cleanImporter.lastIndexOf("/"));
+				const routePattern = dirToRoute.get(importerDir);
+				if (routePattern !== void 0) return `${SEGMENT_PREFIX}${routePattern}`;
+			}
 			return null;
 		},
 		load(id) {
@@ -2310,6 +2370,10 @@ function timberRouting(ctx) {
 				return generateSearchParamsRegistryModule(ctx.routeTree);
 			}
 			if (id === RESOLVED_SCHEMA_ID) return generateSchemaModule(ctx.appDir);
+			if (id.startsWith(SEGMENT_PREFIX)) {
+				const routePattern = id.slice(10);
+				return `export const route = ${JSON.stringify(routePattern)};\n`;
+			}
 			return null;
 		},
 		buildStart() {
@@ -2391,6 +2455,7 @@ function invalidateManifest(server) {
 			const mod = env.moduleGraph.getModuleById(virtualId);
 			if (mod) env.moduleGraph.invalidateModule(mod);
 		}
+		for (const mod of env.moduleGraph.idToModuleMap.values()) if (mod.id?.startsWith(SEGMENT_PREFIX)) env.moduleGraph.invalidateModule(mod);
 	}
 	server.hot.send({ type: "full-reload" });
 }