@archbase/admin 3.0.3 → 3.0.5

package/dist/ArchbaseAdminLayout.context.d.ts

@@ -17,6 +17,10 @@ export interface ArchbaseAdminLayoutContextValue {
     hidden?: boolean;
     setHidden?: (value: boolean) => void;
     onNavigationDataChange?: (navigationData: ArchbaseNavigationItem[]) => void;
+    /** Indica se as permissões de navegação estão sendo carregadas */
+    isLoadingPermissions?: boolean;
+    /** Mensagem de erro ao carregar permissões (null se não houver erro) */
+    permissionsError?: string | null;
 }
 export interface ArchbaseAdminLayoutContextProps {
     navigationData?: ArchbaseNavigationItem[];

package/dist/ArchbaseAdvancedSidebar.d.ts

@@ -35,5 +35,17 @@ export interface ArchbaseAdvancedSidebarProps {
     iconDarkColor?: string;
     iconLightColor?: string;
     collapsedSubmenuWidth?: string | number;
+    /** Indica se as permissões estão sendo carregadas (exibe skeleton na área do menu) */
+    isLoading?: boolean;
+    /** Mensagem de erro ao carregar permissões (exibe mensagem na área do menu) */
+    loadingError?: string | null;
+    /** Componente customizado para exibir durante o carregamento */
+    loadingComponent?: ReactNode;
+    /** Componente customizado para exibir quando ocorrer erro */
+    errorComponent?: ReactNode;
+    /** Número de itens no skeleton durante loading */
+    skeletonItemCount?: number;
+    /** Número de grupos no skeleton durante loading */
+    skeletonGroupCount?: number;
 }
 export declare function ArchbaseAdvancedSidebar({ navigationData, sidebarGroupWidth, sidebarWidth, sidebarHeight, sidebarCollapsedWidth, selectedGroupColor, groupColor, backgroundGroupColor, isHidden, sideBarFooterHeight, sideBarFooterContent, groupLabelDarkColor, groupLabelLightColor, collapsed, onMenuItemClick, onClickActionIcon, withBorder, showGroupLabels, theme, sidebarRef, defaultGroupIcon, selectedGroupName, sideBarHeaderContent, iconsWithBackground, menuItemHeight, highlightActiveMenuItem, backgroundDarkColor, backgroundLightColor, textDarkColor, textLightColor, iconDarkColor, iconLightColor, collapsedSubmenuWidth, }: ArchbaseAdvancedSidebarProps): import("react/jsx-runtime").JSX.Element;

package/dist/ArchbaseAliveAbleRoutes.d.ts

@@ -1,10 +1,71 @@
 import { default as React, ReactNode } from 'react';
 import { RouteProps, RoutesProps } from 'react-router';
+import { Params } from 'react-router-dom';
+interface KeepAliveVisibilityContextValue {
+    isVisible: boolean;
+}
+/**
+ * Hook para acessar o estado de visibilidade do componente keep-alive.
+ * Use este hook quando precisar reagir a mudanças de visibilidade da tab,
+ * por exemplo, para recalcular dimensões de grids ou gráficos.
+ *
+ * @example
+ * import { useKeepAliveVisibility } from '@archbase/admin';
+ *
+ * function MeuGrid() {
+ *   const { isVisible } = useKeepAliveVisibility();
+ *   const gridRef = useRef();
+ *
+ *   useEffect(() => {
+ *     if (isVisible && gridRef.current) {
+ *       // Força recálculo de dimensões quando tab fica visível
+ *       gridRef.current.api?.sizeColumnsToFit();
+ *     }
+ *   }, [isVisible]);
+ *
+ *   return <DataGrid ref={gridRef} ... />;
+ * }
+ */
+export declare const useKeepAliveVisibility: () => KeepAliveVisibilityContextValue;
+/**
+ * Hook para acessar os parâmetros da rota atual.
+ * Este hook funciona tanto dentro quanto fora do contexto do React Router Routes,
+ * sendo essencial para componentes que usam keepAlive.
+ *
+ * @example
+ * // Dentro de um componente com keepAlive
+ * const { id } = useArchbaseRouteParams();
+ */
+export declare const useArchbaseRouteParams: <T extends Params<string> = Params<string>>() => T;
+/**
+ * Hook de compatibilidade que funciona tanto com React Router quanto com keep-alive.
+ *
+ * Este hook tenta obter os parâmetros do React Router primeiro. Se não encontrar
+ * parâmetros (objeto vazio ou todos os valores undefined), usa o contexto do keep-alive.
+ *
+ * Use este hook como substituto direto do useParams do React Router para garantir
+ * compatibilidade com componentes que podem ou não usar keepAlive.
+ *
+ * @example
+ * // Substitui useParams do react-router-dom
+ * import { useParams } from '@archbase/admin';
+ * const { id } = useParams<{ id: string }>();
+ *
+ * @example
+ * // Funciona tanto com keepAlive: true quanto keepAlive: false
+ * const { id, slug } = useParams<{ id: string; slug: string }>();
+ */
+export declare const useParams: <T extends Params<string> = Params<string>>() => T;
+interface CachedComponent {
+    element: ReactNode;
+    params: Params<string>;
+}
 interface KeepAliveCacheContextValue {
-    cache: Map<string, ReactNode>;
+    cache: Map<string, CachedComponent>;
     requestedUnregister: Set<string>;
-    register: (path: string, component: ReactNode) => void;
-    unregister: (path: string) => void;
+    register: (cacheKey: string, component: ReactNode, params: Params<string>) => void;
+    unregister: (cacheKey: string) => void;
+    updateParams: (cacheKey: string, params: Params<string>) => void;
     requestUnregister: (path: string) => void;
 }
 export declare const useKeepAliveCache: () => KeepAliveCacheContextValue;

package/dist/SidebarMenuSkeleton.d.ts

@@ -0,0 +1,41 @@
+import { ReactNode } from 'react';
+export interface SidebarMenuSkeletonProps {
+    /** Número de itens de menu a exibir no skeleton */
+    itemCount?: number;
+    /** Se a sidebar está colapsada */
+    collapsed?: boolean;
+    /** Cor de fundo */
+    backgroundColor?: string;
+}
+/**
+ * Skeleton padrão para a área de itens de menu da sidebar.
+ * Usa o estilo padrão do Mantine (cinza animado).
+ */
+export declare function SidebarMenuSkeleton({ itemCount, collapsed, backgroundColor, }: SidebarMenuSkeletonProps): import("react/jsx-runtime").JSX.Element;
+export interface SidebarGroupsSkeletonProps {
+    /** Número de grupos a exibir no skeleton */
+    groupCount?: number;
+    /** Largura da coluna de grupos */
+    width?: string | number;
+    /** Altura da sidebar */
+    height?: string | number;
+    /** Cor de fundo da área de grupos */
+    backgroundColor?: string;
+}
+/**
+ * Skeleton para a área de grupos da sidebar (coluna lateral com ícones).
+ * Usa o estilo padrão do Mantine (cinza animado).
+ */
+export declare function SidebarGroupsSkeleton({ groupCount, width, height, backgroundColor, }: SidebarGroupsSkeletonProps): import("react/jsx-runtime").JSX.Element;
+export interface SidebarErrorMessageProps {
+    /** Mensagem de erro a exibir */
+    message: string;
+    /** Cor de fundo */
+    backgroundColor?: string;
+    /** Componente customizado para exibir o erro */
+    children?: ReactNode;
+}
+/**
+ * Componente para exibir mensagem de erro na sidebar.
+ */
+export declare function SidebarErrorMessage({ message, backgroundColor, children, }: SidebarErrorMessageProps): import("react/jsx-runtime").JSX.Element;

package/dist/index.d.ts

@@ -16,11 +16,14 @@ export { ArchbaseNavigationContext, ArchbaseNavigationProvider, useArchbaseNavig
 export type { ArchbaseNavigationContextValues, ArchbaseNavigationListenerType } from './ArchbaseNavigation.context';
 export { navigationDataSample } from './navigationData';
 export type { ArchbaseNavigationItem, ArchbaseCommandColor, ArchbaseCommandMenu, ArchbaseOwner, ArchbaseCompany, ArchbaseTabItem, LocationDataItem, } from './types';
-export { ArchbaseKeepAliveRoute, ArchbaseAliveAbleRoutes } from './ArchbaseAliveAbleRoutes';
+export { ArchbaseKeepAliveRoute, ArchbaseAliveAbleRoutes, useKeepAliveVisibility, useArchbaseRouteParams, useParams, useKeepAliveCache } from './ArchbaseAliveAbleRoutes';
+export type { ArchbaseKeepAliveRouteProps } from './ArchbaseAliveAbleRoutes';
 export type { CommandPaletteButtonProps, ArchbaseSpotlightActionData } from './CommandPaletteButton';
 export { CommandPaletteButton } from './CommandPaletteButton';
 export type { ArchbaseAdvancedSidebarProps } from './ArchbaseAdvancedSidebar';
 export { ArchbaseAdvancedSidebar } from './ArchbaseAdvancedSidebar';
+export type { SidebarMenuSkeletonProps, SidebarGroupsSkeletonProps, SidebarErrorMessageProps } from './SidebarMenuSkeleton';
+export { SidebarMenuSkeleton, SidebarGroupsSkeleton, SidebarErrorMessage } from './SidebarMenuSkeleton';
 export { ArchbaseDrawerContent } from './drawer/DrawerContent';
 export type { ArchbaseDrawerContentProps } from './drawer/DrawerContent';
 export { ArchbaseDrawerTrigger } from './drawer/DrawerTrigger';