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 路由场景的高级配置。