Nuxt•9mo ago

How export interfaces after build module?

Recently I no longer export my interfaces to the types.d.ts file that gets generated during module build.

Example (module.ts):

export interface structureModel {
  name: string,
  surname: string,
  age: number
}

export default defineNuxtModule({..});

export interface structureModel {
  name: string,
  surname: string,
  age: number
}

export default defineNuxtModule({..});

In the types.d.ts file after it was built, it used to look like this:

import type { NuxtModule } from '@nuxt/schema'

import type { default as Module } from './module'

export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>

export { type structureModel, default } from './module'

import type { NuxtModule } from '@nuxt/schema'

import type { default as Module } from './module'

export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>

export { type structureModel, default } from './module'

and now it looks like this

import type { NuxtModule } from '@nuxt/schema'

import type { default as Module } from './module'

export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>

export { default } from './module' //<-- missing structureModel, where?

import type { NuxtModule } from '@nuxt/schema'

import type { default as Module } from './module'

export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>

export { default } from './module' //<-- missing structureModel, where?

kapa.ai•3/28/25, 9:18 AM

Hi @Cesxhin. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base.

kapa.ai•3/28/25, 9:18 AM

----------------------
Based on your question about exporting interfaces in Nuxt modules, I can see you're experiencing an issue with type declarations not being properly exported in your built module.

This appears to be related to a change in how type declarations are handled in Nuxt modules. The issue you're experiencing is that your interface is no longer being automatically exported in the generated file after building your module.

Solution: Adding Type Declarations Manually

To ensure your interfaces are properly exported, you should use the utility from

@nuxt/kit

@nuxt/kit

. This allows you to explicitly add type declarations that will be available to users of your module:

This approach ensures that your type declarations are properly included in the built module and available to users of your module Module Author Guide.

Alternative Approach

If you need more control over how your types are included, you can use the hook:

kapa.ai•3/28/25, 9:18 AM

This change in behavior might be related to recent updates in how Nuxt handles type declarations for modules, particularly with the introduction of better support for virtual files as mentioned in a recent PR fix(nuxt): add module declarations for virtual files.

When building your module, make sure to use the command which properly handles type generation for Nuxt modules nuxi build-module.
----------------------
Note: you can ask me a follow up question by @ mentioning me again

----------------------

kapa.ai•3/28/25, 9:18 AM

@552606377067937792 Kapa.ai is still learning and improving, please let me know how I did by reacting below.

CesxhinOP•3/28/25, 9:51 AM

@kapa.ai After declare addTypeTemplate into defineNuxtModule, how use interface structureModel in playground?

kapa.ai•3/28/25, 9:51 AM

Let me check the knowledge base for you again. One moment!

kapa.ai•3/28/25, 9:51 AM

----------------------
Based on your question about using the interface in your playground after declaring it with , I'll explain how to properly access and use these types.

When you use to add type declarations in your module, these types become available in the Nuxt application that uses your module. For your playground (which is typically used during module development), you need to ensure the types are properly referenced.

Here's how to use the interface in your playground:

Make sure your type template is properly defined

First, ensure your type template is correctly defined in your module:

Using the interface in your playground

After running your playground with

npm run dev

npm run dev

(which should automatically build your module), you can import and use the interface in your playground files:

The prefix is a special alias in Nuxt that points to the build directory where your type declarations are generated.

Alternative approach for server-side types

kapa.ai•3/28/25, 9:51 AM

If you need to use these types on the server side as well, you might need to augment both Nuxt and Nitro types. Recent updates to Nuxt allow augmenting both contexts with a single call:

This enhancement was added in a recent update to allow augmenting both Nuxt and Nitro types with a single call feat(kit,nuxt): augment nitro types with .

Remember that after making changes to your module, you may need to restart your development server to see the updated types in your playground.

If you're still having issues with the types not being recognized, you might need to manually add a reference to your types in your

tsconfig.json

tsconfig.json

file in the playground.

Let me know if you encounter any specific issues with this approach!
----------------------
Note: you can ask me a follow up question by @ mentioning me again

----------------------

kapa.ai•3/28/25, 9:51 AM

@552606377067937792 Kapa.ai is still learning and improving, please let me know how I did by reacting below.

anita•3/28/25, 2:41 PM

Locale selector to send the user to the homepage: but now change with current path

LangSelect.vue3.84KB

anita•3/28/25, 2:43 PM

how to use useSwitchLocalePath without redirecting with current path

Aanita Locale selector to send the user to the homepage: but now change with current p...

CesxhinOP•3/31/25, 3:19 PM

delete message please

Solution: Adding Type Declarations Manually

To ensure your interfaces are properly exported

, you should use the

utility from

@nuxt/kit

@nuxt/kit

. This allows you to explicitly add type declarations that will be available to users of your module

This approach ensures that your type declarations are properly included in the built module and available to users of your module

Module Author Guide