@teardown/navigation 2.0.78 → 2.0.80

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@teardown/navigation",
-	"version": "2.0.78",
+	"version": "2.0.80",
 	"description": "Type-safe file-based navigation for React Native",
 	"private": false,
 	"publishConfig": {
@@ -72,7 +72,7 @@
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.3.11",
-		"@teardown/tsconfig": "2.0.78",
+		"@teardown/tsconfig": "2.0.80",
 		"@types/react": "19.2.7",
 		"typescript": "5.9.3"
 	}

package/src/router/create-router.tsx

@@ -15,11 +15,16 @@ import { isHierarchicalRouteTree } from "./types";
 let createBottomTabNavigator: (() => ReturnType<typeof createNativeStackNavigator>) | null = null;
 let createDrawerNavigator: (() => ReturnType<typeof createNativeStackNavigator>) | null = null;
 
+// Track which navigators are available
+let bottomTabsAvailable = false;
+let drawerAvailable = false;
+
 // Try to load optional dependencies
 try {
 	// eslint-disable-next-line @typescript-eslint/no-require-imports
 	const bottomTabs = require("@react-navigation/bottom-tabs");
 	createBottomTabNavigator = bottomTabs.createBottomTabNavigator;
+	bottomTabsAvailable = true;
 } catch {
 	// Bottom tabs not installed
 }
@@ -28,10 +33,57 @@ try {
 	// eslint-disable-next-line @typescript-eslint/no-require-imports
 	const drawer = require("@react-navigation/drawer");
 	createDrawerNavigator = drawer.createDrawerNavigator;
+	drawerAvailable = true;
 } catch {
 	// Drawer not installed
 }
 
+/**
+ * Recursively checks a navigator node tree for required navigator types
+ */
+function collectRequiredNavigatorTypes(node: NavigatorNode, types: Set<"tabs" | "drawer">): void {
+	if (node.type === "tabs") {
+		types.add("tabs");
+	} else if (node.type === "drawer") {
+		types.add("drawer");
+	}
+
+	// Check nested navigators
+	if (node.navigators) {
+		for (const nestedNode of Object.values(node.navigators)) {
+			collectRequiredNavigatorTypes(nestedNode, types);
+		}
+	}
+}
+
+/**
+ * Validates that required navigator dependencies are installed and throws if not
+ */
+function validateNavigatorDependencies(routeTree: NavigatorNode): void {
+	const requiredTypes = new Set<"tabs" | "drawer">();
+	collectRequiredNavigatorTypes(routeTree, requiredTypes);
+
+	const missingDeps: string[] = [];
+
+	if (requiredTypes.has("tabs") && !bottomTabsAvailable) {
+		missingDeps.push(
+			"Your route tree uses tabs navigation but @react-navigation/bottom-tabs is not installed.\n" +
+				"  Install it with: npm install @react-navigation/bottom-tabs"
+		);
+	}
+
+	if (requiredTypes.has("drawer") && !drawerAvailable) {
+		missingDeps.push(
+			"Your route tree uses drawer navigation but @react-navigation/drawer is not installed.\n" +
+				"  Install it with: npm install @react-navigation/drawer react-native-gesture-handler react-native-reanimated"
+		);
+	}
+
+	if (missingDeps.length > 0) {
+		throw new Error(`[@teardown/navigation] Missing required navigation dependencies:\n\n${missingDeps.join("\n\n")}`);
+	}
+}
+
 /**
  * Options for creating a Teardown router
  */
@@ -76,18 +128,18 @@ function createNavigator(type: "stack" | "tabs" | "drawer") {
 	switch (type) {
 		case "tabs":
 			if (!createBottomTabNavigator) {
-				console.warn(
-					"[@teardown/navigation] Tab navigator requested but @react-navigation/bottom-tabs is not installed. Falling back to stack."
+				throw new Error(
+					"[@teardown/navigation] Tab navigator requested but @react-navigation/bottom-tabs is not installed.\n" +
+						"Install it with: npm install @react-navigation/bottom-tabs"
 				);
-				return createNativeStackNavigator();
 			}
 			return createBottomTabNavigator();
 		case "drawer":
 			if (!createDrawerNavigator) {
-				console.warn(
-					"[@teardown/navigation] Drawer navigator requested but @react-navigation/drawer is not installed. Falling back to stack."
+				throw new Error(
+					"[@teardown/navigation] Drawer navigator requested but @react-navigation/drawer is not installed.\n" +
+						"Install it with: npm install @react-navigation/drawer react-native-gesture-handler react-native-reanimated"
 				);
-				return createNativeStackNavigator();
 			}
 			return createDrawerNavigator();
 		default:
@@ -197,6 +249,9 @@ export function createTeardownRouter<T extends NavigatorNode | FlatRouteTree>(
 
 	// Check if this is a hierarchical route tree
 	if (isHierarchicalRouteTree(routeTree)) {
+		// Validate that required navigator dependencies are installed (warns early)
+		validateNavigatorDependencies(routeTree);
+
 		// Set initial route name if provided
 		const treeWithInitial: NavigatorNode = {
 			...routeTree,