From 51a48eee70875f47b6657df0456d890bc9bfa8b9 Mon Sep 17 00:00:00 2001
From: Luiz Silva <luiz@e-licencie.com.br>
Date: Fri, 2 Jan 2026 21:16:50 -0300
Subject: [PATCH] =?UTF-8?q?chore:=20alinhar=20projeto=20=C3=A0s=20regras?=
 =?UTF-8?q?=20do=20agent?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .agent                                        |  11 +-
 .gitignore                                    |   3 +-
 README.md                                     |  64 ++++++++-
 dist/eli-vue.es.js                            |  62 ---------
 dist/eli-vue.umd.js                           |   1 -
 .../EliOlaMundo/EliOlaMundo.vue.d.ts          |   3 -
 dist/types/componentes/EliOlaMundo/index.d.ts |   3 -
 dist/types/index.d.ts                         |   7 -
 src/componentes/EliBadge/index.ts             |   4 -
 src/componentes/EliBotao/index.ts             |   4 -
 src/componentes/EliInput/index.ts             |   4 -
 src/componentes/EliOlaMundo/README.md         |  54 --------
 src/componentes/EliOlaMundo/index.ts          |   4 -
 .../{EliBotao => botao}/EliBotao.vue          |   0
 src/componentes/{EliBotao => botao}/README.md |   2 +-
 src/componentes/botao/index.ts                |   1 +
 .../{EliInput => campo}/EliInput.vue          |  84 ++++++++----
 src/componentes/{EliInput => campo}/README.md |   7 +-
 src/componentes/campo/index.ts                |   1 +
 .../{EliInput => campo}/utils/cep.ts          |   0
 .../{EliInput => campo}/utils/cpfCnpj.ts      |   0
 .../{EliInput => campo}/utils/numerico.ts     |   0
 .../{EliInput => campo}/utils/telefone.ts     |   0
 .../{EliBadge => indicador}/EliBadge.vue      |   4 +-
 .../{EliBadge => indicador}/README.md         |   2 +-
 src/componentes/indicador/index.ts            |   1 +
 .../EliOlaMundo.vue                           |  14 +-
 src/componentes/ola_mundo/README.md           |  34 +++++
 src/componentes/ola_mundo/index.ts            |   1 +
 src/index.ts                                  |  14 +-
 src/playground/App.vue                        |  34 ++++-
 src/playground/botao.playground.vue           |  45 +++++++
 src/playground/campo.playground.vue           | 123 ++++++++++++++++++
 src/playground/indicador.playground.vue       |  65 +++++++++
 src/playground/ola_mundo.playground.vue       |  34 +++++
 tsconfig.json                                 |   3 +-
 36 files changed, 485 insertions(+), 208 deletions(-)
 delete mode 100644 dist/eli-vue.es.js
 delete mode 100644 dist/eli-vue.umd.js
 delete mode 100644 dist/types/componentes/EliOlaMundo/EliOlaMundo.vue.d.ts
 delete mode 100644 dist/types/componentes/EliOlaMundo/index.d.ts
 delete mode 100644 dist/types/index.d.ts
 delete mode 100644 src/componentes/EliBadge/index.ts
 delete mode 100644 src/componentes/EliBotao/index.ts
 delete mode 100644 src/componentes/EliInput/index.ts
 delete mode 100644 src/componentes/EliOlaMundo/README.md
 delete mode 100644 src/componentes/EliOlaMundo/index.ts
 rename src/componentes/{EliBotao => botao}/EliBotao.vue (100%)
 rename src/componentes/{EliBotao => botao}/README.md (98%)
 create mode 100644 src/componentes/botao/index.ts
 rename src/componentes/{EliInput => campo}/EliInput.vue (78%)
 rename src/componentes/{EliInput => campo}/README.md (95%)
 create mode 100644 src/componentes/campo/index.ts
 rename src/componentes/{EliInput => campo}/utils/cep.ts (100%)
 rename src/componentes/{EliInput => campo}/utils/cpfCnpj.ts (100%)
 rename src/componentes/{EliInput => campo}/utils/numerico.ts (100%)
 rename src/componentes/{EliInput => campo}/utils/telefone.ts (100%)
 rename src/componentes/{EliBadge => indicador}/EliBadge.vue (97%)
 rename src/componentes/{EliBadge => indicador}/README.md (95%)
 create mode 100644 src/componentes/indicador/index.ts
 rename src/componentes/{EliOlaMundo => ola_mundo}/EliOlaMundo.vue (91%)
 create mode 100644 src/componentes/ola_mundo/README.md
 create mode 100644 src/componentes/ola_mundo/index.ts
 create mode 100644 src/playground/botao.playground.vue
 create mode 100644 src/playground/campo.playground.vue
 create mode 100644 src/playground/indicador.playground.vue
 create mode 100644 src/playground/ola_mundo.playground.vue

diff --git a/.agent b/.agent
index 0598f4a..d1108e7 100644
--- a/.agent
+++ b/.agent
@@ -24,8 +24,9 @@ Construir um Design System de componentes em **Vue 3** para reutilização em m
 - **Variáveis, nomes de arquivos e nomes de pastas em português sempre que possível**
   - Ex.: `botao`, `cartao`, `campo_texto`, `seletor_opcoes`
   - Evitar abreviações confusas
-- Nomes de componentes (PascalCase) podem seguir padrão técnico, mas preferir português:
-  - `BotaoPrimario.vue`, `CartaoInfo.vue`, `CampoTexto.vue`
+- Nomes de componentes (PascalCase) podem seguir padrão técnico:
+  - **Padrão do repositório:** componentes com prefixo `Eli` (ex.: `EliBotao`, `EliInput`).
+  - Pastas preferem português (ex.: `src/componentes/botao/`, `src/componentes/campo/`).
 - Props e eventos: preferir português e sem ambiguidades:
   - Props: `rotulo`, `desabilitado`, `carregando`, `modeloValor`
   - Eventos: `update:modelValue`, `confirmar`, `cancelar`, `clicar`
