anima-ds-nucleus 1.0.0

package/LICENSE.md

@@ -0,0 +1,20 @@
+Copyright (c) 2025 Nucleus.
+
+Todos los derechos reservados.
+
+Este software es propiedad de Nucleus y fue desarrollado por el equipo Nucleus Labs.  
+No se concede ninguna licencia de uso, copia, modificación, distribución o creación de obras derivadas, salvo autorización expresa y por escrito de Nucleus.
+
+Queda estrictamente prohibido:
+
+- Copiar total o parcialmente este software.
+- Modificar, descompilar o realizar ingeniería inversa del código fuente.
+- Distribuirlo, venderlo o sublicenciarlo.
+- Utilizarlo con fines distintos a los autorizados por Nucleus.
+
+Cualquier uso no autorizado puede resultar en acciones legales civiles y/o penales según las leyes aplicables.
+
+Para obtener permisos, acuerdos comerciales o autorizaciones, contactar a:  
+Nucleus Labs — ipvasallo@nucleus.com.ar
+
+

package/README.md

@@ -0,0 +1,109 @@
+## anima-ds
+
+**Anima DS** es una librería de componentes React (Design System) que incluye:
+- **Atoms / Inputs / Layout / DataDisplay / Views** listas para usar.
+- Soporte de **i18next / react-i18next**.
+- Componentes avanzados como **tablas (MUI DataGrid)** y **gráficos (ApexCharts)**.
+
+### Instalación
+
+```bash
+npm install anima-ds
+```
+
+Además, el proyecto que la use debe tener instaladas (peer dependencies):
+
+```bash
+npm install react react-dom
+```
+
+Y, según los componentes que utilices:
+
+- **Internacionalización**: `i18next`, `react-i18next`.
+- **Tablas avanzadas**: `@mui/material`, `@mui/x-data-grid`, `@emotion/react`, `@emotion/styled`.
+- **Gráficos**: `apexcharts`, `react-apexcharts`.
+
+### Requisitos de integración
+
+- **React 18 o superior** en el proyecto que consume la librería.
+- **Sistema de estilos compatible** con las clases usadas (idealmente Tailwind CSS).
+- **Internacionalización con i18next** si vas a usar Inputs, Views o `DBGrid` (esperan ciertas keys como `form.*`, `placeholder.*`, `table.*`, etc.).
+
+### Uso básico
+
+```jsx
+import { Button, Layout, Card, I18nProvider } from 'anima-ds';
+
+function App() {
+  return (
+    <I18nProvider language="es-AR">
+      <Layout>
+        <Card title="Ejemplo">
+          <Button tipo="Primary" color="Teal">
+            Click aquí
+          </Button>
+        </Card>
+      </Layout>
+    </I18nProvider>
+  );
+}
+```
+
+También puedes usar el API más típico:
+
+```jsx
+<Button variant="Primary">Enviar</Button>
+```
+
+### Ejemplo de uso en un proyecto demo (Button)
+
+Supongamos un proyecto React creado con Vite o Create React App.  
+Luego de instalar la librería y React, puedes usar el `Button` así:
+
+```jsx
+// src/App.jsx
+import React from 'react';
+import { Button } from 'anima-ds';
+
+function App() {
+  const handleClick = () => {
+    alert('Botón de Anima DS clickeado');
+  };
+
+  return (
+    <div style={{ padding: '2rem' }}>
+      <h1>Proyecto Demo con Anima DS</h1>
+      <Button variant="Primary" onClick={handleClick}>
+        Usar Button de la librería
+      </Button>
+    </div>
+  );
+}
+
+export default App;
+```
+
+Y en el entry point del proyecto (`main.jsx` o `index.jsx`):
+
+```jsx
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App';
+
+ReactDOM.createRoot(document.getElementById('root')).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);
+```
+
+### Notas de diseño
+
+- Muchos componentes usan **Tailwind CSS** en sus clases. Asegúrate de tener Tailwind configurado o estilos equivalentes.
+- Varios componentes (Inputs, Views, DBGrid) dependen de `react-i18next` y esperan ciertas keys de traducción (`form.*`, `placeholder.*`, `table.*`, etc.).
+
+### Scripts de desarrollo
+
+- **`npm run dev`**: entorno de desarrollo con Vite.
+- **`npm run build`**: build de la librería (ESM + CJS en `dist/`).
+- **`npm run storybook`**: arranca Storybook con todos los componentes.