@adonisjs/inertia 4.0.0-next.1 → 4.0.0-next.11

package/build/src/plugins/japa/api_client.js

@@ -1,66 +1,51 @@
-import {
-  InertiaHeaders
-} from "../../../chunk-DISC5OYC.js";
-import "../../../chunk-MLKGABMK.js";
-
-// src/plugins/japa/api_client.ts
+import { t as InertiaHeaders } from "../../../headers-DafWEpBh.js";
 import { ApiRequest, ApiResponse } from "@japa/api-client";
 function ensureIsInertiaResponse() {
-  if (!this.header("x-inertia")) {
-    throw new Error(
-      'Not an Inertia response. Make sure to use "withInertia()" method when making the request'
-    );
-  }
+	if (!this.header("x-inertia")) throw new Error("Not an Inertia response. Make sure to use \"withInertia()\" method when making the request");
 }
 function ensureHasAssert(assertLib) {
-  if (!assertLib) {
-    throw new Error(
-      "Response assertions are not available. Make sure to install the @japa/assert plugin"
-    );
-  }
+	if (!assertLib) throw new Error("Response assertions are not available. Make sure to install the @japa/assert plugin");
 }
 function inertiaApiClient(app) {
-  return async () => {
-    const inertiaConfig = app.config.get("inertia");
-    ApiRequest.macro("withInertia", function() {
-      this.header(InertiaHeaders.Inertia, "true");
-      this.header(InertiaHeaders.Version, String(inertiaConfig.assetsVersion ?? "1"));
-      return this;
-    });
-    ApiRequest.macro("withInertiaPartialReload", function(component, data) {
-      this.withInertia();
-      this.header(InertiaHeaders.PartialComponent, component);
-      this.header(InertiaHeaders.PartialOnly, data.join(","));
-      return this;
-    });
-    ApiResponse.getter("inertiaComponent", function() {
-      ensureIsInertiaResponse.call(this);
-      return this.body().component;
-    });
-    ApiResponse.getter("inertiaProps", function() {
-      ensureIsInertiaResponse.call(this);
-      return this.body().props;
-    });
-    ApiResponse.macro("assertInertiaComponent", function(component) {
-      ensureIsInertiaResponse.call(this);
-      ensureHasAssert(this.assert);
-      this.assert.equal(this.body().component, component);
-      return this;
-    });
-    ApiResponse.macro("assertInertiaProps", function(props) {
-      ensureIsInertiaResponse.call(this);
-      ensureHasAssert(this.assert);
-      this.assert.deepEqual(this.body().props, props);
-      return this;
-    });
-    ApiResponse.macro("assertInertiaPropsContains", function(props) {
-      ensureIsInertiaResponse.call(this);
-      ensureHasAssert(this.assert);
-      this.assert.containSubset(this.body().props, props);
-      return this;
-    });
-  };
+	return async () => {
+		const inertiaConfig = app.config.get("inertia");
+		ApiRequest.macro("withInertia", function() {
+			this.header(InertiaHeaders.Inertia, "true");
+			this.header(InertiaHeaders.Version, String(inertiaConfig.assetsVersion ?? "1"));
+			return this;
+		});
+		ApiRequest.macro("withInertiaPartialReload", function(component, data) {
+			this.withInertia();
+			this.header(InertiaHeaders.PartialComponent, component);
+			this.header(InertiaHeaders.PartialOnly, data.join(","));
+			return this;
+		});
+		ApiResponse.getter("inertiaComponent", function() {
+			ensureIsInertiaResponse.call(this);
+			return this.body().component;
+		});
+		ApiResponse.getter("inertiaProps", function() {
+			ensureIsInertiaResponse.call(this);
+			return this.body().props;
+		});
+		ApiResponse.macro("assertInertiaComponent", function(component) {
+			ensureIsInertiaResponse.call(this);
+			ensureHasAssert(this.assert);
+			this.assert.equal(this.body().component, component);
+			return this;
+		});
+		ApiResponse.macro("assertInertiaProps", function(props) {
+			ensureIsInertiaResponse.call(this);
+			ensureHasAssert(this.assert);
+			this.assert.deepEqual(this.body().props, props);
+			return this;
+		});
+		ApiResponse.macro("assertInertiaPropsContains", function(props) {
+			ensureIsInertiaResponse.call(this);
+			ensureHasAssert(this.assert);
+			this.assert.containSubset(this.body().props, props);
+			return this;
+		});
+	};
 }
