feat: export route utility types

Author: istiak-tridip

resources/function-arguments.blade.ts

@@ -23,4 +23,4 @@ args{!! when($parameters->every->optional, '?') !!}: {
 @endif
 ,
 @endif
-options?: { query?: QueryParams, mergeQuery?: QueryParams }
+options?: RouteQueryOptions

resources/js/wayfinder.ts

@@ -9,10 +9,21 @@ export type QueryParams = Record<
     | Record<string, string | number | boolean>
 >;
 
-export const queryParams = (options?: {
+export type RouteDefinition<TMethod extends string | string[]> = {
+    url: string;
+} & (TMethod extends string[] ? { methods: TMethod } : { method: TMethod });
+
+export type RouteFormDefinition<TMethod extends string> = {
+    action: string;
+    method: TMethod;
+};
+
+export type RouteQueryOptions = {
     query?: QueryParams;
     mergeQuery?: QueryParams;
-}) => {
+}
+
+export const queryParams = (options?: RouteQueryOptions) => {
     if (!options || (!options.query && !options.mergeQuery)) {
         return "";
     }

resources/method.blade.ts

@@ -1,16 +1,17 @@
 @include('wayfinder::docblock')
-{!! when(($export ?? true) && !$isInvokable, 'export ') !!}const {!! $method !!} = (@include('wayfinder::function-arguments')): {
-    url: string,
-    method: @js($verbs->first()->actual),
-} => ({
+{!! when(($export ?? true) && !$isInvokable, 'export ') !!}const {!! $method !!} = (@include('wayfinder::function-arguments')): RouteDefinition<@js($verbs->first()->actual)> => ({
     url: {!! $method !!}.url({!! when($parameters->isNotEmpty(), 'args, ') !!}options),
     method: @js($verbs->first()->actual),
 })
 
+@php
+    $verbsArray = $verbs->map(fn($verb) => $verb->actual)->join("','");
+@endphp
+
 {!! $method !!}.definition = {
-    methods: [@foreach ($verbs as $verb)@js($verb->actual){!! when(! $loop->last, ',') !!}@endforeach],
+    methods: ['{!! $verbsArray !!}'],
     url: {!! $uri !!},
-}
+} satisfies RouteDefinition<['{!! $verbsArray !!}']>
 
 @include('wayfinder::docblock')
 {!! $method !!}.url = (@include('wayfinder::function-arguments')) => {
@@ -69,21 +70,15 @@
 
 @foreach ($verbs as $verb)
 @include('wayfinder::docblock')
-{!! $method !!}.{!! $verb->actual !!} = (@include('wayfinder::function-arguments')): {
-    url: string,
-    method: @js($verb->actual),
-} => ({
+{!! $method !!}.{!! $verb->actual !!} = (@include('wayfinder::function-arguments')): RouteDefinition<@js($verb->actual)> => ({
     url: {!! $method !!}.url({!! when($parameters->isNotEmpty(), 'args, ') !!}options),
     method: @js($verb->actual),
 })
 @endforeach
 
 @if ($withForm)
     @include('wayfinder::docblock')
-    const {!! $method !!}Form = (@include('wayfinder::function-arguments')): {
-        action: string,
-        method: @js($verbs->first()->formSafe),
-    } => ({
+    const {!! $method !!}Form = (@include('wayfinder::function-arguments')): RouteFormDefinition<@js($verbs->first()->formSafe)> => ({
         action: {!! $method !!}.url(
             {!! when($parameters->isNotEmpty(), 'args, ') !!}
             @if ($verbs->first()->formSafe === $verbs->first()->actual)
@@ -102,10 +97,7 @@
 
     @foreach ($verbs as $verb)
         @include('wayfinder::docblock')
-        {!! $method !!}Form.{!! $verb->actual !!} = (@include('wayfinder::function-arguments')): {
-            action: string,
-            method: @js($verb->formSafe),
-        } => ({
+        {!! $method !!}Form.{!! $verb->actual !!} = (@include('wayfinder::function-arguments')): RouteFormDefinition<@js($verb->formSafe)> => ({
             action: {!! $method !!}.url(
                 {!! when($parameters->isNotEmpty(), 'args, ') !!}
                 @if ($verb->formSafe === $verb->actual)

src/GenerateCommand.php

@@ -222,7 +222,11 @@ private function writeNamedFile(Collection $routes, string $namespace): void
 
     private function appendCommonImports(Collection $routes, string $path, string $namespace): void
     {
-        $imports = ['queryParams', 'type QueryParams'];
+        $imports = ['queryParams', 'type RouteQueryOptions', 'type RouteDefinition'];
+
+        if ($this->option('with-form') === true) {
+            $imports[] = 'type RouteFormDefinition';
+        }
 
         if ($routes->contains(fn (Route $route) => $route->parameters()->contains(fn (Parameter $parameter) => $parameter->optional))) {
             $imports[] = 'validateParameters';