agenciapsilmno/docs/clean-auto-imports.md

clean-auto-imports.js

Script para remover imports manuais redundantes do projeto, considerando que o projeto usa unplugin-auto-import e unplugin-vue-components com PrimeVueResolver.

---

Por que esse script existe

O projeto tem vite.config.mjs configurado com:

• unplugin-auto-import → auto-importa todas as APIs do Vue (ref, computed, watch, onMounted, etc.) em qualquer arquivo .vue ou .js
• unplugin-vue-components + PrimeVueResolver → auto-importa componentes do PrimeVue usados nos templates .vue

Com isso, manter os imports manuais desses símbolos é redundante. O script limpa tudo de uma vez.

---

Como usar

Dry-run (só lista o que seria alterado, sem escrever nada)

node scripts/clean-auto-imports.js --dry-run

Aplicar as mudanças

node scripts/clean-auto-imports.js

Após rodar, verificar se está tudo ok

npm run dev

---

O que o script remove

Em arquivos .vue e .js

Qualquer símbolo Vue dentro de import { ... } from 'vue' que já é auto-importado:

// Antes
import { ref, computed, onMounted, watch } from 'vue'

// Depois (linha removida completamente)

Lista completa dos símbolos removidos:

computed, createApp, customRef, defineAsyncComponent, defineComponent, effectScope, getCurrentInstance, getCurrentScope, h, inject, isProxy, isReactive, isReadonly, isRef, isShallow, markRaw, nextTick, onActivated, onBeforeMount, onBeforeUnmount, onBeforeUpdate, onDeactivated, onErrorCaptured, onMounted, onUnmounted, onUpdated, provide, reactive, readonly, ref, resolveComponent, shallowReactive, shallowReadonly, shallowRef, toRaw, toRef, toRefs, toValue, triggerRef, unref, useAttrs, useCssModule, useCssVars, useId, useModel, useSlots, useTemplateRef, watch, watchEffect, watchPostEffect, watchSyncEffect

Tipos também removidos de import type { ... } from 'vue':

Component, ComputedRef, ComponentPublicInstance, DirectiveBinding, InjectionKey, PropType, Ref, ShallowRef, MaybeRef, MaybeRefOrGetter, VNode, WritableComputedRef, e outros.

Somente em arquivos .vue

Default imports de componentes PrimeVue:

// Antes
import Button from 'primevue/button'
import DataTable from 'primevue/datatable'
import Select from 'primevue/select'

// Depois (linhas removidas)

---

O que o script NÃO remove

main.js é ignorado completamente

O arquivo de bootstrap do app nunca é tocado.

Serviços e plugins do PrimeVue são mantidos

import PrimeVue from 'primevue/config'             // mantido
import ConfirmationService from 'primevue/confirmationservice'  // mantido
import ToastService from 'primevue/toastservice'   // mantido

Composables do PrimeVue são mantidos

import { useToast } from 'primevue/usetoast'       // mantido
import { useConfirm } from 'primevue/useconfirm'   // mantido

Aliases Vue são mantidos se o original não está na lista

import { ref as vRef } from 'vue'  // "ref" está na lista → removido
import { defineProps as dp } from 'vue'  // "defineProps" não está → mantido

Imports de outros pacotes não são tocados

import { useRouter } from 'vue-router'   // mantido (não é do 'vue')
import { useAuthStore } from '@/stores'  // mantido (local)
import { useFeriados } from '@/composables/useFeriados'  // mantido

Imports de componentes PrimeVue em arquivos .js são mantidos

O PrimeVueResolver só funciona em templates .vue. Se um .js importa um componente PrimeVue, provavelmente está sendo usado programaticamente — o script não toca esses casos.

---

Troubleshooting

Erro "X is not defined" após rodar o script

Isso indica que o símbolo estava sendo usado fora do escopo que o auto-import alcança. Basta re-adicionar o import manualmente no arquivo específico.

Quero revertir tudo

Use o git:

git checkout src/

---

Quando rodar novamente

O script é seguro para rodar múltiplas vezes (idempotente). Se novos arquivos forem criados com imports manuais, basta rodar novamente.