forlogic-core 1.15.2 → 1.15.4

package/dist/hooks/useI18nFormatters.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Hook para formatação de datas respeitando as preferências do usuário
+ *
+ * Este é o hook RECOMENDADO para formatação de datas na aplicação.
+ * Ele automaticamente usa as configurações de locale e timezone
+ * definidas pelo usuário.
+ *
+ * NOTA: O formato de data/hora está temporariamente fixo em "dd/MM/yyyy HH:mm"
+ * até que a funcionalidade de preferências de formato seja implementada.
+ *
+ * @example
+ * ```tsx
+ * import { useI18nFormatters } from 'forlogic-core';
+ *
+ * function ActivityLog({ createdAt }: { createdAt: string }) {
+ *   const { formatDatetime, formatDate } = useI18nFormatters();
+ *
+ *   return (
+ *     <div>
+ *       <p>Criado em: {formatDatetime(createdAt)}</p>
+ *       <p>Data: {formatDate(createdAt)}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @returns Objeto com funções de formatação e valores de configuração
+ */
+export declare const useI18nFormatters: () => {
+    /** Formata data/hora completa */
+    formatDatetime: (dateString: string) => string;
+    /** Formata apenas data (sem hora) */
+    formatDate: (dateString: string) => string;
+    /** Locale atual do usuário */
+    locale: string;
+    /** Timezone atual do usuário */
+    timezone: string;
+    /** Formato de data/hora atual (fixo por enquanto) */
+    datetimeFormat: string;
+};

package/dist/hooks/usePageTitle.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Hook para obter o título da página atual baseado na rota
+ */
+export declare function usePageTitle(): string;

package/dist/hooks/usePermissionQuery.d.ts

@@ -0,0 +1,49 @@
+interface UsePermissionQueryOptions {
+    key: string;
+    enabled: boolean;
+    checkFn: () => Promise<boolean>;
+    staleTime?: number;
+    gcTime?: number;
+}
+/**
+ * Hook para verificar permissões com cache otimizado
+ *
+ * Usa React Query para cachear verificações de permissão, evitando
+ * chamadas repetidas ao servidor. Ideal para controle de acesso em páginas.
+ *
+ * @example
+ * ```typescript
+ * import { usePermissionQuery } from 'forlogic-core/modular';
+ * import { useAuth } from 'forlogic-core';
+ *
+ * function ProtectedPage() {
+ *   const { isAuthenticated } = useAuth();
+ *
+ *   const { data: hasAccess, isLoading } = usePermissionQuery({
+ *     key: 'can-manage-users',
+ *     enabled: isAuthenticated,
+ *     checkFn: async () => {
+ *       const response = await fetch('/api/permissions/manage-users');
+ *       return response.ok;
+ *     },
+ *     staleTime: 5 * 60 * 1000  // Cache por 5 minutos
+ *   });
+ *
+ *   if (isLoading) return <div>Verificando permissões...</div>;
+ *   if (!hasAccess) return <div>Acesso negado</div>;
+ *
+ *   return <div>Conteúdo protegido</div>;
+ * }
+ * ```
+ *
+ * @param options Configuração da verificação
+ * @param options.key Identificador único da permissão (usado como cache key)
+ * @param options.enabled Se false, não executa a verificação
+ * @param options.checkFn Função async que retorna true/false
+ * @param options.staleTime Tempo de cache em ms (default: 5min)
+ * @param options.gcTime Tempo de garbage collection em ms (default: 10min)
+ *
+ * @returns Query result com { data: boolean, isLoading, error }
+ */
+export declare const usePermissionQuery: ({ key, enabled, checkFn, staleTime, gcTime }: UsePermissionQueryOptions) => import("@tanstack/react-query").UseQueryResult<boolean, Error>;
+export {};

package/dist/hooks/useRowResize.d.ts

@@ -0,0 +1,19 @@
+interface UseRowResizeProps {
+    rowIds: string[];
+    defaultHeight?: number;
+    minHeight?: number;
+    maxHeight?: number;
+    storageKey?: string;
+    onResize?: (heights: Record<string, number>) => void;
+    enabled?: boolean;
+}
+interface UseRowResizeReturn {
+    rowHeights: Record<string, number>;
+    isDragging: boolean;
+    activeRow: string | null;
+    handleMouseDown: (rowId: string, e: React.MouseEvent) => void;
+    resetHeights: () => void;
+    getRowHeight: (rowId: string) => number;
+}
+export declare function useRowResize({ rowIds, defaultHeight, minHeight, maxHeight, storageKey, onResize, enabled }: UseRowResizeProps): UseRowResizeReturn;
+export {};

package/dist/hooks/useSidebarResize.d.ts

@@ -0,0 +1,19 @@
+interface UseSidebarResizeProps {
+    direction?: 'left' | 'right';
+    minWidth?: number;
+    maxWidth?: number;
+    defaultWidth?: number;
+    storageKey?: string;
+    onResize?: (width: number) => void;
+    isOpen?: boolean;
+}
+export declare function useSidebarResize({ direction, minWidth, // 14rem
+maxWidth, // 24rem
+defaultWidth, // 15rem
+storageKey, onResize, isOpen }?: UseSidebarResizeProps): {
+    width: number;
+    isDragging: boolean;
+    dragRef: import("react").MutableRefObject<HTMLDivElement>;
+    handleMouseDown: (e: React.MouseEvent) => void;
+};
+export {};

package/dist/hooks/useWizard.d.ts

@@ -0,0 +1,40 @@
+export interface WizardStep {
+    id: string;
+    label: string;
+    /** Função que valida se pode avançar deste step */
+    canProceed?: () => boolean;
+    /** Se true, este step não pode voltar */
+    disableBack?: boolean;
+}
+export interface UseWizardOptions<TData = Record<string, unknown>> {
+    steps: WizardStep[];
+    initialStep?: number;
+    initialData?: TData;
+    /** Callback quando wizard é concluído */
+    onComplete?: (data: TData) => void | Promise<void>;
+    /** Callback quando wizard é cancelado */
+    onCancel?: () => void;
+}
+export interface UseWizardReturn<TData = Record<string, unknown>> {
+    currentStep: number;
+    currentStepConfig: WizardStep;
+    data: TData;
+    isFirstStep: boolean;
+    isLastStep: boolean;
+    isLoading: boolean;
+    isCompleting: boolean;
+    next: () => Promise<void>;
+    back: () => void;
+    goTo: (step: number) => void;
+    canProceed: boolean;
+    canGoBack: boolean;
+    setData: (data: Partial<TData>) => void;
+    updateField: <K extends keyof TData>(field: K, value: TData[K]) => void;
+    reset: () => void;
+    complete: () => Promise<void>;
+    setLoading: (loading: boolean) => void;
+    progress: number;
+    stepIndex: number;
+    totalSteps: number;
+}
+export declare function useWizard<TData = Record<string, unknown>>(options: UseWizardOptions<TData>): UseWizardReturn<TData>;

package/dist/i18n/DatabaseBackend.d.ts

@@ -0,0 +1,9 @@
+export declare class DatabaseBackend {
+    type: "backend";
+    private isDebugMode;
+    private cache;
+    private loadingPromises;
+    constructor(isDebugMode?: boolean);
+    read(language: string, namespace: string, callback: (err: Error | null, data: any) => void): void;
+    create(languages: string[], namespace: string, key: string, fallbackValue: string): void;
+}

package/dist/i18n/components/TranslationLoader.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+interface TranslationLoaderProps {
+    children: React.ReactNode;
+}
+/**
+ * Passthrough component - traduções agora são carregadas de arquivo local (síncrono).
+ * Mantido para compatibilidade de API.
+ */
+export declare function TranslationLoader({ children }: TranslationLoaderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/i18n/config.d.ts

@@ -0,0 +1,2 @@
+import i18n from 'i18next';
+export default i18n;

package/dist/i18n/constants.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Constantes de Internacionalização (i18n)
+ *
+ * Este arquivo centraliza todas as constantes relacionadas a localização,
+ * formatos de data/hora e fusos horários suportados pelo sistema.
+ *
+ * @example
+ * ```tsx
+ * import { SUPPORTED_LOCALES, DATETIME_FORMATS, TIMEZONES } from 'forlogic-core';
+ *
+ * // Usar em selects de configuração
+ * {SUPPORTED_LOCALES.map(locale => (
+ *   <SelectItem key={locale.value} value={locale.value}>
+ *     {locale.flag} {locale.label}
+ *   </SelectItem>
+ * ))}
+ * ```
+ */
+export interface SupportedLocale {
+    /** Código do locale (ex: 'pt-BR') */
+    value: string;
+    /** Nome legível (ex: 'Português (BR)') */
+    label: string;
+    /** Emoji da bandeira */
+    flag: string;
+}
+export interface DatetimeFormat {
+    /** Máscara de formato date-fns (ex: 'dd/MM/yyyy HH:mm') */
+    value: string;
+    /** Rótulo para exibição */
+    label: string;
+    /** Exemplo formatado (ex: '28/11/2024 14:30') */
+    example: string;
+    /** Descrição do padrão (ex: 'Padrão Brasileiro') */
+    description: string;
+}
+export interface Timezone {
+    /** Identificador IANA (ex: 'America/Sao_Paulo') */
+    value: string;
+    /** Rótulo legível (ex: 'Brasília (UTC-3)') */
+    label: string;
+    /** Offset UTC (ex: '-03:00') */
+    offset: string;
+}
+/**
+ * Locales/idiomas suportados pelo sistema
+ *
+ * @default pt-BR (Português do Brasil)
+ */
+export declare const SUPPORTED_LOCALES: SupportedLocale[];
+/**
+ * Formatos de data/hora disponíveis para o usuário configurar
+ *
+ * Os formatos seguem a sintaxe do date-fns:
+ * - dd: dia com 2 dígitos
+ * - MM: mês com 2 dígitos
+ * - yyyy: ano com 4 dígitos
+ * - HH: hora 24h com 2 dígitos
+ * - hh: hora 12h com 2 dígitos
+ * - mm: minutos com 2 dígitos
+ * - a: AM/PM
+ * - MMM: mês abreviado (Jan, Feb, Mar)
+ *
+ * @default 'dd/MM/yyyy HH:mm' (Padrão Brasileiro)
+ */
+export declare const DATETIME_FORMATS: DatetimeFormat[];
+/**
+ * Fusos horários disponíveis para o usuário configurar
+ *
+ * Inclui os principais fusos horários brasileiros e internacionais.
+ * Os valores seguem o padrão IANA Time Zone Database.
+ *
+ * @default 'America/Sao_Paulo' (Brasília UTC-3)
+ */
+export declare const TIMEZONES: Timezone[];
+/** Locale padrão do sistema */
+export declare const DEFAULT_LOCALE = "pt-BR";
+/** Formato de data/hora padrão */
+export declare const DEFAULT_DATETIME_FORMAT = "dd/MM/yyyy HH:mm";
+/** Fuso horário padrão */
+export declare const DEFAULT_TIMEZONE = "America/Sao_Paulo";
+/**
+ * Encontra um locale pelo valor
+ */
+export declare const findLocale: (value: string) => SupportedLocale | undefined;
+/**
+ * Encontra um formato de data pelo valor
+ */
+export declare const findDatetimeFormat: (value: string) => DatetimeFormat | undefined;
+/**
+ * Encontra um timezone pelo valor
+ */
+export declare const findTimezone: (value: string) => Timezone | undefined;
+/**
+ * Verifica se um valor é um locale válido
+ */
+export declare const isValidLocale: (value: string) => boolean;
+/**
+ * Verifica se um valor é um formato de data válido
+ */
+export declare const isValidDatetimeFormat: (value: string) => boolean;
+/**
+ * Verifica se um valor é um timezone válido
+ */
+export declare const isValidTimezone: (value: string) => boolean;
+/**
+ * Detecta o locale do navegador e retorna um valor suportado
+ */
+export declare const detectBrowserLocale: () => string;
+/**
+ * Detecta o timezone do navegador usando Intl API
+ */
+export declare const detectBrowserTimezone: () => string;
+/**
+ * Infere o formato de data/hora baseado no locale detectado
+ */
+export declare const inferDatetimeFormat: (locale: string) => string;
+/**
+ * Detecta todas as preferências do navegador/SO
+ * Usado como estado inicial antes da autenticação e para novos usuários
+ */
+export declare const detectBrowserPreferences: () => {
+    locale: string;
+    timezone: string;
+    datetimeFormat: string;
+};

package/dist/i18n/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Internationalization (i18n) Exports
+ *
+ * Centralized exports for i18n configuration and hooks.
+ * Import this instead of importing directly from react-i18next.
+ *
+ * @example
+ * ```tsx
+ * import { useTranslation } from 'forlogic-core/i18n';
+ *
+ * function MyComponent() {
+ *   const { t } = useTranslation();
+ *   return <Button>{t('save')}</Button>;
+ * }
+ * ```
+ */
+export { default as i18n } from './config';
+export { useTranslation } from 'react-i18next';
+export { I18nextProvider } from 'react-i18next';
+export { TranslationLoader } from './components/TranslationLoader';
+export * from './constants';

package/dist/index.d.ts

@@ -0,0 +1,83 @@
+import './index.css';
+export { Button } from './components/ui/button';
+export { ActionButton } from './components/ui/action-button';
+export { Input } from './components/ui/input';
+export { Label } from './components/ui/label';
+export { Card, CardContent, CardHeader, CardTitle, CardDescription } from './components/ui/card';
+export { Dialog, DialogContent, DialogHeader, DialogTitle, DialogTrigger, DialogFooter } from './components/ui/dialog';
+export { Form, FormField, FormItem, FormLabel, FormControl, FormMessage } from './components/ui/form';
+export { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from './components/ui/select';
+export { Checkbox } from './components/ui/checkbox';
+export { Textarea } from './components/ui/textarea';
+export { Badge } from './components/ui/badge';
+export { LoadingState } from './components/ui/loading-state';
+export { Toaster, toast } from './components/ui/sonner';
+export { DisabledMenuItem } from './components/ui/disabled-menu-item';
+export { Combobox } from './components/ui/combobox';
+export type { ComboboxProps } from './components/ui/combobox';
+export { Combobox as SelectSearch } from './components/ui/combobox';
+export type { ComboboxProps as SelectSearchProps } from './components/ui/combobox';
+export { Combobox as MultiSelect } from './components/ui/combobox';
+export type { ComboboxProps as MultiSelectProps } from './components/ui/combobox';
+export { createSimpleService } from './crud/createSimpleService';
+export { createCrudPage, createSimpleSaveHandler, CrudPageInternal } from './crud/createCrudPage';
+export { generateCrudConfig } from './crud/generateCrudConfig';
+export { default as BaseForm } from './crud/components/BaseForm';
+export { useAuth } from './auth/contexts/AuthContext';
+export { ProtectedRoute } from './auth/components/ProtectedRoute';
+export { CallbackPage } from './auth/pages/CallbackPage';
+export { LoginPage } from './auth/pages/LoginPage';
+export { cn } from './utils';
+export { formatDatetime, formatCurrency } from './utils';
+export { usePageMetadata, PageMetadataProvider, usePageMetadataContext } from './contexts/PageMetadataContext';
+export type { CrudEntity, FormSection, BulkAction, CrudFilter, QualiexUserFieldMapping, QualiexEnrichmentConfig } from './types';
+export { setupQualiexCore } from './setup';
+export { CoreProviders } from './providers/CoreProviders';
+export type { CoreProvidersProps } from './providers/CoreProviders';
+export * from './exports/ui';
+export * from './exports/crud';
+export * from './exports/integrations';
+export { default as AppHeader } from './components/layout/AppHeader';
+export * from './components/layout/AppSidebar';
+export * from './components/layout/AppLayout';
+export { SidebarHeader } from './components/layout/SidebarHeader';
+export type { SidebarHeaderProps } from './components/layout/SidebarHeader';
+export { SidebarActionTrigger } from './components/layout/SidebarActionTrigger';
+export type { SidebarActionTriggerProps } from './components/layout/SidebarActionTrigger';
+export { BodyContent, ContentContainer } from './components/layout/BodyContent';
+export type { BodyContentProps, ContentContainerProps, BreadcrumbItemConfig } from './components/layout/BodyContent';
+export * from './components/ErrorBoundary';
+export * from './hooks/useActiveModules';
+export * from './hooks/useDebounce';
+export * from './hooks/usePageTitle';
+export * from './hooks/usePermissionQuery';
+export { useSidebarResize } from './hooks/useSidebarResize';
+export { useColumnResize } from './hooks/useColumnResize';
+export { useRowResize } from './hooks/useRowResize';
+export { useWizard } from './hooks/useWizard';
+export type { WizardStep, UseWizardOptions, UseWizardReturn } from './hooks/useWizard';
+export * from './i18n';
+export * from './contexts/LocaleContext';
+export * from './hooks/useI18nFormatters';
+export * from './utils/formatters/dateFormatters';
+export * from './utils/formatters/currencyFormatters';
+export * from './contexts/NavigationContext';
+export { ModalStateProvider, useModalState, useHasOpenModal } from './contexts/ModalStateContext';
+export type { ModalStateProviderProps } from './contexts/ModalStateContext';
+export * from './services/BaseService';
+export { errorService } from './services/ErrorService';
+export { emailService, EmailService } from './services/EmailService';
+export type { SendEmailParams } from './services/EmailService';
+export * from './services/QualiexEnrichmentService';
+export { resolveFieldMappings, deriveNameField, deriveEmailField, deriveUsernameField } from './services/QualiexFieldHelpers';
+export { translationService } from './services/TranslationService';
+export * from './utils';
+export * from './types';
+export * from './types/sidebar';
+export * from './config';
+export * from './assets';
+export * from './places';
+export * from './leadership';
+export * from './media';
+export * from './components/modules';
+export * from './sign';