{"_id":"@dronico/droni-kit","_rev":"76-9aea354ce0c08b8b8d2ef1aab7f8d381","name":"@dronico/droni-kit","dist-tags":{"latest":"1.26.0"},"versions":{"1.0.1":{"name":"@dronico/droni-kit","version":"1.0.1","author":{"name":"Gustavo Barragan","email":"dev@droni.co"},"_id":"@dronico/droni-kit@1.0.1","maintainers":[{"name":"gbarragan","email":"dev@droni.co"}],"homepage":"https://github.com/Droni-app/droni-kit#readme","bugs":{"url":"https://github.com/Droni-app/droni-kit/issues"},"dist":{"shasum":"589e732f35b622db75636fe11351b4639873b1e1","tarball":"https://registry.npmjs.org/@dronico/droni-kit/-/droni-kit-1.0.1.tgz","fileCount":140,"integrity":"sha512-Gq4s1+rxb8a3E21kFehbn02uYLpV2ZJToWbGsxYm0ZAesYm7yVXR2oiqz7GAGxGNF6crcj0E9UiEowVWRFHTsA==","signatures":[{"sig":"MEUCIQCtZC/5TGFOsAVOjsmpsSWroUTz8H00b1djo+uTydOa1QIgUy6uwvsISwldGpxG12MhTY9GdRhUx/MCOVoyTT75ViU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8019676},"main":"dist/droni-kit.umd.js","type":"module","types":"dist/index.d.ts","access":"public","module":"dist/droni-kit.js","gitHead":"0bc77022868d9acc0382d2f9c6acc55051a7f26f","private":false,"scripts":{"dev":"vite","build":"vue-tsc -b && vite build","preview":"vite preview","release":"semantic-release","storybook":"storybook dev -p 6006","build-storybook":"storybook build"},"_npmUser":{"name":"gbarragan","email":"dev@droni.co"},"repository":{"url":"git+https://github.com/Droni-app/droni-kit.git","type":"git"},"_npmVersion":"10.9.2","description":"This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `\n```\n\n## 📚 Componentes Disponibles\n\n### 🎨 Elements\n\n#### **DuiAlert**\nComponente para mostrar alertas y notificaciones.\n```vue\n\n ¡Operación completada exitosamente!\n\n```\n\n#### **DuiAction**\nComponente de acción que soporta navegación con Vue Router y Nuxt Router.\n```vue\n\n Ir al Dashboard\n\n```\n\n#### **DuiTable**\nTabla con soporte para slots personalizados por columna.\n```vue\n\n \n\n```\n\n### 📝 Forms\n\n#### **DuiButton**\nBotón versátil con soporte para navegación y estados de carga.\n```vue\n\n Enviar\n\n```\n\n#### **DuiInput**\nCampo de entrada con validación y múltiples tipos.\n```vue\n\n```\n\n#### **DuiSelect**\nSelector desplegable con opciones personalizables.\n```vue\n\n```\n\n#### **DuiTextarea**\nÁrea de texto con auto-redimensionamiento opcional.\n```vue\n\n```\n\n#### **DuiForm**\nContenedor de formulario con gestión de estado de carga/deshabilitado, slots para cabecera y acciones, y compatibilidad con Nuxt.\n```vue\n\n \n\n \n \n \n\n \n \n \n\n \n\n```\n\n## 🎨 Sistema de Design\n\n### Variantes\n- `solid` - Estilo sólido (predeterminado)\n- `outline` - Solo borde\n- `ghost` - Estilo transparente\n\n### Colores\n- `neutral` - Gris (predeterminado)\n- `primary` - Azul\n- `secondary` - Rosa\n- `success` - Verde\n- `warning` - Amarillo\n- `danger` - Rojo\n\n### Tamaños\n- `sm` - Pequeño\n- `md` - Mediano (predeterminado)\n- `lg` - Grande\n\n### Esquinas redondeadas\n- `all` - Todas las esquinas (predeterminado)\n- `top` - Solo arriba\n- `bottom` - Solo abajo\n- `left` - Solo izquierda\n- `right` - Solo derecha\n- `none` - Sin redondeo\n\n## 🧭 Navegación\n\nLos componentes `DuiButton` y `DuiAction` detectan automáticamente si Vue Router o Nuxt Router están disponibles:\n\n```vue\n\nLista de usuarios\n\n\n\n Ver perfil\n\n\n\n\n Ir a Droni.co\n\n```\n\n## 📖 Documentación\n\nPuedes explorar todos los componentes y sus variantes en nuestra documentación interactiva de Storybook:\n\n```bash\nnpm run storybook\n```\n\n## 🛠️ Desarrollo\n\n### Prerequisitos\n\n- Node.js 18+ \n- npm o yarn\n\n### Configuración del entorno\n\n```bash\n# Clona el repositorio\ngit clone https://github.com/Droni-app/droni-kit.git\ncd droni-kit\n\n# Instala las dependencias\nnpm install\n\n# Inicia el servidor de desarrollo\nnpm run dev\n\n# Ejecuta Storybook\nnpm run storybook\n```\n\n### Scripts disponibles\n\n```bash\nnpm run dev # Servidor de desarrollo\nnpm run build # Construir para producción\nnpm run preview # Vista previa de la build\nnpm run storybook # Ejecutar Storybook\nnpm run build-storybook # Construir Storybook estático\nnpm run test # Ejecutar tests (Vitest)\n```\n\n## 🤝 Contributing\n\n¡Contribuciones son bienvenidas! Por favor sigue estos pasos:\n\n### 1. Fork y Clone\n\n```bash\ngit clone https://github.com/tu-usuario/droni-kit.git\ncd droni-kit\nnpm install\n```\n\n### 2. Crear una rama\n\n```bash\ngit checkout -b feature/nombre-de-tu-feature\n# o\ngit checkout -b fix/descripcion-del-fix\n```\n\n### 3. Desarrollo\n\n- Sigue las convenciones de código existentes\n- Asegúrate de que tu código funcione con TypeScript\n- Usa el prefijo `dk:` para las clases de Tailwind\n- Agrega tests si es aplicable\n- Documenta nuevos componentes en Storybook\n\n### 4. Testing\n\n```bash\n# Ejecuta los tests\nnpm run test\n\n# Verifica que Storybook funcione\nnpm run storybook\n```\n\n### 5. Commit\n\nUsamos [Conventional Commits](https://www.conventionalcommits.org/):\n\n```bash\ngit commit -m \"feat: agregar componente DuiModal\"\ngit commit -m \"fix: corregir padding en DuiButton\"\ngit commit -m \"docs: actualizar documentación de DuiInput\"\n```\n\n### 6. Pull Request\n\n1. Push tu rama: `git push origin feature/nombre-de-tu-feature`\n2. Abre un Pull Request en GitHub\n3. Describe los cambios realizados\n4. Asegúrate de que los checks pasen\n\n### Directrices para componentes\n\n#### Estructura de archivos\n```\nsrc/stories/\n├── Elements/\n│ ├── DuiAlert.vue\n│ ├── DuiAlert.stories.ts\n│ └── ...\n├── Forms/\n│ ├── DuiButton.vue\n│ ├── DuiButton.stories.ts\n│ └── ...\n```\n\n#### Props estándar\nTodos los componentes deben incluir estas props cuando sea aplicable:\n- `variant`: `'solid' | 'outline' | 'ghost'`\n- `color`: `'neutral' | 'primary' | 'secondary' | 'success' | 'warning' | 'danger'`\n- `size`: `'sm' | 'md' | 'lg'`\n- `rounded`: `'all' | 'top' | 'bottom' | 'left' | 'right' | 'none'`\n- `disabled`: `boolean`\n- `block`: `boolean`\n\n#### TypeScript\n- Define interfaces para las props\n- Exporta los tipos para uso externo\n- Usa `withDefaults` para valores predeterminados\n\n```typescript\nexport interface DuiComponentProps {\n variant?: 'solid' | 'outline' | 'ghost'\n color?: 'neutral' | 'primary' | 'secondary' | 'success' | 'warning' | 'danger'\n}\n\nconst props = withDefaults(defineProps(), {\n variant: 'solid',\n color: 'neutral'\n})\n```\n\n## 📄 Licencia\n\nEste proyecto está bajo la licencia MIT. Ver el archivo `LICENSE` para más detalles.\n\n## 🌟 Créditos\n\nDesarrollado con ❤️ por el equipo de [Droni.co](https://droni.co)\n\n---\n\n**¿Necesitas ayuda?** Abre un [issue](https://github.com/Droni-app/droni-kit/issues) o contáctanos en [Droni.co](https://droni.co)","readmeFilename":"README.md"}