Merge branch 'precognition-useform' into precognition-merge

Author: pascalbaljet

.github/workflows/playwright.yml renamed to .github/workflows/playwright-chromium.yml

@@ -1,8 +1,9 @@
-name: Playwright Tests
+name: Playwright Tests on Chromium
 on: [push, pull_request]
 jobs:
-  test:
+  test-chromium:
     if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository
+    name: Chromium (${{ matrix.adapter }})
     timeout-minutes: 15
     runs-on: ubuntu-24.04
     strategy:
@@ -29,12 +30,6 @@ jobs:
       - name: Build Inertia
         run: pnpm -r --filter ./packages/core --filter ./packages/${{ matrix.adapter }}* build
 
-      - name: Type-check test-app
-        run: cd packages/${{ matrix.adapter == 'vue' && 'vue3' || matrix.adapter }}/test-app && pnpm run type-check
-
-      - name: ESLint test-app
-        run: cd packages/${{ matrix.adapter == 'vue' && 'vue3' || matrix.adapter }}/test-app && pnpm run lint
-
       - name: Install Playwright Browsers
         run: pnpm playwright install chromium
 
@@ -45,5 +40,5 @@ jobs:
         if: failure()
         uses: actions/upload-artifact@v4
         with:
-          name: playwright-failure-screenshots-${{ matrix.adapter }}
+          name: playwright-failure-screenshots-${{ matrix.adapter }}-chromium
           path: test-results

.github/workflows/playwright-webkit.yml

@@ -0,0 +1,45 @@
+name: Playwright Tests on WebKit
+on: [push, pull_request]
+jobs:
+  test-webkit:
+    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository
+    name: WebKit (${{ matrix.adapter }} - shard ${{ matrix.shard }} of 4)
+    timeout-minutes: 15
+    runs-on: macos-15
+    strategy:
+      matrix:
+        adapter: ['vue', 'react', 'svelte']
+        shard: ['1', '2', '3', '4']
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 10
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22.14
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build Inertia
+        run: pnpm -r --filter ./packages/core --filter ./packages/${{ matrix.adapter }}* build
+
+      - name: Install Playwright Browsers
+        run: pnpm playwright install webkit
+
+      - name: Run Playwright Tests
+        run: pnpm test:${{ matrix.adapter }} --webkit --shard=${{ matrix.shard }}/4
+
+      - name: Upload failure screenshots
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-failure-screenshots-${{ matrix.adapter }}-webkit-shard-${{ matrix.shard }}
+          path: test-results

.github/workflows/test-app-quality.yml

@@ -0,0 +1,36 @@
+name: Test App Quality
+on: [push, pull_request]
+jobs:
+  test-app-quality:
+    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository
+    timeout-minutes: 15
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        adapter: ['vue', 'react', 'svelte']
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 10
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22.14
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build Inertia
+        run: pnpm -r --filter ./packages/core --filter ./packages/${{ matrix.adapter }}* build
+
+      - name: Type-check test-app
+        run: cd packages/${{ matrix.adapter == 'vue' && 'vue3' || matrix.adapter }}/test-app && pnpm run type-check
+
+      - name: ESLint test-app
+        run: cd packages/${{ matrix.adapter == 'vue' && 'vue3' || matrix.adapter }}/test-app && pnpm run lint

CHANGELOG.md

