feat: add static route gen

Author: mcquenji

.fvmrc

@@ -0,0 +1,3 @@
+{
+  "flutter": "stable"
+}

.github/workflows/linting.yaml

@@ -0,0 +1,31 @@
+name: Linting
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  lint:
+    name: Lint Check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 📚 Checkout code
+        uses: actions/checkout@v3
+
+      - name: 🐦 Set up Dart
+        uses: dart-lang/setup-dart@v1
+        with:
+          sdk: stable
+
+      - name: 📦 Install dependencies
+        run: dart pub get
+
+      - name: 🔍 Dart Analyze
+        uses: ValentinVignal/action-dart-analyze@v0.17
+        with:
+            fail-on: format

.github/workflows/tests.yaml

@@ -0,0 +1,44 @@
+name: Unit Tests
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  test:
+    name: Unit Testing
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 📚 Checkout code
+        uses: actions/checkout@v3
+
+      - name: 🐦 Set up Dart
+        uses: dart-lang/setup-dart@v1
+        with:
+          sdk: stable
+
+      - name: 📦 Install dependencies
+        run: dart pub get
+
+      - name: 🧪 Run Tests
+        run: dart test -r json > test-results.json
+        continue-on-error: true
+
+      - name: 📊 Upload Test Results
+        uses: actions/upload-artifact@v4.6.2
+        with:
+          name: test-results
+          path: test-results.json
+          
+      - name: 📝 Check Test Results
+        run: |
+          if grep -q '"result":"failure"' test-results.json; then
+            echo "❌ Tests failed"
+            exit 1
+          fi
+          echo "✅ All tests passed"

.gitignore

@@ -0,0 +1,10 @@
+# https://dart.dev/guides/libraries/private-files
+# Created by `dart pub`
+.dart_tool/
+
+# Avoid committing pubspec.lock for library packages; see
+# https://dart.dev/guides/libraries/private-files#pubspeclock.
+pubspec.lock
+
+# FVM Version Cache
+.fvm/

.vscode/settings.json

@@ -0,0 +1,4 @@
+{
+  "dart.flutterSdkPath": ".fvm/versions/stable",
+  "dart.sdkPath": ".fvm/flutter_sdk/bin/cache/dart-sdk"
+}

CHANGELOG.md

@@ -0,0 +1,3 @@
+## 1.0.0
+
+- Initial version.

README.md

@@ -0,0 +1,110 @@
+# grumpy_gen
+
+Source gen to enhance projects using [grumpy](https://github.com/necodeIT/grumpy) or [grumpy_flutter](https://github.com/necodeIT/grumpy_flutter).
+
+## Routes
+
+`grumpy_gen` can generate typed route helpers for any library that declares exactly one concrete `RootModule`.
+
+If the root also extends `AppModule`, the generated output includes Flutter navigation helpers on `BuildContext`. Otherwise it generates only the generic static path API.
+
+### Setup
+
+1. Add a `part` directive to the library that contains the root module.
+2. Run `dart run build_runner build`.
+
+Example:
+
+```dart
+import 'package:grumpy_flutter/grumpy_flutter.dart';
+
+part 'app.routes.dart';
+
+class App extends AppModule<AppConfig> {
+  App(super.cfg);
+
+  @override
+  List<FlutterRoute<AppConfig>> get routes => [
+    ModuleRoute(path: '/Settings', module: Settings()),
+    ScreenRoute(path: '/dashboard', view: DashboardScreen()),
+  ];
+
+  @override
+  Screen get notFoundScreen => NotFoundScreen();
+
+  @override
+  Widget buildApp() => const Widget();
+}
+```
+
+### Generated APIs
+
+For every `RootModule`, `grumpy_gen` emits a `GrumpyRoutes` static container with full-path strings.
+
+Example usage:
+
+```dart
+final dashboard = GrumpyRoutes.dashboard;
+final advancedSettings = GrumpyRoutes.settings.advanced;
+final settingsPrefix = GrumpyRoutes.settings.path;
+```
+
+For roots that also extend `AppModule`, `grumpy_gen` additionally emits a typed `BuildContext` extension:
+
+```dart
+context.to.dashboard();
+context.to.settings.advanced();
+context.to.users.id(userId).details();
+```
+
+Parameterized path segments are represented as explicit segment methods. A route like `/users/:id/details` becomes:
+
+```dart
+GrumpyRoutes.users.id(userId).details
+context.to.users.id(userId).details()
+```
+
+Module boundaries without a root leaf are still generated as typed namespace objects and expose `.path`, but Flutter `call()` is intentionally not generated for them.
+
+### What Gets Scanned
+
+The generator walks all routes reachable from the root and follows:
+
+- `LeafRoute`
+- `ScreenRoute`
+- `LeafRoute.root`
+- `ScreenRoute.root`
+- `ModuleRoute`
+- `ShellScreenRoute`
+- `Route.root([...])`
+
+Path joining follows the runtime router semantics:
+
+- `ShellScreenRoute` contributes no path segment
+- `ModuleRoute` descendants are rooted under the module boundary path
+- nested children are flattened into full absolute paths
+
+### Current Limitations
+
+Route generation is intentionally static in v1. The generator currently expects route trees to be declared with direct constructor calls and list literals.
+
+Supported:
+
+```dart
+@override
+List<FlutterRoute<AppConfig>> get routes => [
+  ScreenRoute(path: '/dashboard', view: DashboardScreen()),
+  ModuleRoute(path: '/slots', module: Slots()),
+];
+```
+
+Not supported:
+
+```dart
+@override
+List<FlutterRoute<AppConfig>> get routes => buildRoutes();
+```
+
+or route lists built with control flow or spreads.
+
+If a library contains multiple concrete `RootModule` implementations, generation fails with a clear error.

analysis_options.yaml

@@ -0,0 +1,30 @@
+# This file configures the static analysis results for your project (errors,
+# warnings, and lints).
+#
+# This enables the 'recommended' set of lints from `package:lints`.
+# This set helps identify many issues that may lead to problems when running
+# or consuming Dart code, and enforces writing Dart using a single, idiomatic
+# style and format.
+#
+# If you want a smaller set of lints you can change this to specify
+# 'package:lints/core.yaml'. These are just the most critical lints
+# (the recommended set includes the core lints).
+# The core lints are also what is used by pub.dev for scoring packages.
+
+include: package:lints/recommended.yaml
+
+# Uncomment the following section to specify additional rules.
+
+# linter:
+#   rules:
+#     - camel_case_types
+
+# analyzer:
+#   exclude:
+#     - path/to/excluded/files/**
+
+# For more information about the core and recommended set of lints, see
+# https://dart.dev/go/core-lints
+
+# For additional information about configuring this file, see
+# https://dart.dev/guides/language/analysis-options

build.yaml

@@ -0,0 +1,7 @@
+builders:
+  grumpy_routes:
+    import: "package:grumpy_gen/grumpy_gen.dart"
+    builder_factories: ["grumpyRoutesBuilder"]
+    build_extensions: { ".dart": [".routes.dart"] }
+    auto_apply: dependents
+    build_to: source

lib/grumpy_gen.dart

@@ -0,0 +1,13 @@
+library;
+
+export 'src/grumpy_flutter_routes.dart';
+export 'src/grumpy_routes.dart';
+export 'src/route_generation.dart'
+    show
+        BuildStepRouteAstResolver,
+        RouteAstResolver,
+        RouteGenerationSpec,
+        RoutePathNode,
+        analyzeRouteLibrary,
+        emitFlutterRoutes,
+        emitGenericRoutes;