vite-plugin-vue-type-imports
v0.2.5
Published
<h2 align="center">vite-plugin-vue-type-imports</h2>
Downloads
25,151
Readme
⚠️ This Plugin is still in Development and there may be bugs. Use at your own risk.
Install
# Install Plugin
npm i -D vite-plugin-vue-type-imports
// vite.config.ts
import { defineConfig } from 'vite'
import Vue from '@vitejs/plugin-vue'
import VueTypeImports from 'vite-plugin-vue-type-imports'
export default defineConfig({
plugins: [
Vue(),
VueTypeImports(),
],
})
Nuxt
// nuxt.config.ts
export default {
buildModules: [
'vite-plugin-vue-type-imports/nuxt',
]
}
Usage
// types.ts
export interface User {
username: string
password: string
avatar?: string
}
<script setup lang="ts">
import type { User } from '~/types'
defineProps<User>()
</script>
<template>...</template>
Known limitations
- Namespace imports like
import * as Foo from 'foo'
are not supported. - These types are not supported.
- The plugin currently only scans the content of
<script setup>
. Types defined in<script>
will be ignored.
Notes
Enum
types will be converted to Union Types (e.g.type [name] = number | string
) , since Vue can't handle them right now.- The plugin may be slow because it needs to read files and traverse the AST (using @babel/parser).
Caveats
- Do not reference the types themselves implicitly, it will cause infinite loop. Vue will also get wrong type definition even if you disable this plugin.
Illegal code:
export type Bar = Foo
export interface Foo {
foo: Bar
}
Alternatively, you can reference the types themselves in their own definitions
Acceptable code:
export type Bar = string
export interface Foo {
foo: Foo
bar: Foo | Bar
}
- Ending the type name with something like
_1
and_2
is not recommended, because it may conflict with the plugin's transformation result
These types may cause conflicts:
type Foo_1 = string
type Bar_2 = number
License
MIT License © 2021-PRESENT Jacob Clevenger