-export {
-  inertiaApiClient
-};
+export { inertiaApiClient };

package/build/src/props.d.ts

@@ -1,5 +1,6 @@
-import { type AsyncOrSync } from '@poppinss/utils/types';
+import { type AsyncOrSync } from '@adonisjs/core/types/common';
 import { type DeferProp, type PageProps, type AlwaysProp, type OptionalProp, type MergeableProp, type ComponentProps, type UnPackedPageProps } from './types.ts';
+import { type ContainerResolver } from '@adonisjs/core/container';
 /**
  * Creates a deferred prop that is never included in standard visits but must be shared with
  * the client during standard visits. Can be explicitly requested and supports merging.
@@ -138,9 +139,10 @@ export declare function deepMerge<T extends UnPackedPageProps | DeferProp<UnPack
  * This function is useful for runtime type checking and conditional prop handling.
  *
  * @param propValue - The object to check for deferred prop characteristics
+ * @returns True if the prop value is a deferred prop
  *
  * @example
- * ```javascript
+ * ```js
  * const prop = defer(() => ({ data: 'value' }))
  *
  * if (isDeferredProp(prop)) {
@@ -157,9 +159,10 @@ export declare function isDeferredProp<T extends UnPackedPageProps>(propValue: O
  * existing props rather than replaced during updates.
  *
  * @param propValue - The object to check for mergeable prop characteristics
+ * @returns True if the prop value is a mergeable prop
  *
  * @example
- * ```javascript
+ * ```js
  * const prop = merge({ items: [1, 2, 3] })
  *
  * if (isMergeableProp(prop)) {
@@ -176,9 +179,10 @@ export declare function isMergeableProp<T extends UnPackedPageProps | DeferProp<
  * responses, regardless of cherry-picking or selective prop requests.
  *
  * @param propValue - The object to check for always prop characteristics
+ * @returns True if the prop value is an always prop
  *
  * @example
- * ```javascript
+ * ```js
  * const prop = always({ userId: 123, permissions: ['read', 'write'] })
  *
  * if (isAlwaysProp(prop)) {
@@ -195,9 +199,10 @@ export declare function isAlwaysProp<T extends UnPackedPageProps>(propValue: Obj
  * when explicitly requested by the client, never in standard visits.
  *
  * @param propValue - The object to check for optional prop characteristics
+ * @returns True if the prop value is an optional prop
  *
  * @example
- * ```javascript
+ * ```js
  * const prop = optional(() => ({ detailedData: 'expensive computation' }))
  *
  * if (isOptionalProp(prop)) {
@@ -218,7 +223,8 @@ export declare function isOptionalProp<T extends UnPackedPageProps>(propValue: O
  * - Regular props: Included normally
  *
  * @param pageProps - The page props to process
- * @returns Object containing processed props, deferred props list, and merge props list
+ * @param containerResolver - Container resolver for dependency injection
+ * @returns Promise resolving to object containing processed props, deferred props list, and merge props list
  *
  * @example
  * ```js
@@ -230,7 +236,7 @@ export declare function isOptionalProp<T extends UnPackedPageProps>(propValue: O
  * // Returns: { props: { user: {...} }, deferredProps: { default: ['posts'] }, mergeProps: ['settings'] }
  * ```
  */
