@arielgonzaguer/michi-router 1.2.1 → 1.3.0

package/README.md

@@ -8,18 +8,14 @@
 # ¡IMPORTANTE!
 
 Las versiones 1.1.x publicadas antes del 18/marzo/2025 están rotas, contienen errores y han sido eliminadas.
-La versión estable es la 1.2.1.
-Si tienes alguna de estas versiones instaladas (1.1.x), actualízala a la versión 1.2.0 ejecutando el siguiente comando:
+La versión estable es la 1.2.2.
+Si tienes alguna de estas versiones instaladas (1.1.x), actualízala a la versión 1.2.2 ejecutando el siguiente comando:
 ```bash
 npm install @arielgonzaguer/michi-router@latest
 ```
 
-O:
-```bash
-npm install @arielgonzaguer/michi-router@1.2.1
-```
 
-Gracias por tu comprensión 😸
+Gracias por su comprensión 😸
 
 # Michi Router
 
@@ -33,13 +29,11 @@ El objetivo principal de esta herramienta es proporcionar la funcionalidad bási
 - No requiere de ninguna configuración adicional.
 - No requiere de ninguna dependencia externa.
 - Creado con TypeScript.
-- Ultra ligero.
-
 
 ## Compatibilidad
 
 - React 16.8+.
-- Funciona con proyectos creados con  Vite, Next.js, etc.
+- Funciona con proyectos creados con Vite.
 - Totalmente tipado con TypeScript.
 
 ## Instalación
@@ -50,9 +44,9 @@ npm install @arielgonzaguer/michi-router
 
 ## Uso básico
 
-```jsx
+```tsx
 // src/App.jsx //
