teraprox-ui-kit 0.1.0 → 0.1.2

package/dist/index.d.mts

@@ -13,6 +13,43 @@ interface DeleteButtonProps {
 }
 declare const DeleteButton: React.FC<DeleteButtonProps>;
 
+interface ActionButtonsProps {
+    /** Botão Salvar */
+    onSave?: () => void;
+    saveLabel?: string;
+    saveVariant?: string;
+    disabled?: boolean;
+    /** Botão Excluir */
+    onDelete?: (details?: string) => void;
+    deleteLabel?: string;
+    deleteConfirmMsg?: string;
+    needExclusionDetails?: boolean;
+    /** Botão Voltar */
+    onBack?: () => void;
+    backLabel?: string;
+    /** Botão Cancelar Edição */
+    onCancelEdit?: () => void;
+    cancelEditLabel?: string;
+    /** Botão Copiar Form */
+    onCopy?: () => void;
+    copyLabel?: string;
+    /** Meta-estado */
+    isEditing?: boolean;
+    /** Configuração Especial: Deleção com Delay (Hold for 3s) */
+    useDelayedDelete?: boolean;
+    delayedDeleteTimeout?: number;
+    /** Wrapper opcional para controle de permissões (ex: PermissionContainer) */
+    PermissionWrapper?: React.ComponentType<{
+        children: React.ReactNode;
+        id?: string;
+    }>;
+}
+/**
+ * Agrupamento de botões de ação (Salvar, Excluir, Voltar, etc) padronizado.
+ * Agrega funcionalidade de confirmação de deleção e animação de 'hold-to-delete'.
+ */
+declare const ActionButtons: React.FC<ActionButtonsProps>;
+
 interface ResponsiveContainerProps {
     title?: string;
     show: boolean;
@@ -68,6 +105,117 @@ interface GenericDisplayProps {
 }
 declare const GenericDisplay: React.FC<GenericDisplayProps>;
 
+interface MailSenderProps {
+    /** Conteúdo HTML a ser enviado no corpo do e-mail */
+    htmlContent: string;
+    /** Nome da empresa para o assunto/corpo padrão */
+    companyName: string;
+    /** Callback para buscar a lista de e-mails da companhia */
+    onFetchEmails: () => Promise<Array<{
+        email: string;
+    }>>;
+    /** Callback para enviar o e-mail consolidado */
+    onSendEmail: (emailData: {
+        to: string;
+        subject: string;
+        text: string;
+        html: string;
+    }) => Promise<void>;
+    /** Flag para ocultar o componente */
+    hide?: boolean;
+    /** Render prop opcional para o botão de ativação customizado */
+    renderTrigger?: (props: {
+        onClick: () => void;
+        loading: boolean;
+    }) => React.ReactNode;
+}
+/**
+ * Componente para seleção de destinatários e envio de e-mails.
+ * Refatorado para ser agnóstico a implementações de hooks/endpoints específicos das apps.
+ */
+declare const MailSender: React.FC<MailSenderProps>;
+
+interface DeleteConfirmProps {
+    /** Controla visibilidade do modal */
+    show: boolean;
+    /** Fecha o modal */
+    onHide: (show: boolean) => void;
+    /** Callback chamado ao confirmar a exclusão */
+    onConfirm: (details: string) => void;
+    /** Título do modal */
+    title?: string;
+    /** Texto do corpo do modal (pode ser string ou função que recebe payload) */
+    dialogText?: string | ((payload: any) => string);
+    /** Dados extras para o dialogText */
+    payload?: any;
+    /** Se true, exige um campo de 'Motivo' com pelo menos 8 caracteres */
+    needExclusionDetails?: boolean;
+}
+/**
+ * Modal de confirmação de exclusão padronizado.
+ */
+declare const DeleteConfirm: React.FC<DeleteConfirmProps>;
+
+interface AutoCompleteProps {
+    className?: string;
+    /** Opções estáticas iniciais */
+    ops?: any[];
+    /** Chave para ordenação */
+    sortKey?: string;
+    /** Chave para exibição no input */
+    displayKey?: string;
+    /** Chaves para exibição concatenada */
+    displayKeys?: string[];
+    /** Callback de alteração no input */
+    onValueChanged?: (val: string) => void;
+    /** Callback ao clicar em uma sugestão */
+    onSelectedClick: (li: any, index: number, lItem: any[]) => void;
+    /** Valor controlado */
+    value?: string;
+    /** Botão de ação opcional (ex: clear) */
+    actionButton?: (clear: () => void) => React.ReactNode;
+    /** Segundo botão de ação opcional */
+    actionButton2?: (input: string) => React.ReactNode;
+    placeH?: string;
+    title?: string;
+    /** Valor para filtrar a lista inicial */
+    filter?: any;
+    filterField?: string;
+    /** Função de carregamento assíncrono */
+    loadFunc?: () => Promise<any[]>;
+    /** Condição para disparar o carregamento */
+    loadCondition?: boolean;
+    onBlurEvent?: (e: React.FocusEvent<HTMLInputElement>, input: string) => void;
+    /** Função customizada para formatar a label da lista */
+    formatationFunc?: (item: any) => string;
+    onEscKeyDown?: () => void;
+    onEnterKeyDown?: (input: string) => void;
+    /** Margem superior */
+    margT?: number;
+    /** Margem inferior */
+    margB?: number;
+    hideComponent?: boolean;
+    disableComponent?: boolean;
+    disableSelect?: boolean;
+    autoFocusConfig?: boolean;
+    onLoad?: (data: any[]) => void;
+    /** Chave para cache em memória */
+    cacheKey?: string;
+    /** Mínimo de caracteres para mostrar a lista */
+    minChars?: number;
+    /** Limite de itens na lista */
+    maxItems?: number;
+    /** Se deve mostrar a lista ao focar */
+    showListOnFocus?: boolean;
+    /** Se deve carregar sob demanda ao digitar */
+    lazyLoad?: boolean;
+}
+/**
+ * Componente de Input com Auto-complete dinâmico.
+ * Suporta cache em memória compartilhada entre instâncias via window.
+ */
+declare const AutoComplete: React.FC<AutoCompleteProps>;
+
 interface SelectOption {
     label: string;
     value: string | number;
@@ -131,4 +279,4 @@ declare class GenericSelectOps {
 }
 declare const GenericSelect: React.FC<GenericSelectProps>;
 
-export { AddButton, ConfigObject, DeleteButton, GenericDisplay, GenericForm, GenericSelect, GenericSelectOps, ResponsiveContainer, UuidPill };
+export { ActionButtons, type ActionButtonsProps, AddButton, AutoComplete, type AutoCompleteProps, ConfigObject, DeleteButton, DeleteConfirm, type DeleteConfirmProps, GenericDisplay, GenericForm, GenericSelect, GenericSelectOps, MailSender, type MailSenderProps, ResponsiveContainer, UuidPill };

package/dist/index.d.ts

@@ -13,6 +13,43 @@ interface DeleteButtonProps {
 }
 declare const DeleteButton: React.FC<DeleteButtonProps>;
 
+interface ActionButtonsProps {
+    /** Botão Salvar */
+    onSave?: () => void;
+    saveLabel?: string;
+    saveVariant?: string;
+    disabled?: boolean;
+    /** Botão Excluir */
+    onDelete?: (details?: string) => void;
+    deleteLabel?: string;
+    deleteConfirmMsg?: string;
+    needExclusionDetails?: boolean;
+    /** Botão Voltar */
+    onBack?: () => void;
+    backLabel?: string;
+    /** Botão Cancelar Edição */
+    onCancelEdit?: () => void;
+    cancelEditLabel?: string;
+    /** Botão Copiar Form */
+    onCopy?: () => void;
+    copyLabel?: string;
+    /** Meta-estado */
+    isEditing?: boolean;
+    /** Configuração Especial: Deleção com Delay (Hold for 3s) */
+    useDelayedDelete?: boolean;
+    delayedDeleteTimeout?: number;
+    /** Wrapper opcional para controle de permissões (ex: PermissionContainer) */
+    PermissionWrapper?: React.ComponentType<{
+        children: React.ReactNode;
+        id?: string;
+    }>;
+}
+/**
+ * Agrupamento de botões de ação (Salvar, Excluir, Voltar, etc) padronizado.
+ * Agrega funcionalidade de confirmação de deleção e animação de 'hold-to-delete'.
+ */
+declare const ActionButtons: React.FC<ActionButtonsProps>;
+
 interface ResponsiveContainerProps {
     title?: string;
     show: boolean;
@@ -68,6 +105,117 @@ interface GenericDisplayProps {
 }
 declare const GenericDisplay: React.FC<GenericDisplayProps>;
 
+interface MailSenderProps {
+    /** Conteúdo HTML a ser enviado no corpo do e-mail */
+    htmlContent: string;
+    /** Nome da empresa para o assunto/corpo padrão */
+    companyName: string;
+    /** Callback para buscar a lista de e-mails da companhia */
+    onFetchEmails: () => Promise<Array<{
+        email: string;
+    }>>;
+    /** Callback para enviar o e-mail consolidado */
+    onSendEmail: (emailData: {
+        to: string;
+        subject: string;
+        text: string;
+        html: string;
+    }) => Promise<void>;
+    /** Flag para ocultar o componente */
+    hide?: boolean;
+    /** Render prop opcional para o botão de ativação customizado */
+    renderTrigger?: (props: {
+        onClick: () => void;
+        loading: boolean;
+    }) => React.ReactNode;
+}
+/**
+ * Componente para seleção de destinatários e envio de e-mails.
+ * Refatorado para ser agnóstico a implementações de hooks/endpoints específicos das apps.
+ */
+declare const MailSender: React.FC<MailSenderProps>;
+
+interface DeleteConfirmProps {
+    /** Controla visibilidade do modal */
+    show: boolean;
+    /** Fecha o modal */
+    onHide: (show: boolean) => void;
+    /** Callback chamado ao confirmar a exclusão */
+    onConfirm: (details: string) => void;
+    /** Título do modal */
+    title?: string;
+    /** Texto do corpo do modal (pode ser string ou função que recebe payload) */
+    dialogText?: string | ((payload: any) => string);
+    /** Dados extras para o dialogText */
+    payload?: any;
+    /** Se true, exige um campo de 'Motivo' com pelo menos 8 caracteres */
+    needExclusionDetails?: boolean;
+}
+/**
+ * Modal de confirmação de exclusão padronizado.
+ */
+declare const DeleteConfirm: React.FC<DeleteConfirmProps>;
+
+interface AutoCompleteProps {
+    className?: string;
+    /** Opções estáticas iniciais */
+    ops?: any[];
+    /** Chave para ordenação */
+    sortKey?: string;
+    /** Chave para exibição no input */
+    displayKey?: string;
+    /** Chaves para exibição concatenada */
+    displayKeys?: string[];
+    /** Callback de alteração no input */
+    onValueChanged?: (val: string) => void;
+    /** Callback ao clicar em uma sugestão */
+    onSelectedClick: (li: any, index: number, lItem: any[]) => void;
+    /** Valor controlado */
+    value?: string;
+    /** Botão de ação opcional (ex: clear) */
+    actionButton?: (clear: () => void) => React.ReactNode;
+    /** Segundo botão de ação opcional */
+    actionButton2?: (input: string) => React.ReactNode;
+    placeH?: string;
+    title?: string;
+    /** Valor para filtrar a lista inicial */
+    filter?: any;
+    filterField?: string;
+    /** Função de carregamento assíncrono */
+    loadFunc?: () => Promise<any[]>;
+    /** Condição para disparar o carregamento */
+    loadCondition?: boolean;
+    onBlurEvent?: (e: React.FocusEvent<HTMLInputElement>, input: string) => void;
+    /** Função customizada para formatar a label da lista */
+    formatationFunc?: (item: any) => string;
+    onEscKeyDown?: () => void;
+    onEnterKeyDown?: (input: string) => void;
+    /** Margem superior */
+    margT?: number;
+    /** Margem inferior */
+    margB?: number;
+    hideComponent?: boolean;
+    disableComponent?: boolean;
+    disableSelect?: boolean;
+    autoFocusConfig?: boolean;
+    onLoad?: (data: any[]) => void;
+    /** Chave para cache em memória */
+    cacheKey?: string;
+    /** Mínimo de caracteres para mostrar a lista */
+    minChars?: number;
+    /** Limite de itens na lista */
+    maxItems?: number;
+    /** Se deve mostrar a lista ao focar */
+    showListOnFocus?: boolean;
+    /** Se deve carregar sob demanda ao digitar */
+    lazyLoad?: boolean;
+}
+/**
+ * Componente de Input com Auto-complete dinâmico.
+ * Suporta cache em memória compartilhada entre instâncias via window.
+ */
+declare const AutoComplete: React.FC<AutoCompleteProps>;
+
 interface SelectOption {
     label: string;
     value: string | number;
@@ -131,4 +279,4 @@ declare class GenericSelectOps {
 }
 declare const GenericSelect: React.FC<GenericSelectProps>;
 
-export { AddButton, ConfigObject, DeleteButton, GenericDisplay, GenericForm, GenericSelect, GenericSelectOps, ResponsiveContainer, UuidPill };
+export { ActionButtons, type ActionButtonsProps, AddButton, AutoComplete, type AutoCompleteProps, ConfigObject, DeleteButton, DeleteConfirm, type DeleteConfirmProps, GenericDisplay, GenericForm, GenericSelect, GenericSelectOps, MailSender, type MailSenderProps, ResponsiveContainer, UuidPill };