@adonisjs/inertia 4.0.0-next.15 → 4.0.0-next.16

package/build/src/client/react/form.d.ts

@@ -0,0 +1,75 @@
+import React from 'react';
+import type { UserRegistry, InferRoutes } from '@tuyau/core/types';
+import { AreAllOptional } from '@poppinss/utils/types';
+import { Form as InertiaForm } from '@inertiajs/react';
+type Routes = InferRoutes<UserRegistry>;
+/**
+ * Get parameter tuple type for a route
+ */
+type ExtractParamsTuple<Route extends keyof Routes> = Routes[Route]['types']['paramsTuple'];
+/**
+ * Get parameter object type for a route
+ */
+type ExtractParamsObject<Route extends keyof Routes> = Routes[Route]['types']['params'];
+/**
+ * Get params format for a route
+ */
+type RouteParamsFormats<Route extends keyof Routes> = ExtractParamsObject<Route> extends Record<string, never> ? never : ExtractParamsTuple<Route> | ExtractParamsObject<Route>;
+/**
+ * Parameters required for route navigation with proper type safety.
+ */
+export type FormParams<Route extends keyof Routes> = {
+    route: Route;
+} & (RouteParamsFormats<Route> extends never ? {
+    params?: never;
+} : AreAllOptional<ExtractParamsObject<Route>> extends true ? {
+    params?: RouteParamsFormats<Route>;
+} : {
+    params: RouteParamsFormats<Route>;
+});
+/**
+ * Props for the Form component extending InertiaForm props
+ * with route-specific type safety and parameter validation.
+ */
+type FormProps<Route extends keyof Routes> = Omit<React.ComponentPropsWithoutRef<typeof InertiaForm>, 'action' | 'method'> & FormParams<Route>;
+/**
+ * Internal Form component implementation with forward ref support.
+ * Resolves route parameters and generates the appropriate URL and HTTP method
+ * for Inertia form submission.
+ */
+declare function FormInner<Route extends keyof Routes>(props: FormProps<Route>, ref?: React.ForwardedRef<React.ElementRef<typeof InertiaForm>>): React.JSX.Element;
+/**
+ * Type-safe Form component for Inertia.js form submissions.
+ *
+ * Provides compile-time route validation and automatic parameter type checking
+ * based on your application's route definitions. Automatically resolves the
+ * correct URL and HTTP method for each route.
+ *
+ * @example
+ * ```tsx
+ * // Form to a route without parameters
+ * <Form route="users.store">
+ *   {({ processing }) => (
+ *     <>
+ *       <input type="text" name="name" />
+ *       <button type="submit" disabled={processing}>Create</button>
+ *     </>
+ *   )}
+ * </Form>
+ *
+ * // Form to a route with required parameters
+ * <Form route="users.update" params={{ id: 1 }}>
+ *   {({ errors }) => (
+ *     <>
+ *       <input type="text" name="name" />
+ *       {errors.name && <div>{errors.name}</div>}
+ *       <button type="submit">Update</button>
+ *     </>
+ *   )}
+ * </Form>
+ * ```
+ */
+export declare const Form: <Route extends keyof Routes>(props: FormProps<Route> & {
+    ref?: React.Ref<React.ElementRef<typeof InertiaForm>>;
+}) => ReturnType<typeof FormInner>;
+export {};

package/build/src/client/react/index.d.ts

@@ -1,3 +1,4 @@
 export * from './context.tsx';
 export * from './router.ts';
 export * from './link.tsx';
+export * from './form.tsx';

package/build/src/client/react/index.js

@@ -1,5 +1,5 @@
 import React from "react";
-import { Link as Link$1, router } from "@inertiajs/react";
+import { Form as Form$1, Link as Link$1, router } from "@inertiajs/react";
 const TuyauContext = React.createContext(null);
 function TuyauProvider(props) {
 	return <TuyauContext.Provider value={props.client}>{props.children}</TuyauContext.Provider>;
@@ -21,9 +21,18 @@ function useRouter() {
 	} };
 }
 function LinkInner(props, ref) {
-	const { route, params, ...linkProps } = props;
+	const { route: _route, params, ...linkProps } = props;
 	const routeInfo = useTuyau().getRoute(props.route, { params });
 	return <Link$1 {...linkProps} href={routeInfo.url} method={routeInfo.methods[0].toLowerCase()} ref={ref} />;
 }
 const Link = React.forwardRef(LinkInner);
-export { Link, TuyauProvider, useRouter, useTuyau };
+function FormInner(props, ref) {
+	const { route: _route, params, ...formProps } = props;
+	const routeInfo = useTuyau().getRoute(props.route, { params });
+	return <Form$1 {...formProps} action={{
+		url: routeInfo.url,
+		method: routeInfo.methods[0].toLowerCase()
+	}} ref={ref} />;
+}
+const Form = React.forwardRef(FormInner);
+export { Form, Link, TuyauProvider, useRouter, useTuyau };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adonisjs/inertia",
   "description": "Official Inertia.js adapter for AdonisJS",
-  "version": "4.0.0-next.15",
+  "version": "4.0.0-next.16",
   "engines": {
     "node": ">=24.0.0"
   },
@@ -45,11 +45,11 @@
   "devDependencies": {
     "@adonisjs/assembler": "^8.0.0-next.27",
     "@adonisjs/core": "^7.0.0-next.16",
-    "@adonisjs/eslint-config": "^3.0.0-next.5",
+    "@adonisjs/eslint-config": "^3.0.0-next.6",
     "@adonisjs/prettier-config": "^1.4.5",
     "@adonisjs/session": "^8.0.0-next.1",
     "@adonisjs/tsconfig": "^2.0.0-next.3",
-    "@adonisjs/vite": "^5.1.0-next.0",
+    "@adonisjs/vite": "^5.1.0-next.2",
     "@inertiajs/react": "^2.3.4",
     "@japa/api-client": "^3.1.1",
     "@japa/assert": "4.2.0",
@@ -60,7 +60,7 @@
     "@japa/snapshot": "^2.0.10",
     "@poppinss/ts-exec": "^1.4.1",
     "@release-it/conventional-changelog": "^10.0.4",
-    "@tuyau/core": "^1.0.0-beta.7",
+    "@tuyau/core": "^1.0.0-beta.9",
     "@types/node": "^25.0.3",
     "@types/react": "^19.2.7",
     "@types/supertest": "^6.0.3",