-export declare function buildStandardVisitProps(pageProps: PageProps): Promise<{
+export declare function buildStandardVisitProps(pageProps: PageProps, containerResolver: ContainerResolver<any>): Promise<{
     props: ComponentProps;
     mergeProps: string[];
     deepMergeProps: string[];
@@ -250,7 +256,8 @@ export declare function buildStandardVisitProps(pageProps: PageProps): Promise<{
  *
  * @param pageProps - The page props to process
  * @param cherryPickProps - Array of prop names to include
- * @returns Object containing processed props and merge props list
+ * @param containerResolver - Container resolver for dependency injection
+ * @returns Promise resolving to object containing processed props and merge props list
  *
  * @example
  * ```js
@@ -261,7 +268,7 @@ export declare function buildStandardVisitProps(pageProps: PageProps): Promise<{
  * // Returns: { props: { posts: [...], stats: [...] }, mergeProps: [], deferredProps: {} }
  * ```
  */
-export declare function buildPartialRequestProps(pageProps: PageProps, cherryPickProps: string[]): Promise<{
+export declare function buildPartialRequestProps(pageProps: PageProps, cherryPickProps: string[], containerResolver: ContainerResolver<any>): Promise<{
     props: ComponentProps;
     mergeProps: string[];
     deepMergeProps: string[];

package/build/src/server_renderer.d.ts

@@ -36,7 +36,7 @@ export declare class ServerRenderer {
      * @returns Promise resolving to an object with rendered head and body HTML
      *
      * @example
-     * ```typescript
+     * ```js
      * const pageObject = {
      *   component: 'Home',
      *   props: { user: { name: 'John' } },
@@ -47,7 +47,7 @@ export declare class ServerRenderer {
      * const { head, body } = await renderer.render(pageObject)
      * ```
      */
-    render(pageObject: PageObject): Promise<{
+    render(pageObject: PageObject<any>): Promise<{
         head: string[];
         body: string;
     }>;

package/build/src/types.d.ts

@@ -1,37 +1,30 @@
 import type { HttpContext } from '@adonisjs/core/http';
 import { type ContainerResolver } from '@adonisjs/core/container';
 import type { JSONDataTypes } from '@adonisjs/core/types/transformers';
-import type { AsyncOrSync, DeepPartial, Prettify } from '@poppinss/utils/types';
+import type { AsyncOrSync, DeepPartial, Prettify } from '@adonisjs/core/types/common';
 import { type DEEP_MERGE, type ALWAYS_PROP, type OPTIONAL_PROP, type TO_BE_MERGED, type DEFERRED_PROP } from './symbols.ts';
 /**
- * Representation of a resource item, collection and paginator that can be serialized
+ * Representation of a resource item, collection and paginator that can be resolved to
+ * get normalized objects
  *
- * @template T - The type that the serializable object resolves to
+ * @template T - The type that the resource resolves to
  */
-export type SerializableOf<T> = {
-    /**
-     * Serializes the object using the container resolver
-     *
-     * @param container - The container resolver instance
-     * @param depth - Current serialization depth
-     * @param maxDepth - Maximum allowed serialization depth
-     * @returns Promise that resolves to the serialized object
-     */
-    serialize(container: ContainerResolver<any>, depth: number, maxDepth?: number): Promise<T>;
+export type ResolvableOf<T> = {
+    resolve(container: ContainerResolver<any>, depth: number, maxDepth?: number): Promise<T>;
 };
 /**
  * Union type representing unpacked page prop values that can be either JSON data or serializable objects
  *
  * @template T - The JSON data type, defaults to JSONDataTypes
  */
-export type UnPackedPageProps<T extends JSONDataTypes = JSONDataTypes> = T | SerializableOf<T>;
+export type UnPackedPageProps<T extends JSONDataTypes = JSONDataTypes> = T | ResolvableOf<T>;
 /**
  * Utility type that extracts the resolved type from a SerializableOf wrapper
  * If the type is already unwrapped, returns it as-is
  *
  * @template T - The type to unwrap, potentially wrapped in SerializableOf
  */
-export type UnpackProp<T> = T extends SerializableOf<infer A> ? A : T;
+export type UnpackProp<T> = T extends ResolvableOf<infer A> ? A : T;
 /**
  * Information extracted from Inertia request headers
  * Contains metadata about the current request type and filtering preferences
@@ -117,13 +110,13 @@ type PagePropsLazyDataTypes<T extends JSONDataTypes> =
  * - Can be explicitly requested for
  * - Can be dropped during cherry-picking
  */
-DeferProp<T | SerializableOf<T>>
+DeferProp<T | ResolvableOf<T>>
 /**
  * - Never included on standard visit
  * - Can be explicitly requested for
  * - Can be dropped during cherry-picking
  */
- | OptionalProp<T | SerializableOf<T>>;
+ | OptionalProp<T | ResolvableOf<T>>;
 /**
  * Eager props are always included during standard Inertia visits, but
  * can be removed via cherry-picking when only specific props are requested
@@ -140,17 +133,17 @@ T
  * - Always included on standard visit.
  * - Can be dropped during cherry-picking
  */
- | SerializableOf<T>
+ | ResolvableOf<T>
 /**
  * - Always included on standard visit.
  * - Can be dropped during cherry-picking
  */
- | (() => AsyncOrSync<T | SerializableOf<T>>)
+ | (() => AsyncOrSync<T | ResolvableOf<T>>)
 /**
  * - Always included on standard visit
  * - Cannot be dropped during cherry-picking
  */
- | AlwaysProp<T | SerializableOf<T>>;
+ | AlwaysProp<T | ResolvableOf<T>>;
 /**
  * Following is the list of acceptable Page props data types
  * Combines both eager and lazy prop data types for comprehensive prop handling
@@ -175,7 +168,7 @@ export type ComponentProps = Record<string, JSONDataTypes>;
  * @template Props - The page props object type to analyze
  */
 export type GetOptionalProps<Props> = {
-    [K in keyof Props]: Props[K] extends OptionalProp<any> ? K : Props[K] extends DeferProp<any> ? K : [undefined] extends Props[K] ? K : Props[K] extends MergeableProp<infer A> ? A extends DeferProp<any> ? K : never : never;
+    [K in keyof Props]: Props[K] extends OptionalProp<any> ? K : Props[K] extends DeferProp<any> ? K : [undefined] extends [Props[K]] ? K : Props[K] extends MergeableProp<infer A> ? A extends DeferProp<any> ? K : never : never;
 }[keyof Props];
 /**
  * Utility type to extract required prop keys from a props object
@@ -184,7 +177,7 @@ export type GetOptionalProps<Props> = {
  * @template Props - The page props object type to analyze
  */
 export type GetRequiredProps<Props> = {
-    [K in keyof Props]: Props[K] extends OptionalProp<any> ? never : Props[K] extends DeferProp<any> ? never : [undefined] extends Props[K] ? never : Props[K] extends MergeableProp<infer A> ? A extends DeferProp<any> ? never : K : K;
+    [K in keyof Props]: Props[K] extends OptionalProp<any> ? never : Props[K] extends DeferProp<any> ? never : [undefined] extends [Props[K]] ? never : Props[K] extends MergeableProp<infer A> ? A extends DeferProp<any> ? never : K : K;
 }[keyof Props];
 /**
  * Utility type to simplify value of a required prop by unwrapping branded types
@@ -242,10 +235,6 @@ export type InertiaConfig = {
      * application
      */
     rootView: string | ((ctx: HttpContext) => string);
-    /**
-     * The entrypoint file to load in order to boot the frontend application.
-     */
-    entrypoint: string;
     /**
      * A fixed asset version value to use. Otherwise, it will be read from the
      * Vite manifest file.
@@ -290,7 +279,7 @@ export type InertiaConfigInput = DeepPartial<InertiaConfig>;
  *
  * @template Props - The props type for the page component
  */
-export type PageObject<Props extends PageProps = PageProps> = {
+export type PageObject<Props> = {
     /**
      * The name/path of the component to render
      */
@@ -373,7 +362,7 @@ export interface InertiaPages {
  * @param page - The page object containing component and props data
  * @returns Promise resolving to an object with head tags and body HTML
  */
-export type RenderInertiaSsrApp = (page: PageObject) => Promise<{
+export type RenderInertiaSsrApp = (page: PageObject<any>) => Promise<{
     head: string[];
     body: string;
 }>;

package/build/src/types.js

@@ -0,0 +1 @@
+export {};

package/build/tests/types/react.spec.d.ts

@@ -0,0 +1,65 @@
+declare const routes: {
+    readonly 'users.index': {
+        readonly methods: ["GET", "HEAD"];
+        readonly pattern: "/";
+        readonly tokens: [{
+            readonly old: "/";
+            readonly type: 0;
+            readonly val: "/";
+            readonly end: "";
+        }];
+        readonly types: {
+            body: {};
+            paramsTuple: [];
+            params: {};
+            query: {};
+            response: unknown;
+        };
+    };
+    readonly 'users.comments.edit': {
+        readonly methods: ["GET", "HEAD"];
+        readonly pattern: "/users/:id/comments/:comment_id/edit";
+        readonly tokens: [{
+            readonly old: "/users";
+            readonly type: 0;
+            readonly val: "users";
+            readonly end: "/";
+        }, {
+            readonly old: ":id";
+            readonly type: 1;
+            readonly val: "id";
+            readonly end: "/";
+        }, {
+            readonly old: "/comments";
+            readonly type: 0;
+            readonly val: "comments";
+            readonly end: "/";
+        }, {
+            readonly old: ":comment_id";
+            readonly type: 1;
+            readonly val: "comment_id";
+            readonly end: "/edit";
+        }, {
+            readonly old: "/edit";
+            readonly type: 0;
+            readonly val: "edit";
+            readonly end: "";
+        }];
+        readonly types: {
+            body: {};
+            paramsTuple: [string, string];
+            params: {
+                id: string;
+                comment_id: string;
+            };
+            query: {};
+            response: unknown;
+        };
+    };
+};
+declare module '@tuyau/core/types' {
+    type Registry = typeof routes;
+    interface UserRegistry extends Registry {
+    }
+}
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adonisjs/inertia",
   "description": "Official Inertia.js adapter for AdonisJS",
-  "version": "4.0.0-next.1",
+  "version": "4.0.0-next.11",
   "engines": {
     "node": ">=24.0.0"
   },
@@ -18,6 +18,8 @@
     "./plugins/edge": "./build/src/plugins/edge/plugin.js",
     "./plugins/api_client": "./build/src/plugins/japa/api_client.js",
     "./vite": "./build/src/client/vite.js",
+    "./helpers": "./build/src/client/helpers.js",
+    "./react": "./build/src/client/react/index.js",
     "./factories": "./build/factories/main.js"
   },
   "scripts": {
@@ -25,7 +27,7 @@
     "test": "c8 npm run quick:test",
     "typecheck": "tsc --noEmit",
     "clean": "del-cli build",
-    "compile": "tsup-node && tsc --emitDeclarationOnly --declaration",
+    "compile": "tsdown && tsc --emitDeclarationOnly --declaration",
     "copy:templates": "copyfiles --up 1 \"stubs/**/*.stub\" build",
     "prebuild": "npm run lint && npm run clean",
     "build": "npm run compile",
@@ -41,13 +43,14 @@
     "docs": "typedoc"
   },
   "devDependencies": {
-    "@adonisjs/assembler": "^8.0.0-next.9",
-    "@adonisjs/core": "^7.0.0-next.1",
-    "@adonisjs/eslint-config": "^3.0.0-next.1",
+    "@adonisjs/assembler": "^8.0.0-next.14",
+    "@adonisjs/core": "^7.0.0-next.10",
+    "@adonisjs/eslint-config": "^3.0.0-next.4",
     "@adonisjs/prettier-config": "^1.4.5",
     "@adonisjs/session": "^8.0.0-next.0",
-    "@adonisjs/tsconfig": "^2.0.0-next.0",
-    "@adonisjs/vite": "^5.0.1-next.0",
+    "@adonisjs/tsconfig": "^2.0.0-next.3",
+    "@adonisjs/vite": "^5.1.0-next.0",
+    "@inertiajs/react": "^2.2.19",
     "@japa/api-client": "^3.1.0",
     "@japa/assert": "4.1.1",
     "@japa/expect-type": "^2.0.3",
@@ -56,22 +59,25 @@
     "@japa/runner": "4.4.0",
     "@japa/snapshot": "^2.0.9",
     "@poppinss/ts-exec": "^1.4.1",
-    "@release-it/conventional-changelog": "^10.0.1",
-    "@types/node": "^24.3.1",
+    "@release-it/conventional-changelog": "^10.0.2",
+    "@tuyau/core": "^1.0.0-beta.1",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.7",
     "@types/supertest": "^6.0.3",
     "c8": "^10.1.3",
     "copyfiles": "^2.4.1",
-    "cross-env": "^10.0.0",
-    "del-cli": "^6.0.0",
+    "cross-env": "^10.1.0",
+    "del-cli": "^7.0.0",
     "edge.js": "^6.3.0",
-    "eslint": "^9.35.0",
+    "eslint": "^9.39.1",
     "get-port": "^7.1.0",
-    "prettier": "^3.6.2",
-    "release-it": "^19.0.4",
+    "prettier": "^3.7.3",
+    "react": "^19.2.0",
+    "release-it": "^19.0.6",
     "supertest": "^7.1.4",
-    "tsup": "^8.5.0",
-    "typescript": "~5.9.2",
-    "vite": "^7.1.5"
+    "tsdown": "^0.17.0-beta.4",
+    "typescript": "~5.9.3",
+    "vite": "^7.2.6"
   },
   "dependencies": {
     "@poppinss/utils": "^7.0.0-next.3",
@@ -79,13 +85,16 @@
     "html-entities": "^2.6.0"
   },
   "peerDependencies": {
-    "@adonisjs/assembler": "^8.0.0-next.7",
-    "@adonisjs/core": "^7.0.0-next.0",
+    "@adonisjs/assembler": "^8.0.0-next.14",
+    "@adonisjs/core": "^7.0.0-next.10",
     "@adonisjs/session": "^8.0.0-next.0",
-    "@adonisjs/vite": "^5.0.1-next.0",
+    "@adonisjs/vite": "^5.1.0-next.0",
+    "@inertiajs/react": "^2.2.15",
     "@japa/api-client": "^3.1.0",
     "@japa/plugin-adonisjs": "^5.0.0-next.0",
-    "edge.js": "^6.0.0"
+    "@tuyau/core": "^1.0.0-beta.1",
+    "edge.js": "^6.0.0",
+    "react": "^19.2.0"
   },
   "peerDependenciesMeta": {
     "@adonisjs/assembler": {
@@ -96,6 +105,15 @@
     },
     "@japa/plugin-adonisjs": {
       "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "@tuyau/core": {
+      "optional": true
+    },
+    "@inertiajs/react": {
+      "optional": true
     }
   },
   "keywords": [
@@ -132,8 +150,7 @@
     },
     "npm": {
       "publish": true,
-      "skipChecks": true,
-      "tag": "latest"
+      "skipChecks": true
     },
     "plugins": {
       "@release-it/conventional-changelog": {
@@ -143,21 +160,26 @@
       }
     }
   },
-  "tsup": {
+  "tsdown": {
     "entry": [
       "./index.ts",
       "./src/types.ts",
       "./src/client/vite.ts",
+      "./src/client/helpers.ts",
       "./factories/main.ts",
       "./src/inertia_middleware.ts",
       "./providers/inertia_provider.ts",
       "./src/plugins/edge/plugin.ts",
-      "./src/plugins/japa/api_client.ts"
+      "./src/plugins/japa/api_client.ts",
+      "./src/client/react/index.tsx"
     ],
     "outDir": "./build",
     "clean": true,
     "format": "esm",
+    "minify": "dce-only",
+    "fixedExtension": false,
     "dts": false,
+    "treeshake": false,
     "sourcemaps": false,
     "target": "esnext"
   },

package/build/chunk-4EZ2J6OA.js

@@ -1,7 +0,0 @@
-// src/debug.ts
-import { debuglog } from "util";
-var debug_default = debuglog("adonisjs:inertia");
-
-export {
-  debug_default
-};