wayfinder-development

Wayfinder Development 技能致力於在 Inertia.js 環境中實現 Laravel 後端路由與 React 前端組件之間的無縫整合。該技能專為構建強大且型別安全的應用程式的開發者而設計，簡化了引用後端端點、處理控制器動作以及維持路由同步的流程。透過利用 Wayfinder 從 Laravel 路由生成 TypeScript 定義的能力，此技能有助於防止連結失效、提高開發效率，並確保應用程式堆疊中的導航模式保持一致。

• 支援直接從 @/actions/ 與 @/routes/ 導入控制器動作與命名路由。

• 支援型別安全的路由物件生成，包含 URL 建構、HTTP 方法處理與查詢參數管理。

• 透過 .form() 方法與 Inertia.js 表單組件原生整合，允許開發者直接從後端定義生成標準 HTML 表單的屬性。

• 透過 php artisan wayfinder:generate 等 CLI 指令自動化同步流程，保持 TypeScript 型別與 Laravel 路由表的一致性。

• 鼓勵使用命名導入而非預設導出以促進 Tree-shaking，從而優化套件大小與應用程式效能。

• 簡化複雜連結、導航結構與後端端點 API 呼叫的建立，同時維持嚴格的 TypeScript 標準。

• 請優先使用來自 @/actions/ 或 @/routes/ 的命名導入，以維持型別安全並受益於 Tree-shaking 優化。

• 在 Laravel 程式碼庫中變更路由後，務必執行 php artisan wayfinder:generate，確保前端型別定義準確無誤。

• 在開發嚴重依賴自動化表單屬性生成的應用程式時，請配合 generator 指令使用 --with-form 旗標。

• 利用路由物件提供的 .get()、.post()、.patch() 與 .delete() 方法，以確保 HTTP 動詞的一致性。

• 若導航或路由解析失敗，請確認 Vite 外掛是否設定正確，並檢查是否已重新生成路由定義。

• 結合 search-docs 以深入研究特定模式的實作與複雜 Laravel/Inertia 路由場景的進階配置。