-import { RouterProvider} from "@arielgonzaguer/michi-router";
+import { RouterProvider } from "@arielgonzaguer/michi-router";
 
 // puede crear rutas en un archivo separado o en el mismo archivo
 const routes = [
@@ -73,8 +67,9 @@ function App() {
 ### Usando Link
 
 #### Usando el componente Link solo con prop to
-```jsx
-import { Link} from "@arielgonzaguer/michi-router";
+
+```tsx
+import { Link } from "@arielgonzaguer/michi-router";
 
 function NavigationComponent() {
   return (
@@ -87,13 +82,12 @@ function NavigationComponent() {
 ```
 
 #### Usando el componente Link con todas las props
-```jsx
-import { Link} from "@arielgonzaguer/michi-router";
 
-<Link 
-  to="/contact" 
-  className="nav-link" 
-  target="_blank" 
+```tsx
+<Link
+  to="/contact"
+  className="nav-link"
+  target="_blank"
   rel="noopener noreferrer"
   aria-label="Contacto"
 >
@@ -101,25 +95,25 @@ import { Link} from "@arielgonzaguer/michi-router";
 </Link>
 ```
 
-
-
 ### Navegación programática (Hook useNavigate)
 
-```jsx
+```tsx
 import { useNavigate } from "@arielgonzaguer/michi-router";
 
 function NavigateButton() {
   const navigate = useNavigate();
-  return <button onClick={() => navigate("/about")}>Ir a About</button>;
+  return;
+  <button onClick={() => navigate("/gatos")}>Ir a Gatos</button>;
 }
 ```
 
 ### Organización de rutas en archivos separados
 
-Para aplicaciones más grandes, puedes organizar tus rutas en archivos separados:
+Puede organizar sus rutas en archivos separados.
+Primero cree un archivo con las rutas:
 
-```jsx
-// routes.js
+```tsx
+// routes.tsx
 import Home from "./pages/Home";
 import About from "./pages/About";
 import Products from "./pages/Products";
@@ -134,8 +128,10 @@ export const routes = [
 export const notFoundPage = <NotFound />;
 ```
 
-```jsx
-// App.jsx
+Después utilice este archivo en su componente que maneja el enrutado:
+
+```tsx
+// App.tsx
 import { RouterProvider } from "@arielgonzaguer/michi-router";
 import { routes, notFoundPage } from "./routes";
 
@@ -144,31 +140,90 @@ function App() {
 }
 ```
 
-### Integración con sistemas de autenticación
+### Protección de rutas
+
+Si necesita que sus rutas se mantengan protegidas, puede usar un componente que cumpla este propósito, como el siguiente:
+
+```tsx
+// Protected.tsx
+import { useEffect } from "react";
+import { useNavigate } from "@arielgonzaguer/michi-router";
+import useAuthStore from "../store/useAuthStore"; // esta sería la store que maneja la autenticacación en su proyecto
+import { ReactNode } from "react"; // tipado
+
+export default function Protected({ children }: { children: ReactNode }) {
+  const navigate = useNavigate();
+  const { user } = useAuthStore();
+
+  useEffect(() => {
+    if (!user) {
+      navigate("/login"); // si no hay usuario autenticado en la store, redirige al login
+    }
+  }, [user, navigate]);
+
+  return user ? children : null; // Devuelve los hijos solo si la persona usuaria está autenticada
+}
+```
+
+Después, puede usar ese componente en el archivo dónde maneja sus rutas:
 
-```jsx
+```tsx
+// MichiRouter.tsx
 import { RouterProvider } from "@arielgonzaguer/michi-router";
-import { useAuth } from "./auth-context";
+import Home from "../pages/Home";
+import ActualizarGatos from "../pages/ActualizarGatos";
+import VerGatos from "../pages/VerGatos";
+import AgregarGatos from "../pages/AgregarGatos";
+import NotFoud404 from "../components/NotFound404";
+import Index from "../pages/Index";
 
-function App() {
-  const { isAuthenticated } = useAuth();
-
-  // Definimos rutas condicionalmente basadas en autenticación
-  const routes = [
-    { path: "/", component: <Home /> },
-    { path: "/login", component: <Login /> },
-    // Solo agregamos estas rutas si el usuario está autenticado
-    ...(isAuthenticated
-      ? [
-          { path: "/profile", component: <Profile /> },
-          { path: "/admin", component: <Admin /> },
-        ]
-      : []),
-  ];
+// protección de rutas
+import Protected from "./Protected";
+
+// layout
+import BaseLayout from "../layouts/BaseLayout";
 
+const rutas = [
+  { path: "/", component: <Home /> },
+  // encapsule los componente a elegir dentro de <Protected>
+  {
+    path: "/index",
+    component: (
+      <Protected>
+        <Index />
+      </Protected>
+    ),
+  },
+  {
+    path: "/actualizar-gatos",
+    component: (
+      <Protected>
+        <ActualizarGatos />
+      </Protected>
+    ),
+  },
+  {
+    path: "/ver-gatos",
+    component: (
+      <Protected>
+        <VerGatos />{" "}
+      </Protected>
+    ),
+  },
+  {
+    path: "/agregar-gatos",
+    component: (
+      <Protected>
+        <AgregarGatos />
+      </Protected>
+    ),
+  },
+];
+
+export default function MichiRouter() {
   return (
-    <RouterProvider routes={routes}>
-      <div>404: Page not found</div>
+    <RouterProvider routes={rutas} layout={BaseLayout}>
+      <NotFoud404 />
     </RouterProvider>
   );
 }
@@ -176,15 +231,15 @@ function App() {
 
 ### Usando un Layout General
 
-Puedes aplicar un layout común a todas tus rutas:
+Puede aplicar un layout común a todas tus rutas:
 
-```jsx
+```tsx
 import { RouterProvider } from "@arielgonzaguer/michi-router";
 import MainLayout from "./layouts/MainLayout";
 
 const routes = [
   { path: "/", component: <Home /> },
-  { path: "/about", component: <About /> },
+  { path: "/felinos-ferales", component: <Ferales /> },
 ];
 
 function App() {
@@ -202,7 +257,7 @@ function MainLayout({ children }) {
       <header>
         <nav>
           <Link to="/">Home</Link>
-          <Link to="/about">About</Link>
+          <Link to="/felinos-ferales">Ferales</Link>
         </nav>
       </header>
       <main>{children}</main>
@@ -243,24 +298,22 @@ Hook para navegación programática.
 
 - Función navigate que acepta la ruta como parámetro.
 
-## Solución de problemas comunes
+## Próximas características
 
-### El componente no se renderiza después de navegar
+- [ ] Transiciones entre rutas.
 
-Asegúrate de que la ruta en el array `routes` coincida exactamente con la URL, incluyendo barras diagonales.
+  ```jsx
+  <RouterProvider routes={routes} transitions={true} transitionDuration={300}>
+    <NotFound />
+  </RouterProvider>
+  ```
 
-### Errores con TypeScript
+## Solución de problemas comunes
+
+### El componente no se renderiza después de navegar
 
-Si estás usando TypeScript, asegúrate de importar los tipos correctamente:
+Asegúrese de que la ruta en el array `routes` coincida exactamente con la URL, incluyendo barras diagonales.
 
-```typescript
-import {
-  RouterProvider,
-  Link,
-  useNavigate,
-} from "@arielgonzaguer/michi-router";
-import type { RouterProviderProps } from "@arielgonzaguer/michi-router";
-```
 
 ## Contribuir
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@arielgonzaguer/michi-router",
   "private": false,
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "El router minimalista y simple para React.\nEl objetivo principal de esta herramienta es proporcionar la funcionalidad básica de enrutamiento.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",