flysoft-react-ui 1.3.1 → 1.3.3

package/README.md

@@ -211,6 +211,51 @@ function MyComponent() {
 }
 ```
 
+## Control del Drawer Izquierdo (AppLayout)
+
+En resoluciones grandes el drawer izquierdo del `AppLayout` está siempre visible;
+en móvil/tablet se abre desde el botón de hamburguesa como panel flotante con
+overlay. Cualquier componente renderizado dentro del `AppLayout` (contenido del
+drawer, nodos del navbar, footer o `children`) puede controlarlo con
+`useLeftDrawer()`:
+
+```tsx
+import { useLeftDrawer, LinkButton } from "flysoft-react-ui";
+
+function AppMenu() {
+  const { closeLeftDrawer } = useLeftDrawer();
+
+  // Al tocar un link se cierra el panel en móvil.
+  // En desktop no produce ningún cambio: el drawer siempre está visible.
+  return (
+    <nav>
+      <LinkButton to="/inicio" onClick={closeLeftDrawer}>
+        Inicio
+      </LinkButton>
+      <LinkButton to="/clientes" onClick={closeLeftDrawer}>
+        Clientes
+      </LinkButton>
+    </nav>
+  );
+}
+```
+
+El hook devuelve:
+
+| Propiedad | Tipo | Descripción |
+| --------- | ---- | ----------- |
+| `isLeftDrawerOpen` | `boolean` | Si el drawer móvil está abierto |
+| `isLeftDrawerCollapsible` | `boolean` | `true` en móvil/tablet con contenido en el drawer |
+| `openLeftDrawer` | `() => void` | Abre el drawer |
+| `closeLeftDrawer` | `() => void` | Cierra el drawer |
+| `toggleLeftDrawer` | `() => void` | Alterna el estado |
+
+Los mismos comandos están disponibles desde `useAppLayout()` cuando se usa
+`AppLayoutProvider`. Para componentes que también se renderizan fuera del
+`AppLayout`, `useOptionalLeftDrawer()` devuelve `undefined` en lugar de lanzar
+error. Si preferís manejar el estado por tu cuenta, `AppLayout` acepta las props
+controladas `isLeftDrawerOpen` y `onLeftDrawerOpenChange`.
+
 ### Variables CSS Disponibles
 
 El sistema proporciona variables CSS con prefijo `--flysoft-`:

package/dist/components/layout/AppLayout.d.ts

@@ -6,6 +6,14 @@ export interface AppLayoutProps {
     contentFooter?: React.ReactNode;
     children: React.ReactNode;
     className?: string;
+    /**
+     * Estado controlado del drawer móvil. Si se define, el AppLayout deja de
+     * manejar el estado internamente y hay que actualizarlo desde
+     * `onLeftDrawerOpenChange`.
+     */
+    isLeftDrawerOpen?: boolean;
+    /** Se dispara cada vez que el drawer móvil debe abrirse o cerrarse */
+    onLeftDrawerOpenChange?: (isOpen: boolean) => void;
 }
 export declare const AppLayout: React.FC<AppLayoutProps>;
 //# sourceMappingURL=AppLayout.d.ts.map

package/dist/components/layout/AppLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppLayout.d.ts","sourceRoot":"","sources":["../../../src/components/layout/AppLayout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2B,MAAM,OAAO,CAAC;AAIhD,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAif9C,CAAC"}
+{"version":3,"file":"AppLayout.d.ts","sourceRoot":"","sources":["../../../src/components/layout/AppLayout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAItE,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAMzC,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAsiB9C,CAAC"}

package/dist/contexts/AppLayoutContext.d.ts

@@ -25,6 +25,10 @@ export interface AppLayoutContextType extends ThemeContextType {
     setClassName: (className: string) => void;
     setNavBarLeftNode: (node: string | ReactNode | undefined) => void;
     setNavbarRightNode: (node: string | ReactNode | undefined) => void;
+    isLeftDrawerOpen: boolean;
+    openLeftDrawer: () => void;
+    closeLeftDrawer: () => void;
+    toggleLeftDrawer: () => void;
 }
 interface AppLayoutProviderProps {
     children: ReactNode;

package/dist/contexts/AppLayoutContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppLayoutContext.d.ts","sourceRoot":"","sources":["../../src/contexts/AppLayoutContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAIZ,KAAK,SAAS,EAEd,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAKhE,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAE5D,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,UAAU,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC5C,aAAa,EAAE,SAAS,GAAG,SAAS,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,QAAQ,CAAC,cAAc,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC;IACjE,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC,CAAC;IACzE,gBAAgB,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;IACxD,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;IAClE,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;CACpE;AAMD,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,SAAS,CAAC;IAEpB,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAE7C,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;IACxC,oBAAoB,CAAC,EAAE,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8ID,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAqC9D,CAAC;AAIF,eAAO,MAAM,YAAY,QAAO,oBAM/B,CAAC;AAIF,eAAO,MAAM,mBAAmB,eAG/B,CAAC"}
+{"version":3,"file":"AppLayoutContext.d.ts","sourceRoot":"","sources":["../../src/contexts/AppLayoutContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAIZ,KAAK,SAAS,EAEd,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAKhE,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAE5D,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,UAAU,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC5C,aAAa,EAAE,SAAS,GAAG,SAAS,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,QAAQ,CAAC,cAAc,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC;IACjE,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC,CAAC;IACzE,gBAAgB,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;IACxD,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;IAClE,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;IAGnE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAMD,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,SAAS,CAAC;IAEpB,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAE7C,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;IACxC,oBAAoB,CAAC,EAAE,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8JD,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAqC9D,CAAC;AAIF,eAAO,MAAM,YAAY,QAAO,oBAM/B,CAAC;AAIF,eAAO,MAAM,mBAAmB,eAG/B,CAAC"}

package/dist/contexts/LeftDrawerContext.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Comandos para controlar el drawer izquierdo del AppLayout.
+ *
+ * En resoluciones grandes el drawer está siempre visible, por lo que
+ * `closeLeftDrawer()` no produce ningún cambio visual. En móvil/tablet el
+ * drawer se muestra como panel flotante con overlay y estos comandos lo
+ * abren o cierran.
+ */
+export interface LeftDrawerContextType {
+    /** Indica si el drawer móvil está abierto */
+    isLeftDrawerOpen: boolean;
+    /**
+     * Indica si el drawer se está mostrando como panel colapsable con overlay
+     * (móvil/tablet con contenido en el drawer). En desktop es `false`.
+     */
+    isLeftDrawerCollapsible: boolean;
+    /** Abre el drawer */
+    openLeftDrawer: () => void;
+    /** Cierra el drawer */
+    closeLeftDrawer: () => void;
+    /** Alterna el estado del drawer */
+    toggleLeftDrawer: () => void;
+}
+export declare const LeftDrawerContext: import("react").Context<LeftDrawerContextType | undefined>;
+/**
+ * Hook para controlar el drawer izquierdo desde cualquier componente
+ * renderizado dentro de `AppLayout` (contenido del drawer, navbar, footer o
+ * children).
+ *
+ * @example
+ * ```tsx
+ * const { closeLeftDrawer } = useLeftDrawer();
+ *
+ * <LinkButton to="/inicio" onClick={closeLeftDrawer}>Inicio</LinkButton>
+ * ```
+ */
+export declare const useLeftDrawer: () => LeftDrawerContextType;
+/**
+ * Igual que `useLeftDrawer` pero devuelve `undefined` en lugar de lanzar error
+ * cuando el componente se usa fuera de un `AppLayout`. Útil para componentes
+ * reutilizables que pueden renderizarse dentro o fuera del layout.
+ */
+export declare const useOptionalLeftDrawer: () => LeftDrawerContextType | undefined;
+//# sourceMappingURL=LeftDrawerContext.d.ts.map

package/dist/contexts/LeftDrawerContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LeftDrawerContext.d.ts","sourceRoot":"","sources":["../../src/contexts/LeftDrawerContext.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,uBAAuB,EAAE,OAAO,CAAC;IACjC,qBAAqB;IACrB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,uBAAuB;IACvB,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,iBAAiB,4DAElB,CAAC;AAEb;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,QAAO,qBAMhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,qBAAqB,GAAG,SAClC,CAAC"}

package/dist/contexts/index.d.ts

@@ -6,8 +6,10 @@ export { AuthProvider, AuthContext } from "./AuthContext";
 export type { AuthContextType, AuthContextUserInterface, AuthTokenInterface, } from "./AuthContext";
 export { CrudProvider, CrudContext, useCrud } from "./CrudContext";
 export type { CrudContextType } from "./CrudContext";
-export { AppLayoutProvider, useAppLayout, useAppLayoutContext } from "./AppLayoutContext";
+export { AppLayoutProvider, useAppLayout, useAppLayoutContext, } from "./AppLayoutContext";
 export type { AppLayoutContextType, NavbarInterface, LeftDrawerInterface, } from "./AppLayoutContext";
+export { LeftDrawerContext, useLeftDrawer, useOptionalLeftDrawer, } from "./LeftDrawerContext";
+export type { LeftDrawerContextType } from "./LeftDrawerContext";
 export { SnackbarProvider, useSnackbar, useSnackbarState, } from "./SnackbarContext";
 export type { SnackbarContextType, SnackbarActionsType, SnackbarMessage, SnackbarVariant, } from "./SnackbarContext";
 //# sourceMappingURL=index.d.ts.map

package/dist/contexts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EACV,KAAK,EACL,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,UAAU,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,MAAM,EACN,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EACV,eAAe,EACf,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EACV,KAAK,EACL,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,UAAU,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,MAAM,EACN,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EACV,eAAe,EACf,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGjE,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC"}