From 7c274583ec9d3c1916833326f063ca2ae13c549f Mon Sep 17 00:00:00 2001
From: Luiz Silva <luiz@e-licencie.com.br>
Date: Fri, 2 Jan 2026 21:24:44 -0300
Subject: [PATCH] refactor(tipos): centralizar tipagens em src/tipos

---
 .agent                                 | 10 ++++
 src/componentes/botao/EliBotao.vue     | 20 ++-----
 src/componentes/campo/EliInput.vue     | 79 ++++++--------------------
 src/componentes/indicador/EliBadge.vue | 34 ++++-------
 src/tipos/botao.ts                     |  9 +++
 src/tipos/campo.ts                     | 52 +++++++++++++++++
 src/tipos/index.ts                     |  4 ++
 src/tipos/indicador.ts                 | 29 ++++++++++
 8 files changed, 138 insertions(+), 99 deletions(-)
 create mode 100644 src/tipos/botao.ts
 create mode 100644 src/tipos/campo.ts
 create mode 100644 src/tipos/index.ts
 create mode 100644 src/tipos/indicador.ts

diff --git a/.agent b/.agent
index 720aa89..26c9b8e 100644
--- a/.agent
+++ b/.agent
@@ -120,6 +120,16 @@ Evitar comentários óbvios (“isso é um botão”).
 - Padronizar nomes de tipos em português:
   - `tipoOpcao`, `tipoTamanho`, `tipoEstado`, `tipoTema`
 
+### Centralização de tipos (padrão do repositório)
+
+- Tipos compartilhados (uniões, enums, aliases) devem ficar em `src/tipos/`.
+- Cada domínio pode ter seu arquivo:
+  - `src/tipos/botao.ts`
+  - `src/tipos/campo.ts`
+  - `src/tipos/indicador.ts`
+- Re-export central em `src/tipos/index.ts`.
+- Componentes importam tipagens de `src/tipos`.
+
 ---
 
 ## Padrão defineComponent (obrigatório)
diff --git a/src/componentes/botao/EliBotao.vue b/src/componentes/botao/EliBotao.vue
index 8ad179c..a57a533 100644
--- a/src/componentes/botao/EliBotao.vue
+++ b/src/componentes/botao/EliBotao.vue
@@ -14,19 +14,7 @@
 
 <script lang="ts">
 import { defineComponent, PropType } from "vue";
