Can't get Inertia.js <Head> and <Link> components to autoimport #872

osbre · 2025-08-04T11:09:55Z

osbre
Aug 4, 2025

I started a new Laravel project with Vue. I'm also using AutoImport.

Components({
    dirs: ['resources/js/Components', 'resources/js/Layouts'],
    dts: 'resources/js/types/components.d.ts',
    allowOverrides: false,
    resolvers: [
        // @inertiajs/vue3 resolver
        {
            type: 'component',
            resolve: (name) => {
                if (name === 'Head' || name === 'Link') {
                    return { importName: name, path: '@inertiajs/vue3' }
                }
            }
        },
        VueUseComponentsResolver,
        VueUseDirectiveResolver,
    ],
}),

Full config if relevant

<template>
    <Head title="Profile" />

    <GuestLayout>
        <h1>Welcome</h1>
    </GuestLayout>
</template>

Unfortunately, the <Head> component simply does not appear in my components.d.ts file.

/* eslint-disable */
// @ts-nocheck
// Generated by unplugin-vue-components
// Read more: https://github.com/vuejs/core/pull/3399
// biome-ignore lint: disable
export {}

/* prettier-ignore */
declare module 'vue' {
  export interface GlobalComponents {
    GuestLayout: typeof import('./../Layouts/GuestLayout.vue')['default']
  }
}

Does anyone know what could be the cause?

ilyaliao · 2025-08-04T15:05:04Z

ilyaliao
Aug 4, 2025
Maintainer

You need to return either { importName: name, name, path: '@inertiajs/vue3' } or { name, as: name, from: '@inertiajs/vue3' }.

4 replies

osbre Aug 4, 2025
Author

Tried both, the Vite process stops and I get this error:

[vite] Internal server error: Failed to resolve import "undefined" from "resources/js/Pages/Example/Index.vue". Does the file exist?

TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string. Received undefined

> vite


VITE v7.0.5  ready in 826 ms

➜  Local:   http://localhost:5173/
➜  Network: http://192.168.1.120:5173/
➜  press h + enter to show help

LARAVEL v12.21.0  plugin v2.0.0

➜  APP_URL: http://localhost:8080
17:43:29 [vite] Internal server error: Failed to resolve import "undefined" from "resources/js/Pages/Example/Index.vue". Does the file exist?
Plugin: vite:import-analysis
File: /Users/me/code/laravel-project/resources/js/Pages/Example/Index.vue:2:37
1  |  /* unplugin-vue-components disabled */import __unplugin_components_1 from '/Users/me/code/laravel-project/resources/js/Layouts/GuestLayout.vue';
2  |  import __unplugin_components_0 from 'undefined';
|                                       ^
3  |  import { useTranslations } from '@/Composables/useTranslations'
4  |
at TransformPluginContext._formatLog (file:///Users/me/code/laravel-project/node_modules/vite/dist/node/chunks/dep-Bg4HVnP5.js:31470:43)
at TransformPluginContext.error (file:///Users/me/code/laravel-project/node_modules/vite/dist/node/chunks/dep-Bg4HVnP5.js:31467:14)
at normalizeUrl (file:///Users/me/code/laravel-project/node_modules/vite/dist/node/chunks/dep-Bg4HVnP5.js:30010:18)
at async file:///Users/me/code/laravel-project/node_modules/vite/dist/node/chunks/dep-Bg4HVnP5.js:30068:32
at async Promise.all (index 1)
at async TransformPluginContext.transform (file:///Users/me/code/laravel-project/node_modules/vite/dist/node/chunks/dep-Bg4HVnP5.js:30036:4)
at async EnvironmentPluginContainer.transform (file:///Users/me/code/laravel-project/node_modules/vite/dist/node/chunks/dep-Bg4HVnP5.js:31284:14)
at async loadAndTransform (file:///Users/me/code/laravel-project/node_modules/vite/dist/node/chunks/dep-Bg4HVnP5.js:26454:26)
node:path:1247
validateString(path, 'path');
^

TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string. Received undefined
at isAbsolute (node:path:1247:5)
at stringifyComponentInfo (file:///Users/me/code/laravel-project/node_modules/unplugin-vue-components/dist/src-B9aLSEVj.js:72:18)
at file:///Users/me/code/laravel-project/node_modules/unplugin-vue-components/dist/src-B9aLSEVj.js:82:53
at Array.map (<anonymous>)
at stringifyComponentsInfo (file:///Users/me/code/laravel-project/node_modules/unplugin-vue-components/dist/src-B9aLSEVj.js:82:39)
at getDeclarationImports (file:///Users/me/code/laravel-project/node_modules/unplugin-vue-components/dist/src-B9aLSEVj.js:86:20)
at getDeclaration (file:///Users/me/code/laravel-project/node_modules/unplugin-vue-components/dist/src-B9aLSEVj.js:105:18)
at writeDeclaration (file:///Users/me/code/laravel-project/node_modules/unplugin-vue-components/dist/src-B9aLSEVj.js:144:15) {
code: 'ERR_INVALID_ARG_TYPE'
}

Node.js v23.9.0
 ELIFECYCLE  Command failed with exit code 1.

My current resolver:

{
    type: 'component',
    resolve: (name) => {
        if (name === 'Head' || name === 'Link') {
            return { importName: name, name, path: '@inertiajs/vue3' }
        }
    }
},

osbre Aug 4, 2025
Author

Ha, just found that I'm getting the same error when using HeadlessUiResolver. Starting to think it could be due to my tsconfig or something else.

osbre Aug 4, 2025
Author

Relevant issue with the same error:
#764

ilyaliao Aug 5, 2025
Maintainer

Could you give me a minimal reproduction? I can take a look.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Can't get Inertia.js <Head> and <Link> components to autoimport #872

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Replies: 1 comment 4 replies

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Uh oh!

Can't get Inertia.js <Head> and <Link> components to autoimport #872

Uh oh!

Uh oh!

osbre Aug 4, 2025

Replies: 1 comment · 4 replies

Uh oh!

ilyaliao Aug 4, 2025 Maintainer

Uh oh!

Uh oh!

osbre Aug 4, 2025 Author

Uh oh!

Uh oh!

osbre Aug 4, 2025 Author

Uh oh!

osbre Aug 4, 2025 Author

Uh oh!

ilyaliao Aug 5, 2025 Maintainer

osbre
Aug 4, 2025

Replies: 1 comment 4 replies

ilyaliao
Aug 4, 2025
Maintainer

osbre Aug 4, 2025
Author

osbre Aug 4, 2025
Author

osbre Aug 4, 2025
Author

ilyaliao Aug 5, 2025
Maintainer