@@ -45,11 +46,11 @@ Estrutura sugerida:
 src/
   componentes/
     botao/
-      Botao.vue
+      EliBotao.vue
       index.ts
       README.md
     cartao/
-      Cartao.vue
+      EliCartao.vue
       index.ts
       README.md
   playground/
@@ -134,7 +135,7 @@ Evitar comentários óbvios (“isso é um botão”).
 
 ## Regras de exportação e reuso
 - Cada pasta do componente deve ter `index.ts` exportando o componente:
-  - `export { default as Botao } from "./Botao.vue"`
+  - `export { default as EliBotao } from "./EliBotao.vue"`
 - `src/index.ts` deve exportar todos os componentes publicamente
 - Não exportar itens internos não documentados
 
diff --git a/.gitignore b/.gitignore
index b512c09..f06235c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,2 @@
-node_modules
\ No newline at end of file
+node_modules
+dist
diff --git a/README.md b/README.md
index 33895ab..8093e12 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,63 @@
-# Vue 3 + TypeScript + Vite
+# eli-vue — Design System (Vue 3 + TypeScript)
 
-This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `<script setup>` SFCs, check out the [script setup docs](https://v3.vuejs.org/api/sfc-script-setup.html#sfc-script-setup) to learn more.
+Biblioteca de componentes Vue 3 (Design System) para reutilização em múltiplos projetos, com foco em:
 
-Learn more about the recommended Project Setup and IDE Support in the [Vue Docs TypeScript Guide](https://vuejs.org/guide/typescript/overview.html#project-setup).
+- consistência visual e comportamental
+- tipagem forte (TypeScript `strict`)
+- documentação em português
+- exemplos executáveis via playground
+
+As regras do repositório estão descritas em **`.agent`**.
+
+## Instalação
+
+Como dependência do projeto:
+
+```bash
+pnpm add eli-vue
+```
+
+> Observação: `vue` e `vuetify` são **peerDependencies**. Garanta que seu projeto já os tenha instalados.
+
+## Uso
+
+### 1) Registro global (plugin)
+
+```ts
+import { createApp } from "vue";
+import EliVue from "eli-vue";
+
+import App from "./App.vue";
+
+createApp(App).use(EliVue).mount("#app");
+```
+
+### 2) Importação direta de componentes
+
+```ts
+import { EliBotao, EliInput, EliBadge } from "eli-vue";
+```
+
+## Convenções do projeto
+
+- Componentes usam **prefixo `Eli`** (ex.: `EliBotao`, `EliInput`).
+- Pastas seguem **português** (ex.: `src/componentes/botao`, `src/componentes/campo`, `src/componentes/indicador`).
+- Sem TSX; padrão SFC: `<template>` + `<script lang="ts">` + `defineComponent`.
+- Evitar `any`.
+
+## Como criar um novo componente (checklist)
+
+1. Criar pasta em `src/componentes/<nome_em_portugues>/`
+2. Criar `EliNomeDoComponente.vue` com `defineComponent` + comentários úteis
+3. Criar `index.ts` re-exportando o componente
+4. Criar `README.md` do componente (API, exemplos, casos de borda)
+5. Criar playground em `src/playground/<nome>.playground.vue` (3+ variações)
+6. Exportar no `src/index.ts`
+
+## Como rodar o playground
+
+```bash
+pnpm dev
+```
+
+O playground fica em `src/playground` e serve para validar visualmente os componentes durante o desenvolvimento.
diff --git a/dist/eli-vue.es.js b/dist/eli-vue.es.js
deleted file mode 100644
index 72999a8..0000000
--- a/dist/eli-vue.es.js
+++ /dev/null
@@ -1,62 +0,0 @@
-import { defineComponent as u, createBlock as i, openBlock as f, withCtx as o, createVNode as n, createTextVNode as l } from "vue";
-import { VBtn as m } from "vuetify/components/VBtn";
-import { VCard as s, VCardTitle as p, VCardText as c, VCardActions as _ } from "vuetify/components/VCard";
-import { VContainer as x } from "vuetify/components/VGrid";
-const V = u({
-  name: "EliOlaMundo"
-}), C = (e, t) => {
-  const r = e.__vccOpts || e;
-  for (const [a, d] of t)
-    r[a] = d;
-  return r;
-};
-function O(e, t, r, a, d, y) {
-  return f(), i(x, null, {
-    default: o(() => [
-      n(s, {
-        class: "mx-auto",
-        max_width: "400"
-      }, {
-        default: o(() => [
-          n(p, null, {
-            default: o(() => [...t[0] || (t[0] = [
-              l("Olá Mundo!", -1)
-            ])]),
-            _: 1
-          }),
-          n(c, null, {
-            default: o(() => [...t[1] || (t[1] = [
-              l(" Este é um componente de exemplo integrado com Vuetify. ", -1)
-            ])]),
-            _: 1
-          }),
-          n(_, null, {
-            default: o(() => [
-              n(m, {
-                color: "primary",
-                block: ""
-              }, {
-                default: o(() => [...t[2] || (t[2] = [
-                  l(" Botão Vuetify ", -1)
-                ])]),
-                _: 1
-              })
-            ]),
-            _: 1
-          })
-        ]),
-        _: 1
-      })
-    ]),
-    _: 1
-  });
-}
-const k = /* @__PURE__ */ C(V, [["render", O]]), T = {
-  install(e) {
-    e.component("EliOlaMundo", k);
-  }
-};
-export {
-  k as EliOlaMundo,
-  T as default
-};
diff --git a/dist/eli-vue.umd.js b/dist/eli-vue.umd.js
deleted file mode 100644
index 83643e2..0000000
--- a/dist/eli-vue.umd.js
+++ /dev/null
@@ -1 +0,0 @@
-(function(t,e){typeof exports=="object"&&typeof module<"u"?e(exports,require("vue"),require("vuetify/components/VBtn"),require("vuetify/components/VCard"),require("vuetify/components/VGrid")):typeof define=="function"&&define.amd?define(["exports","vue","vuetify/components/VBtn","vuetify/components/VCard","vuetify/components/VGrid"],e):(t=typeof globalThis<"u"?globalThis:t||self,e(t.eli_vue={},t.Vue,t.VBtn,t.VCard,t.VGrid))})(this,(function(t,e,f,i,s){"use strict";const a=e.defineComponent({name:"EliOlaMundo"}),c=(o,n)=>{const d=o.__vccOpts||o;for(const[l,u]of n)d[l]=u;return d};function p(o,n,d,l,u,m){return e.openBlock(),e.createBlock(s.VContainer,null,{default:e.withCtx(()=>[e.createVNode(i.VCard,{class:"mx-auto",max_width:"400"},{default:e.withCtx(()=>[e.createVNode(i.VCardTitle,null,{default:e.withCtx(()=>[...n[0]||(n[0]=[e.createTextVNode("Olá Mundo!",-1)])]),_:1}),e.createVNode(i.VCardText,null,{default:e.withCtx(()=>[...n[1]||(n[1]=[e.createTextVNode(" Este é um componente de exemplo integrado com Vuetify. ",-1)])]),_:1}),e.createVNode(i.VCardActions,null,{default:e.withCtx(()=>[e.createVNode(f.VBtn,{color:"primary",block:""},{default:e.withCtx(()=>[...n[2]||(n[2]=[e.createTextVNode(" Botão Vuetify ",-1)])]),_:1})]),_:1})]),_:1})]),_:1})}const r=c(a,[["render",p]]),V={install(o){o.component("EliOlaMundo",r)}};t.EliOlaMundo=r,t.default=V,Object.defineProperties(t,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})}));
diff --git a/dist/types/componentes/EliOlaMundo/EliOlaMundo.vue.d.ts b/dist/types/componentes/EliOlaMundo/EliOlaMundo.vue.d.ts
deleted file mode 100644
index da2975b..0000000
--- a/dist/types/componentes/EliOlaMundo/EliOlaMundo.vue.d.ts
+++ /dev/null
@@ -1,3 +0,0 @@
-declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const _default: typeof __VLS_export;
-export default _default;
diff --git a/dist/types/componentes/EliOlaMundo/index.d.ts b/dist/types/componentes/EliOlaMundo/index.d.ts
deleted file mode 100644
index cacd08f..0000000
--- a/dist/types/componentes/EliOlaMundo/index.d.ts
+++ /dev/null
@@ -1,3 +0,0 @@
-import EliOlaMundo from './EliOlaMundo.vue';
-export { EliOlaMundo };
-export default EliOlaMundo;
diff --git a/dist/types/index.d.ts b/dist/types/index.d.ts
deleted file mode 100644
index dfad485..0000000
--- a/dist/types/index.d.ts
+++ /dev/null
@@ -1,7 +0,0 @@
-import type { App } from "vue";
-import { EliOlaMundo } from './componentes/EliOlaMundo';
-export { EliOlaMundo };
-declare const _default: {
-    install(app: App): void;
-};
-export default _default;
diff --git a/src/componentes/EliBadge/index.ts b/src/componentes/EliBadge/index.ts
deleted file mode 100644
index 31741df..0000000
--- a/src/componentes/EliBadge/index.ts
+++ /dev/null
@@ -1,4 +0,0 @@
-import EliBadge from "./EliBadge.vue";
-
-export { EliBadge };
-export default EliBadge;
diff --git a/src/componentes/EliBotao/index.ts b/src/componentes/EliBotao/index.ts
deleted file mode 100644
index 52e69d0..0000000
--- a/src/componentes/EliBotao/index.ts
+++ /dev/null
@@ -1,4 +0,0 @@
-import EliBotao from "./EliBotao.vue";
-
-export { EliBotao };
-export default EliBotao;
diff --git a/src/componentes/EliInput/index.ts b/src/componentes/EliInput/index.ts
deleted file mode 100644
index d616913..0000000
--- a/src/componentes/EliInput/index.ts
+++ /dev/null
@@ -1,4 +0,0 @@
-import EliInput from "./EliInput.vue";
-
-export { EliInput };
-export default EliInput;
diff --git a/src/componentes/EliOlaMundo/README.md b/src/componentes/EliOlaMundo/README.md
deleted file mode 100644
index f66207e..0000000
--- a/src/componentes/EliOlaMundo/README.md
+++ /dev/null
@@ -1,54 +0,0 @@
-# EliOlaMundo (Exemplo de Estrutura)
-
-Este componente serve como **referência oficial** para a criação de novos componentes neste Design System. Utilize esta estrutura como guia.
-
-## 📂 Estrutura de Pastas e Arquivos
-
-Todo componente deve seguir rigorosamente a estrutura abaixo, utilizando **PascalCase** (PrimeiraLetraMaiuscula) para pastas e arquivos.
-
-```
-src/componentes/
-└── NomeDoComponente/            <-- Pasta do Componente
-    ├── NomeDoComponente.vue     <-- Lógica e Template (Vue 3 + TS)
-    ├── index.ts                 <-- Ponto de entrada (Exports)
-    └── README.md                <-- Documentação de uso (Props, Slots, Exemplos)
-```
-
-## 📝 Como Criar um Novo Componente
-
-1.  **Crie a Pasta:**
-    Nomeie a pasta com o nome do componente em PascalCase.
-    *Ex: `src/componentes/MeuBotao/`*
-
-2.  **Crie o Arquivo Vue:**
-    Nomeie o arquivo igual à pasta.
-    *Ex: `src/componentes/MeuBotao/MeuBotao.vue`*
-    - Utilize a Composition API com TypeScript.
-    - Defina sempre o `name` do componente.
-
-3.  **Crie o Index (`index.ts`):**
-    Este arquivo facilita a importação. Deve conter:
-    ```typescript
-    import MeuBotao from './MeuBotao.vue'
-
-    export { MeuBotao }
-    export default MeuBotao
-    ```
-
-4.  **Crie a Documentação (`README.md`):**
-    Descreva o que o componente faz, suas propriedades (`props`), eventos (`emits`) e slots.
-
-5.  **Registre na Biblioteca:**
-    Adicione o novo componente no arquivo principal `src/index.ts`:
-    ```typescript
-    import { MeuBotao } from './componentes/MeuBotao'
-    // ...
-    export { MeuBotao }
-    
-    export default {
-      install(app: App) {
-        // ...
-        app.component('MeuBotao', MeuBotao)
-      }
-    }
-    ```
diff --git a/src/componentes/EliOlaMundo/index.ts b/src/componentes/EliOlaMundo/index.ts
deleted file mode 100644
index 0d8f1ac..0000000
--- a/src/componentes/EliOlaMundo/index.ts
+++ /dev/null
@@ -1,4 +0,0 @@
-import EliOlaMundo from './EliOlaMundo.vue'
-
-export { EliOlaMundo }
-export default EliOlaMundo
diff --git a/src/componentes/EliBotao/EliBotao.vue b/src/componentes/botao/EliBotao.vue
similarity index 100%
rename from src/componentes/EliBotao/EliBotao.vue
rename to src/componentes/botao/EliBotao.vue
diff --git a/src/componentes/EliBotao/README.md b/src/componentes/botao/README.md
similarity index 98%
rename from src/componentes/EliBotao/README.md
rename to src/componentes/botao/README.md
index 8a846f7..5419d23 100644
--- a/src/componentes/EliBotao/README.md
+++ b/src/componentes/botao/README.md
@@ -116,7 +116,7 @@ Exemplos:
 
 <script lang="ts">
 import { defineComponent, ref } from 'vue'
-import EliBotao from '@/components/EliBotao.vue'
+import EliBotao from '@/componentes/botao/EliBotao.vue'
 
 export default defineComponent({
   components: { EliBotao },
diff --git a/src/componentes/botao/index.ts b/src/componentes/botao/index.ts
new file mode 100644
index 0000000..9215e8e
--- /dev/null
+++ b/src/componentes/botao/index.ts
@@ -0,0 +1 @@
+export { default as EliBotao } from "./EliBotao.vue";
diff --git a/src/componentes/EliInput/EliInput.vue b/src/componentes/campo/EliInput.vue
similarity index 78%
rename from src/componentes/EliInput/EliInput.vue
rename to src/componentes/campo/EliInput.vue
index 4a9827b..13017cb 100644
--- a/src/componentes/EliInput/EliInput.vue
+++ b/src/componentes/campo/EliInput.vue
@@ -76,8 +76,8 @@
       :row="row"
     >
       <v-radio
-        v-for="opt in options"
-        :key="opt.value"
+        v-for="opt in computedItems"
+        :key="String(opt.value)"
         :label="opt.label"
         :value="opt.value"
       />
@@ -86,8 +86,8 @@
     <!-- CHECKBOX -->
     <div v-else-if="type === 'checkbox'" class="checkbox-group">
       <v-checkbox
-        v-for="opt in options"
-        :key="opt.value"
+        v-for="opt in computedItems"
+        :key="String(opt.value)"
         v-model="value"
         :label="opt.label"
         :value="opt.value"
@@ -104,12 +104,27 @@ import { formatTelefone } from "./utils/telefone";
 import { formatarDecimal, formatarMoeda, somenteNumeros } from "./utils/numerico"
 import { formatarCep } from "./utils/cep";
 
-type Option = {
+/**
+ * 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: any;
+  value: TValor;
   disabled?: boolean;
 };
 
+type OpcaoBruta<TValor extends ValorCampo = ValorCampo> =
+  | TValor
+  | {
+      label?: string;
+      value: TValor;
+      disabled?: boolean;
+    };
+
 type InputVariant =
   | "outlined"
   | "filled"
@@ -146,17 +161,34 @@ export default defineComponent({
   inheritAttrs: false,
 
   props: {
-    modelValue: { type: [String, Number, Array] as any, default: "" },
+    /**
+     * Aceita valor simples (text-like) ou lista de valores (checkbox/select multiple).
+     * O componente não converte tipos automaticamente: mantém o que receber.
+     */
+    modelValue: {
+      type: [String, Number, Boolean, Array] as PropType<ValorCampo | ValorCampoMultiplo>,
+      default: "",
+    },
     type: { type: String as PropType<InputType>, default: "text" },
     label: String,
     placeholder: String,
     disabled: Boolean,
     error: Boolean,
-    errorMessages: { type: [String, Array] as any, default: () => [] },
+    errorMessages: {
+      type: [String, Array] as PropType<string | string[]>,
+      default: () => [],
+    },
     hint: String,
     persistentHint: Boolean,
     rows: { type: Number, default: 4 },
-    options: { type: Array as PropType<Option[]>, default: () => [] },
+    /**
+     * Para select/radio/checkbox.
+     * Aceita lista já normalizada ({ label, value }) ou valores primitivos.
+     */
+    options: {
+      type: Array as PropType<Array<OpcaoBruta>>,
+      default: () => [],
+    },
     clearable: Boolean,
     variant: { type: String as PropType<InputVariant>, default: "outlined" },
     density: { type: String as PropType<Density>, default: "comfortable" },
@@ -175,7 +207,7 @@ export default defineComponent({
 
     const value = computed({
       get: () => props.modelValue,
-      set: (v) => {
+      set: (v: ValorCampo | ValorCampoMultiplo) => {
         emit("update:modelValue", v);
         emit("change", v);
       },
@@ -255,25 +287,23 @@ export default defineComponent({
     }
 
     // --- Helpers para select / radio / checkbox (aceita objetos ou primitivos) ---
-    const computedItems = computed(() => {
+    const computedItems = computed<Array<OpcaoCampo>>(() => {
       // Normaliza options para [{ label, value, disabled? }]
-      return (props.options || []).map((o: any) =>
-        o && typeof o === "object" && ("label" in o || "value" in o)
-          ? { label: o.label ?? String(o.value), value: o.value, disabled: o.disabled }
-          : { label: String(o), value: o }
-      );
+      return (props.options || []).map((o) => {
+        if (o && typeof o === "object" && "value" in o) {
+          const valor = o.value as ValorCampo;
+          return {
+            label: o.label ?? String(valor),
+            value: valor,
+            disabled: o.disabled,
+          };
+        }
+
+        const valor = o as ValorCampo;
+        return { label: String(valor), value: valor };
+      });
     });
 
-    function optLabel(opt: any) {
-      if (opt && typeof opt === "object") return opt.label ?? String(opt.value);
-      return String(opt);
-    }
-
-    function optValue(opt: any) {
-      if (opt && typeof opt === "object") return opt.value;
-      return opt;
-    }
-
 
     return {
       attrs,
@@ -288,8 +318,6 @@ export default defineComponent({
       onFocus: () => emit("focus"),
       onBlur: () => emit("blur"),
       computedItems,
-      optLabel,
-      optValue,
     };
   },
 });
diff --git a/src/componentes/EliInput/README.md b/src/componentes/campo/README.md
similarity index 95%
rename from src/componentes/EliInput/README.md
rename to src/componentes/campo/README.md
index 5c4244b..68d6856 100644
--- a/src/componentes/EliInput/README.md
+++ b/src/componentes/campo/README.md
@@ -32,7 +32,8 @@ EliInput foi projetado para:
 ## Tipagem (TypeScript)
 
 ```ts
-type Option = { label: string; value: any; disabled?: boolean };
+type ValorCampo = string | number | boolean | null;
+type Option = { label: string; value: ValorCampo; disabled?: boolean };
 
 type InputVariant = 'outlined' | 'filled' | 'plain' | 'solo' | 'solo-filled' | 'solo-inverted' | 'underlined';
 type Density = 'default' | 'comfortable' | 'compact';
@@ -50,7 +51,7 @@ type InputType =
 
 | Prop             | Tipo                        | Default         | Descrição                                              |
 | ---------------- | --------------------------- | --------------- | ------------------------------------------------------ |
-| `modelValue`     | `string \| number \| any[]` | `""`            | Valor controlado (use com `v-model`).                  |
+| `modelValue`     | `string \| number \| boolean \| (string \| number \| boolean \| null)[]` | `""`            | Valor controlado (use com `v-model`).                  |
 | `type`           | `InputType`                 | `"text"`        | Tipo do controle (ver `InputType`).                    |
 | `label`          | `string`                    | `-`             | Rótulo do campo.                                       |
 | `placeholder`    | `string`                    | `-`             | Texto exibido quando o campo está vazio.               |
@@ -113,4 +114,4 @@ type InputType =
 ## Slot
 
 * O componente não expõe slots customizados diretamente. Ele controla internamente o append para toggle de senha quando type === 'password' && showPasswordToggle (ícone de olho).
-* Se você precisa de slots específicos do v-text-field/v-select, considere estender o componente ou criar uma variação que exponha os slots desejados.
\ No newline at end of file
+* Se você precisa de slots específicos do v-text-field/v-select, considere estender o componente ou criar uma variação que exponha os slots desejados.
diff --git a/src/componentes/campo/index.ts b/src/componentes/campo/index.ts
new file mode 100644
index 0000000..890a77a
--- /dev/null
+++ b/src/componentes/campo/index.ts
@@ -0,0 +1 @@
+export { default as EliInput } from "./EliInput.vue";
diff --git a/src/componentes/EliInput/utils/cep.ts b/src/componentes/campo/utils/cep.ts
similarity index 100%
rename from src/componentes/EliInput/utils/cep.ts
rename to src/componentes/campo/utils/cep.ts
diff --git a/src/componentes/EliInput/utils/cpfCnpj.ts b/src/componentes/campo/utils/cpfCnpj.ts
similarity index 100%
rename from src/componentes/EliInput/utils/cpfCnpj.ts
rename to src/componentes/campo/utils/cpfCnpj.ts
diff --git a/src/componentes/EliInput/utils/numerico.ts b/src/componentes/campo/utils/numerico.ts
similarity index 100%
rename from src/componentes/EliInput/utils/numerico.ts
rename to src/componentes/campo/utils/numerico.ts
diff --git a/src/componentes/EliInput/utils/telefone.ts b/src/componentes/campo/utils/telefone.ts
similarity index 100%
rename from src/componentes/EliInput/utils/telefone.ts
rename to src/componentes/campo/utils/telefone.ts
diff --git a/src/componentes/EliBadge/EliBadge.vue b/src/componentes/indicador/EliBadge.vue
similarity index 97%
rename from src/componentes/EliBadge/EliBadge.vue
rename to src/componentes/indicador/EliBadge.vue
index 260974e..48df176 100644
--- a/src/componentes/EliBadge/EliBadge.vue
+++ b/src/componentes/indicador/EliBadge.vue
@@ -121,8 +121,8 @@ export default defineComponent({
 </script>
 
 <style scoped>
-::v-deep .v-badge__badge,
-::v-deep .v-badge__content {
+:deep(.v-badge__badge),
+:deep(.v-badge__content) {
   border-radius: var(--eli-badge-radius) !important;
 }
 </style>
diff --git a/src/componentes/EliBadge/README.md b/src/componentes/indicador/README.md
similarity index 95%
rename from src/componentes/EliBadge/README.md
rename to src/componentes/indicador/README.md
index 66a8911..66e24b1 100644
--- a/src/componentes/EliBadge/README.md
+++ b/src/componentes/indicador/README.md
@@ -177,6 +177,6 @@ Exemplo (pseudocódigo):
 
 Observações sobre Vuetify
 
-1. O EliBadge usa seletores com ::v-deep para alterar o border-radius do elemento interno do v-badge. Isso funciona para Vuetify 2 e 3, mas as classes internas podem variar entre versões. Se você atualizar o Vuetify, verifique os nomes de classe (.v-badge__badge ou .v-badge__content) e ajuste o seletor se necessário.
+1. O EliBadge usa seletor com `:deep(...)` para alterar o border-radius do elemento interno do `v-badge`. Se você atualizar o Vuetify, verifique os nomes de classe (`.v-badge__badge` / `.v-badge__content`) e ajuste o seletor se necessário.
 
 2. Prop names do v-badge (ex.: location, offset-x, offset-y, content, dot) podem variar entre versões do Vuetify — reveja a docs da versão em uso se algo não for aplicado como esperado.
diff --git a/src/componentes/indicador/index.ts b/src/componentes/indicador/index.ts
new file mode 100644
index 0000000..9f5ca63
--- /dev/null
+++ b/src/componentes/indicador/index.ts
@@ -0,0 +1 @@
+export { default as EliBadge } from "./EliBadge.vue";
diff --git a/src/componentes/EliOlaMundo/EliOlaMundo.vue b/src/componentes/ola_mundo/EliOlaMundo.vue
similarity index 91%
rename from src/componentes/EliOlaMundo/EliOlaMundo.vue
rename to src/componentes/ola_mundo/EliOlaMundo.vue
index f100efb..7289172 100644
--- a/src/componentes/EliOlaMundo/EliOlaMundo.vue
+++ b/src/componentes/ola_mundo/EliOlaMundo.vue
@@ -119,9 +119,11 @@
 
 <script lang="ts">
 import { defineComponent, ref } from "vue";
-import EliBotao from "../EliBotao/EliBotao.vue";
-import EliBadge from "../EliBadge/EliBadge.vue";
-import EliInput from "../EliInput/EliInput.vue";
+import EliBotao from "../botao/EliBotao.vue";
+import EliBadge from "../indicador/EliBadge.vue";
+import EliInput from "../campo/EliInput.vue";
+
+type Habilidade = "vue" | "react";
 
 export default defineComponent({
   name: "EliOlaMundo",
@@ -132,7 +134,7 @@ export default defineComponent({
   },
   setup() {
     const nome = ref("");
-    const estado = ref([])
+    const estado = ref<string[]>([]);
     const cep = ref("");
     const telefone = ref("");
     const idade = ref("");
@@ -142,8 +144,8 @@ export default defineComponent({
     const mensagem = ref("");
     const senha = ref("");
     const documento = ref("");
-    const cor = ref(null);
-    const habilidades = ref<any[]>([]);
+    const cor = ref<"azul" | "verde" | null>(null);
+    const habilidades = ref<Habilidade[]>([]);
     return {
       nome,
       email,
diff --git a/src/componentes/ola_mundo/README.md b/src/componentes/ola_mundo/README.md
new file mode 100644
index 0000000..7c057d9
--- /dev/null
+++ b/src/componentes/ola_mundo/README.md
@@ -0,0 +1,34 @@
+# EliOlaMundo (componente de demonstração)
+
+O `EliOlaMundo` é um componente **de exemplo** usado para validar rapidamente o Design System no playground.
+
+> Ele não é um componente “de produto”; ele existe para demonstrar integração com Vuetify e mostrar variações de uso de `EliInput`, `EliBotao` e `EliBadge`.
+
+## Estrutura do repositório (padrão)
+
+Neste Design System:
+
+- **Pastas e arquivos** (quando aplicável) preferem português: `botao/`, `campo/`, `indicador/`, etc.
+- **Componentes** mantêm prefixo técnico `Eli` (PascalCase): `EliBotao`, `EliInput`.
+
+Exemplo:
+
+```
+src/componentes/
+  botao/
+    EliBotao.vue
+    index.ts
+    README.md
+  campo/
+    EliInput.vue
+    index.ts
+    README.md
+```
+
+## Playground
+
+O playground deve conter arquivos `*.playground.vue` para cada componente, com no mínimo:
+
+- 3 variações visuais/estados
+- interações (v-model/click)
+- casos de borda relevantes
diff --git a/src/componentes/ola_mundo/index.ts b/src/componentes/ola_mundo/index.ts
new file mode 100644
index 0000000..fa786f4
--- /dev/null
+++ b/src/componentes/ola_mundo/index.ts
@@ -0,0 +1 @@
+export { default as EliOlaMundo } from "./EliOlaMundo.vue";
diff --git a/src/index.ts b/src/index.ts
index 2892810..79864d1 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -1,15 +1,15 @@
-import type { App } from "vue";
-import { EliOlaMundo } from "./componentes/EliOlaMundo";
-import { EliBotao } from "./componentes/EliBotao";
-import { EliBadge } from "./componentes/EliBadge";
-import { EliInput } from "./componentes/EliInput";
+import type { App, Plugin } from "vue";
+import { EliOlaMundo } from "./componentes/ola_mundo";
+import { EliBotao } from "./componentes/botao";
+import { EliBadge } from "./componentes/indicador";
+import { EliInput } from "./componentes/campo";
 
 export { EliOlaMundo };
 export { EliBotao };
 export { EliBadge };
 export { EliInput };
 
-export default {
+const EliVue: Plugin = {
   install(app: App) {
     app.component("EliOlaMundo", EliOlaMundo);
     app.component("EliBotao", EliBotao);
@@ -17,3 +17,5 @@ export default {
     app.component("EliInput", EliInput);
   },
 };
+
+export default EliVue;
diff --git a/src/playground/App.vue b/src/playground/App.vue
index ab71d04..b4463e7 100644
--- a/src/playground/App.vue
+++ b/src/playground/App.vue
@@ -1,16 +1,42 @@
 <template>
-  <EliOlaMundo />
- 
+  <v-container class="py-6">
+    <h1 class="text-h5 mb-4">Playground — eli-vue</h1>
+
+    <v-tabs v-model="aba" color="primary" density="comfortable">
+      <v-tab value="botao">Botão</v-tab>
+      <v-tab value="indicador">Indicador</v-tab>
+      <v-tab value="campo">Campo</v-tab>
+      <v-tab value="ola_mundo">Demo</v-tab>
+    </v-tabs>
+
+    <v-divider class="my-4" />
+
+    <BotaoPlayground v-if="aba === 'botao'" />
+    <IndicadorPlayground v-else-if="aba === 'indicador'" />
+    <CampoPlayground v-else-if="aba === 'campo'" />
+    <OlaMundoPlayground v-else />
+  </v-container>
 </template>
 
 <script lang="ts">
 import { defineComponent } from 'vue'
-import { EliOlaMundo } from '@/componentes/EliOlaMundo'
+import BotaoPlayground from "./botao.playground.vue";
+import IndicadorPlayground from "./indicador.playground.vue";
+import CampoPlayground from "./campo.playground.vue";
+import OlaMundoPlayground from "./ola_mundo.playground.vue";
 
 export default defineComponent({
   name: 'App',
   components: {
-    EliOlaMundo,
+    BotaoPlayground,
+    IndicadorPlayground,
+    CampoPlayground,
+    OlaMundoPlayground,
+  },
+  data() {
+    return {
+      aba: "botao" as "botao" | "indicador" | "campo" | "ola_mundo",
+    };
   }
 })
 </script>
diff --git a/src/playground/botao.playground.vue b/src/playground/botao.playground.vue
new file mode 100644
index 0000000..2fd1c33
--- /dev/null
+++ b/src/playground/botao.playground.vue
@@ -0,0 +1,45 @@
+<template>
+  <section class="stack">
+    <h2>EliBotao</h2>
+
+    <div class="row">
+      <EliBotao @click="contador++">Primário (clicks: {{ contador }})</EliBotao>
+      <EliBotao variant="outlined">Outlined</EliBotao>
+      <EliBotao variant="text">Text</EliBotao>
+    </div>
+
+    <div class="row">
+      <EliBotao :disabled="true">Desabilitado</EliBotao>
+      <EliBotao :loading="true">Carregando</EliBotao>
+      <EliBotao color="success">Success</EliBotao>
+    </div>
+  </section>
+</template>
+
+<script lang="ts">
+import { defineComponent, ref } from "vue";
+import { EliBotao } from "@/componentes/botao";
+
+export default defineComponent({
+  name: "BotaoPlayground",
+  components: { EliBotao },
+  setup() {
+    const contador = ref(0);
+    return { contador };
+  },
+});
+</script>
+
+<style scoped>
+.stack {
+  display: grid;
+  gap: 16px;
+}
+
+.row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+  align-items: center;
+}
+</style>
diff --git a/src/playground/campo.playground.vue b/src/playground/campo.playground.vue
new file mode 100644
index 0000000..8e838ea
--- /dev/null
+++ b/src/playground/campo.playground.vue
@@ -0,0 +1,123 @@
+<template>
+  <section class="stack">
+    <h2>EliInput (campo)</h2>
+
+    <div class="grid">
+      <EliInput v-model="nome" label="Nome" placeholder="Digite seu nome" />
+      <EliInput v-model="telefone" type="telefone" label="Telefone" />
+      <EliInput v-model="documento" type="cpfCnpj" label="CPF / CNPJ" />
+
+      <EliInput v-model="idade" type="numericoInteiro" label="Idade" />
+      <EliInput v-model="valor" type="numericoMoeda" label="Valor" />
+      <EliInput v-model="cep" type="cep" label="CEP" placeholder="00000-000" />
+
+      <EliInput
+        v-model="estado"
+        type="select"
+        label="Estado"
+        multiple
+        :options="[
+          { label: 'São Paulo', value: 'SP' },
+          { label: 'Rio de Janeiro', value: 'RJ' },
+        ]"
+      />
+
+      <EliInput
+        v-model="cor"
+        type="radio"
+        label="Cor favorita"
+        :options="[
+          { label: 'Azul', value: 'azul' },
+          { label: 'Verde', value: 'verde' },
+        ]"
+      />
+
+      <EliInput
+        v-model="habilidades"
+        type="checkbox"
+        label="Habilidades"
+        :options="[
+          { label: 'Vue', value: 'vue' },
+          { label: 'React', value: 'react' },
+        ]"
+      />
+    </div>
+
+    <pre class="debug">{{ debug }}</pre>
+  </section>
+</template>
+
+<script lang="ts">
+import { computed, defineComponent, ref } from "vue";
+import { EliInput } from "@/componentes/campo";
+
+type Cor = "azul" | "verde" | null;
+type Habilidade = "vue" | "react";
+
+export default defineComponent({
+  name: "CampoPlayground",
+  components: { EliInput },
+  setup() {
+    const nome = ref("");
+    const telefone = ref("");
+    const documento = ref("");
+    const idade = ref("");
+    const valor = ref("");
+    const cep = ref("");
+    const estado = ref<string[]>([]);
+    const cor = ref<Cor>(null);
+    const habilidades = ref<Habilidade[]>([]);
+
+    const debug = computed(() =>
+      JSON.stringify(
+        {
+          nome: nome.value,
+          telefone: telefone.value,
+          documento: documento.value,
+          idade: idade.value,
+          valor: valor.value,
+          cep: cep.value,
+          estado: estado.value,
+          cor: cor.value,
+          habilidades: habilidades.value,
+        },
+        null,
+        2
+      )
+    );
+
+    return {
+      nome,
+      telefone,
+      documento,
+      idade,
+      valor,
+      cep,
+      estado,
+      cor,
+      habilidades,
+      debug,
+    };
+  },
+});
+</script>
+
+<style scoped>
+.stack {
+  display: grid;
+  gap: 16px;
+}
+
+.grid {
+  display: grid;
+  gap: 12px;
+  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
+}
+
+.debug {
+  padding: 12px;
+  background: rgba(0, 0, 0, 0.04);
+  border-radius: 8px;
+  overflow: auto;
+}
+</style>
diff --git a/src/playground/indicador.playground.vue b/src/playground/indicador.playground.vue
new file mode 100644
index 0000000..7971f1f
--- /dev/null
+++ b/src/playground/indicador.playground.vue
@@ -0,0 +1,65 @@
+<template>
+  <section class="stack">
+    <h2>EliBadge (indicador)</h2>
+
+    <div class="row">
+      <EliBadge badge="3">
+        <v-icon>mdi-bell</v-icon>
+      </EliBadge>
+
+      <EliBadge badge="Novo" radius="pill" color="success">
+        <span class="chip">Mensagens</span>
+      </EliBadge>
+
+      <EliBadge dot :visible="true" color="error">
+        <v-icon>mdi-email</v-icon>
+      </EliBadge>
+    </div>
+
+    <div class="row">
+      <EliBadge badge="99+" :visible="mostrar" radius="12px">
+        <span class="chip">Toggle visible</span>
+      </EliBadge>
+
+      <EliBotao variant="outlined" @click="mostrar = !mostrar">
+        Alternar visible ({{ mostrar ? "mostrando" : "oculto" }})
+      </EliBotao>
+    </div>
+  </section>
+</template>
+
+<script lang="ts">
+import { defineComponent, ref } from "vue";
+import { EliBadge } from "@/componentes/indicador";
+import { EliBotao } from "@/componentes/botao";
+
+export default defineComponent({
+  name: "IndicadorPlayground",
+  components: { EliBadge, EliBotao },
+  setup() {
+    const mostrar = ref(true);
+    return { mostrar };
+  },
+});
+</script>
+
+<style scoped>
+.stack {
+  display: grid;
+  gap: 16px;
+}
+
+.row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 16px;
+  align-items: center;
+}
+
+.chip {
+  display: inline-flex;
+  padding: 6px 10px;
+  border-radius: 8px;
+  border: 1px solid rgba(0, 0, 0, 0.15);
+}
+</style>
diff --git a/src/playground/ola_mundo.playground.vue b/src/playground/ola_mundo.playground.vue
new file mode 100644
index 0000000..de82078
--- /dev/null
+++ b/src/playground/ola_mundo.playground.vue
@@ -0,0 +1,34 @@
+<template>
+  <section class="stack">
+    <h2>EliOlaMundo</h2>
+    <p class="muted">
+      Demo integrada (útil para smoke-test visual). Para testes específicos,
+      prefira os playgrounds de <code>EliBotao</code>, <code>EliInput</code> e
+      <code>EliBadge</code>.
+    </p>
+
+    <EliOlaMundo />
+  </section>
+</template>
+
+<script lang="ts">
+import { defineComponent } from "vue";
+import { EliOlaMundo } from "@/componentes/ola_mundo";
+
+export default defineComponent({
+  name: "OlaMundoPlayground",
+  components: { EliOlaMundo },
+});
+</script>
+
+<style scoped>
+.stack {
+  display: grid;
+  gap: 12px;
+}
+
+.muted {
+  opacity: 0.75;
+  margin: 0;
+}
+</style>
diff --git a/tsconfig.json b/tsconfig.json
index 67e8b4a..fe4029d 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -9,7 +9,6 @@
 
     /* Tipagem */
     "strict": true,
-    "jsx": "preserve",
     "resolveJsonModule": true,
     "isolatedModules": true,
     "esModuleInterop": true,
@@ -27,6 +26,6 @@
     /* Vue */
     "types": ["vite/client"]
   },
-  "include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.tsx", "src/**/*.vue"],
+  "include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.vue"],
   "exclude": ["dist", "node_modules"]
 }