-
-type BotaoVariant = 
-    | "elevated"
-    | "flat"
-    | "outlined"
-    | "text"
-    | "tonal"
-
-type BotaoSize = 
-    | "x-small"
-    | "small"
-    | "default"
-    | "large"
+import type { BotaoTamanho, BotaoVariante } from "../../tipos";
 
 export default defineComponent({
     name: "EliBotao",
@@ -40,12 +28,12 @@ export default defineComponent({
         },
 
         variant: {
-            type: String as PropType<BotaoVariant>,
+			type: String as PropType<BotaoVariante>,
             default: "elevated",
         },
 
         size: {
-      type: String as PropType<BotaoSize>,
+	  type: String as PropType<BotaoTamanho>,
       default: "default",
     },
 
@@ -61,4 +49,4 @@ export default defineComponent({
     }
 })
 
-</script>
\ No newline at end of file
+</script>
diff --git a/src/componentes/campo/EliInput.vue b/src/componentes/campo/EliInput.vue
index 13017cb..e1fc065 100644
--- a/src/componentes/campo/EliInput.vue
+++ b/src/componentes/campo/EliInput.vue
@@ -99,63 +99,20 @@
 
 <script lang="ts">
 import { defineComponent, ref, computed, PropType } from "vue";
+import type {
+  CampoDensidade,
+  CampoOpcao,
+  CampoOpcaoBruta,
+  CampoTipo,
+  CampoValor,
+  CampoValorMultiplo,
+  CampoVariante,
+} from "../../tipos";
 import { formatarCpfCnpj } from "./utils/cpfCnpj";
 import { formatTelefone } from "./utils/telefone";
 import { formatarDecimal, formatarMoeda, somenteNumeros } from "./utils/numerico"
 import { formatarCep } from "./utils/cep";
 
-/**
- * Tipos base do EliInput.
- * Mantidos aqui para evitar exports internos não documentados.
- */
-type ValorCampo = string | number | boolean | null;
-type ValorCampoMultiplo = ValorCampo[];
-
-type OpcaoCampo<TValor extends ValorCampo = ValorCampo> = {
-  label: string;
-  value: TValor;
-  disabled?: boolean;
-};
-
-type OpcaoBruta<TValor extends ValorCampo = ValorCampo> =
-  | TValor
-  | {
-      label?: string;
-      value: TValor;
-      disabled?: boolean;
-    };
-
-type InputVariant =
-  | "outlined"
-  | "filled"
-  | "plain"
-  | "solo"
-  | "solo-filled"
-  | "solo-inverted"
-  | "underlined";
-
-type Density = "default" | "comfortable" | "compact";
-
-type TipoNumerico =
-  | "numericoInteiro"
-  | "numericoDecimal"
-  | "numericoMoeda";
-
-type InputType =
-  | "text"
-  | "password"
-  | "email"
-  | "search"
-  | "url"
-  | "textarea"
-  | "radio"
-  | "checkbox"
-  | "telefone"
-  | "cpfCnpj"
-  | "cep"
-  | "select"
-  | TipoNumerico;
-
 export default defineComponent({
   name: "EliInput",
   inheritAttrs: false,
@@ -166,10 +123,10 @@ export default defineComponent({
      * O componente não converte tipos automaticamente: mantém o que receber.
      */
     modelValue: {
-      type: [String, Number, Boolean, Array] as PropType<ValorCampo | ValorCampoMultiplo>,
+      type: [String, Number, Boolean, Array] as PropType<CampoValor | CampoValorMultiplo>,
       default: "",
     },
-    type: { type: String as PropType<InputType>, default: "text" },
+    type: { type: String as PropType<CampoTipo>, default: "text" },
     label: String,
     placeholder: String,
     disabled: Boolean,
@@ -186,12 +143,12 @@ export default defineComponent({
      * Aceita lista já normalizada ({ label, value }) ou valores primitivos.
      */
     options: {
-      type: Array as PropType<Array<OpcaoBruta>>,
+      type: Array as PropType<Array<CampoOpcaoBruta>>,
       default: () => [],
     },
     clearable: Boolean,
-    variant: { type: String as PropType<InputVariant>, default: "outlined" },
-    density: { type: String as PropType<Density>, default: "comfortable" },
+    variant: { type: String as PropType<CampoVariante>, default: "outlined" },
+    density: { type: String as PropType<CampoDensidade>, default: "comfortable" },
     color: { type: String, default: "primary" },
     row: Boolean,
     showPasswordToggle: Boolean,
@@ -207,7 +164,7 @@ export default defineComponent({
 
     const value = computed({
       get: () => props.modelValue,
-      set: (v: ValorCampo | ValorCampoMultiplo) => {
+      set: (v: CampoValor | CampoValorMultiplo) => {
         emit("update:modelValue", v);
         emit("change", v);
       },
@@ -287,11 +244,11 @@ export default defineComponent({
     }
 
     // --- Helpers para select / radio / checkbox (aceita objetos ou primitivos) ---
-    const computedItems = computed<Array<OpcaoCampo>>(() => {
+    const computedItems = computed<Array<CampoOpcao>>(() => {
       // Normaliza options para [{ label, value, disabled? }]
       return (props.options || []).map((o) => {
         if (o && typeof o === "object" && "value" in o) {
-          const valor = o.value as ValorCampo;
+          const valor = o.value as CampoValor;
           return {
             label: o.label ?? String(valor),
             value: valor,
@@ -299,7 +256,7 @@ export default defineComponent({
           };
         }
 
-        const valor = o as ValorCampo;
+        const valor = o as CampoValor;
         return { label: String(valor), value: valor };
       });
     });
diff --git a/src/componentes/indicador/EliBadge.vue b/src/componentes/indicador/EliBadge.vue
index 48df176..a18a56b 100644
--- a/src/componentes/indicador/EliBadge.vue
+++ b/src/componentes/indicador/EliBadge.vue
@@ -20,24 +20,14 @@
 
 <script lang="ts">
 import { computed, defineComponent, PropType } from "vue";
+import type {
+  CssLength,
+  IndicadorLocalizacao,
+  IndicadorOffset,
+  IndicadorPresetRaio,
+} from "../../tipos";
 
-type LocalBadge =
-  | "top right"
-  | "right center"
-  | "bottom right"
-  | "top center"
-  | "bottom center"
-  | "top left"
-  | "left center"
-  | "bottom left";
-
-type Offset = "-20" | "-15" | "-10" | "-5" | "0" | "20" | "15" | "10" | "5";
-
-type BadgeRadiusPreset = "suave" | "pill";
-
-type CssLength = `${number}px` | `${number}rem` | `${number}%` | "0";
-
-const RADIUS_MAP: Record<BadgeRadiusPreset, string> = {
+const RADIUS_MAP: Record<IndicadorPresetRaio, string> = {
       suave: "4px",
       pill: "10px",
     };
@@ -54,17 +44,17 @@ export default defineComponent({
     },
 
     location: {
-      type: String as PropType<LocalBadge>,
+      type: String as PropType<IndicadorLocalizacao>,
       default: "top right",
     },
 
     offsetX: {
-      type: String as PropType<Offset>,
+      type: String as PropType<IndicadorOffset>,
       default: "0",
     },
 
     offsetY: {
-      type: String as PropType<Offset>,
+      type: String as PropType<IndicadorOffset>,
       default: "0",
     },
 
@@ -85,7 +75,7 @@ export default defineComponent({
 
     /** 🔥 NOVO: controla só o radius */
     radius: {
-      type: String as PropType<BadgeRadiusPreset | CssLength>,
+      type: String as PropType<IndicadorPresetRaio | CssLength>,
       default: "suave",
     },
   },
@@ -95,7 +85,7 @@ export default defineComponent({
     const resolvedRadius = computed(() => {
       // preset conhecido
       if (props.radius in RADIUS_MAP) {
-        return RADIUS_MAP[props.radius as BadgeRadiusPreset];
+        return RADIUS_MAP[props.radius as IndicadorPresetRaio];
       }
 
       // valor custom (ex: "8px", "50%", "0")
diff --git a/src/tipos/botao.ts b/src/tipos/botao.ts
new file mode 100644
index 0000000..69b9412
--- /dev/null
+++ b/src/tipos/botao.ts
@@ -0,0 +1,9 @@
+/**
+ * Tipos do componente EliBotao.
+ * Mantidos separados do componente para facilitar reuso e padronização.
+ */
+
+export type BotaoVariante = "elevated" | "flat" | "outlined" | "text" | "tonal";
+
+export type BotaoTamanho = "x-small" | "small" | "default" | "large";
+
diff --git a/src/tipos/campo.ts b/src/tipos/campo.ts
new file mode 100644
index 0000000..6cefc14
--- /dev/null
+++ b/src/tipos/campo.ts
@@ -0,0 +1,52 @@
+/**
+ * Tipos do componente EliInput (campo).
+ */
+
+export type CampoValor = string | number | boolean | null;
+export type CampoValorMultiplo = CampoValor[];
+
+export type CampoOpcao<TValor extends CampoValor = CampoValor> = {
+  label: string;
+  value: TValor;
+  disabled?: boolean;
+};
+
+export type CampoOpcaoBruta<TValor extends CampoValor = CampoValor> =
+  | TValor
+  | {
+      label?: string;
+      value: TValor;
+      disabled?: boolean;
+    };
+
+export type CampoVariante =
+  | "outlined"
+  | "filled"
+  | "plain"
+  | "solo"
+  | "solo-filled"
+  | "solo-inverted"
+  | "underlined";
+
+export type CampoDensidade = "default" | "comfortable" | "compact";
+
+export type CampoTipoNumerico =
+  | "numericoInteiro"
+  | "numericoDecimal"
+  | "numericoMoeda";
+
+export type CampoTipo =
+  | "text"
+  | "password"
+  | "email"
+  | "search"
+  | "url"
+  | "textarea"
+  | "radio"
+  | "checkbox"
+  | "telefone"
+  | "cpfCnpj"
+  | "cep"
+  | "select"
+  | CampoTipoNumerico;
+
diff --git a/src/tipos/index.ts b/src/tipos/index.ts
new file mode 100644
index 0000000..e274731
--- /dev/null
+++ b/src/tipos/index.ts
@@ -0,0 +1,4 @@
+export * from "./botao";
+export * from "./campo";
+export * from "./indicador";
+
diff --git a/src/tipos/indicador.ts b/src/tipos/indicador.ts
new file mode 100644
index 0000000..47b0c37
--- /dev/null
+++ b/src/tipos/indicador.ts
@@ -0,0 +1,29 @@
+/**
+ * Tipos do componente EliBadge (indicador).
+ */
+
+export type IndicadorLocalizacao =
+  | "top right"
+  | "right center"
+  | "bottom right"
+  | "top center"
+  | "bottom center"
+  | "top left"
+  | "left center"
+  | "bottom left";
+
+export type IndicadorOffset =
+  | "-20"
+  | "-15"
+  | "-10"
+  | "-5"
+  | "0"
+  | "20"
+  | "15"
+  | "10"
+  | "5";
+
+export type IndicadorPresetRaio = "suave" | "pill";
+
+export type CssLength = `${number}px` | `${number}rem` | `${number}%` | "0";
+