@@ -7,10 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 For changes prior to v1.0.0, see the [legacy releases](https://legacy.inertiajs.com/releases).
 
-## [Unreleased](https://github.com/inertiajs/inertia/compare/v2.2.15...master)
+## [Unreleased](https://github.com/inertiajs/inertia/compare/v2.2.16...master)
 
 - Nothing yet
 
+## [v2.2.16](https://github.com/inertiajs/inertia/compare/v2.2.15...v2.2.16) - 2025-11-13
+
+### What's Changed
+
+* Added test for `defaultValue` in Form component by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia/pull/2685
+* Prevent navigation on right-click on `<Link>` with `prefetch="click"` by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia/pull/2676
+* Export page component type for React adapter by [@skryukov](https://github.com/skryukov) in https://github.com/inertiajs/inertia/pull/2691
+* Switch `useContext` to `use` in `usePage()` hook by [@HichemTab-tech](https://github.com/HichemTab-tech) in https://github.com/inertiajs/inertia/pull/2680
+* Improve serialization in `formDataToObject()` when mixing numeric and non-numeric object keys by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia/pull/2692
+* Fix `InfiniteScroll` scroll preservation by [@skryukov](https://github.com/skryukov) in https://github.com/inertiajs/inertia/pull/2689
+* Export Inertia `App` component by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia/pull/2695
+* Ignore `preserveScroll` and `preserveState` when finding cached response by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia/pull/2694
+* Upgrade Express server for test apps to v5 by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia/pull/2693
+* Add WebKit browser testing to CI with Safari compatibility fixes by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia/pull/2696
+* Bump symfony/http-foundation from 7.3.4 to 7.3.7 in /playgrounds/vue3 by [@dependabot](https://github.com/dependabot)[bot] in https://github.com/inertiajs/inertia/pull/2697
+* Fix array keys misalignment in form data and query by [@skryukov](https://github.com/skryukov) in https://github.com/inertiajs/inertia/pull/2690
+
+**Full Changelog**: https://github.com/inertiajs/inertia/compare/v2.2.15...v2.2.16
+
 ## [v2.2.15](https://github.com/inertiajs/inertia/compare/v2.2.14...v2.2.15) - 2025-10-30
 
 ### What's Changed

package.json

@@ -22,9 +22,9 @@
     "type-check:test-app:react": "cd packages/react/test-app && pnpm run type-check",
     "type-check:test-app:svelte": "cd packages/svelte/test-app && pnpm run type-check",
     "type-check:test-app:vue": "cd packages/vue3/test-app && pnpm run type-check",
-    "test:react": "PACKAGE=react playwright test",
-    "test:svelte": "PACKAGE=svelte playwright test",
-    "test:vue": "PACKAGE=vue3 playwright test",
+    "test:react": "PACKAGE=react node playwright.js",
+    "test:svelte": "PACKAGE=svelte node playwright.js",
+    "test:vue": "PACKAGE=vue3 node playwright.js",
     "playground:react": "cd playgrounds/react && ./init.sh && composer run dev",
     "playground:svelte4": "cd playgrounds/svelte4 && ./init.sh && composer run dev",
     "playground:svelte5": "cd playgrounds/svelte5 && ./init.sh && composer run dev",
@@ -39,6 +39,6 @@
     "prettier-plugin-tailwindcss": "^0.6.14"
   },
   "optionalDependencies": {
-    "@rollup/rollup-linux-x64-gnu": "^4.52.5"
+    "@rollup/rollup-linux-x64-gnu": "^4.53.2"
   }
 }

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inertiajs/core",
-  "version": "2.2.15",
+  "version": "2.2.16",
   "license": "MIT",
   "description": "A framework for creating server-driven single page apps.",
   "contributors": [
@@ -54,8 +54,8 @@
   },
   "dependencies": {
     "@types/lodash-es": "^4.17.12",
-    "axios": "^1.13.1",
     "laravel-precognition": "^0.7.3",
+    "axios": "^1.13.2",
     "lodash-es": "^4.17.21",
     "qs": "^6.14.0"
   },
@@ -66,7 +66,7 @@
     "@types/qs": "^6.14.0",
     "es-check": "^9.4.4",
     "esbuild": "^0.25.12",
-    "esbuild-node-externals": "^1.18.0",
+    "esbuild-node-externals": "^1.19.1",
     "typescript": "^5.9.3"
   }
-}
+}

packages/core/src/domUtils.ts

@@ -1,4 +1,9 @@
 const elementInViewport = (el: HTMLElement) => {
+  if (el.offsetParent === null) {
+    // Element is not participating in layout (e.g., display: none)
+    return false
+  }
+
   const rect = el.getBoundingClientRect()
 
   // We check both vertically and horizontally for containers that scroll in either direction
@@ -73,9 +78,13 @@ export const getScrollableParent = (element: HTMLElement | null): HTMLElement |
 }
 
 export const getElementsInViewportFromCollection = (
-  referenceElement: HTMLElement,
   elements: HTMLElement[],
+  referenceElement?: HTMLElement,
 ): HTMLElement[] => {
+  if (!referenceElement) {
+    return elements.filter((element) => elementInViewport(element))
+  }
+
   const referenceIndex = elements.indexOf(referenceElement)
   const upwardElements: HTMLElement[] = []
   const downwardElements: HTMLElement[] = []
@@ -105,3 +114,13 @@ export const getElementsInViewportFromCollection = (
   // Reverse upward elements to maintain DOM order, then append downward elements
   return [...upwardElements.reverse(), ...downwardElements]
 }
+
+export const requestAnimationFrame = (cb: () => void, times: number = 1): void => {
+  window.requestAnimationFrame(() => {
+    if (times > 1) {
+      requestAnimationFrame(cb, times - 1)
+    } else {
+      cb()
+    }
+  })
+}

packages/core/src/files.ts

@@ -1,10 +1,13 @@
 import { FormDataConvertible, RequestPayload } from './types'
 
+export const isFile = (value: unknown): boolean =>
+  (typeof File !== 'undefined' && value instanceof File) ||
+  value instanceof Blob ||
+  (typeof FileList !== 'undefined' && value instanceof FileList && value.length > 0)
+
 export function hasFiles(data: RequestPayload | FormDataConvertible): boolean {
   return (
-    data instanceof File ||
-    data instanceof Blob ||
-    (data instanceof FileList && data.length > 0) ||
+    isFile(data) ||
     (data instanceof FormData && Array.from(data.values()).some((value) => hasFiles(value))) ||
     (typeof data === 'object' && data !== null && Object.values(data).some((value) => hasFiles(value)))
   )

packages/core/src/formData.ts

@@ -1,30 +1,37 @@
-import { FormDataConvertible } from './types'
+import type { FormDataConvertible, QueryStringArrayFormatOption } from './types'
 
 export const isFormData = (value: any): value is FormData => value instanceof FormData
 
 export function objectToFormData(
   source: Record<string, FormDataConvertible>,
   form: FormData = new FormData(),
   parentKey: string | null = null,
+  queryStringArrayFormat: QueryStringArrayFormatOption = 'brackets',
 ): FormData {
   source = source || {}
 
   for (const key in source) {
     if (Object.prototype.hasOwnProperty.call(source, key)) {
-      append(form, composeKey(parentKey, key), source[key])
+      append(form, composeKey(parentKey, key, 'indices'), source[key], queryStringArrayFormat)
     }
   }
 
   return form
 }
 
-function composeKey(parent: string | null, key: string): string {
-  return parent ? parent + '[' + key + ']' : key
+function composeKey(parent: string | null, key: string, format: QueryStringArrayFormatOption): string {
+  if (!parent) {
+    return key
+  }
+
+  return format === 'brackets' ? `${parent}[]` : `${parent}[${key}]`
 }
 
-function append(form: FormData, key: string, value: FormDataConvertible): void {
+function append(form: FormData, key: string, value: FormDataConvertible, format: QueryStringArrayFormatOption): void {
   if (Array.isArray(value)) {
-    return Array.from(value.keys()).forEach((index) => append(form, composeKey(key, index.toString()), value[index]))
+    return Array.from(value.keys()).forEach((index) =>
+      append(form, composeKey(key, index.toString(), format), value[index], format),
+    )
   } else if (value instanceof Date) {
     return form.append(key, value.toISOString())
   } else if (value instanceof File) {
@@ -41,5 +48,5 @@ function append(form: FormData, key: string, value: FormDataConvertible): void {
     return form.append(key, '')
   }
 
-  objectToFormData(value, form, key)
+  objectToFormData(value, form, key, format)
 }