forlogic-core 2.0.4 → 2.0.5

package/.note/memory/features/crud-defaults-batteries-included.md

@@ -3,7 +3,7 @@
 Todos os CRUDs (CrudTable, createCrudPage) agora incluem por padrão:
 - **Column resize** (`enableColumnResize=true`) — já era default
 - **Column manager** (`enableColumnManager=true`) — botão ⋮ no header da coluna "Ações"
-- **Sort** — já era suportado via `sortable` nas colunas
+- **Sort** — **todas as colunas são ordenáveis por padrão** (`sortable` default `true`). Use `sortable: false` para desabilitar.
 - **Busca** — por padrão usa a busca global do header (não a action bar). Para busca na action bar, usar `showSearch=true`
 - **Storage keys** — `createCrudPage` gera automaticamente `columnManagerStorageKey` e `resizeStorageKey` a partir do `entityName`
 

package/dist/components/ui/dialog-wizard.d.ts

@@ -0,0 +1,82 @@
+import * as React from 'react';
+import { type DialogVariant, type DialogSize } from './dialog';
+/**
+ * DialogWizard — Dialog com stepper vertical lateral (padrão v2)
+ *
+ * Substitui o padrão anterior de StepSelector horizontal no footer.
+ * Renderiza uma sidebar à esquerda com círculos numerados sobre fundo primário
+ * e área de conteúdo à direita com header, body scrollável e footer com navegação.
+ *
+ * @example
+ * ```tsx
+ * <DialogWizard
+ *   open={open}
+ *   onOpenChange={setOpen}
+ *   currentStep={step}
+ *   onStepChange={setStep}
+ *   steps={['Geral', 'Formulário', 'Configuração']}
+ *   title="Novo Documento"
+ *   onSave={handleSave}
+ * >
+ *   {step === 1 && <StepOneContent />}
+ *   {step === 2 && <StepTwoContent />}
+ *   {step === 3 && <StepThreeContent />}
+ * </DialogWizard>
+ * ```
+ */
+export interface DialogWizardProps {
+    /** Controla se o dialog está aberto */
+    open: boolean;
+    /** Callback de abertura/fechamento */
+    onOpenChange: (open: boolean) => void;
+    /** Etapa atual (1-indexed) */
+    currentStep: number;
+    /** Callback chamado quando uma etapa é selecionada */
+    onStepChange: (step: number) => void;
+    /** Labels das etapas */
+    steps: string[];
+    /**
+     * Função que valida se pode navegar para uma etapa específica.
+     * Voltar para etapas anteriores é sempre permitido.
+     * Se não fornecida, todas as etapas são acessíveis.
+     */
+    canGoToStep?: (targetStep: number) => boolean;
+    /** Conteúdo do step atual */
+    children: React.ReactNode;
+    /** Título exibido no header da área de conteúdo */
+    title: string;
+    /** Subtítulo opcional abaixo do título */
+    description?: string;
+    /** Callback do botão "Salvar" no último step */
+    onSave?: () => void;
+    /** Label do botão salvar (default: "Salvar") */
+    saveLabel?: string;
+    /** Label do botão próximo (default: "Próximo") */
+    nextLabel?: string;
+    /** Label do botão voltar (default: "Voltar") */
+    backLabel?: string;
+    /** Variante do DialogContent */
+    variant?: DialogVariant;
+    /** Indica se há alterações não salvas */
+    isDirty?: boolean;
+    /** Tamanho do DialogContent */
+    size?: DialogSize;
+    /** i18n: Title for unsaved changes alert */
+    unsavedChangesTitle?: string;
+    /** i18n: Description for unsaved changes alert */
+    unsavedChangesDescription?: string;
+    /** i18n: Cancel button text */
+    cancelText?: string;
+    /** i18n: Leave without saving button text */
+    leaveWithoutSavingText?: string;
+    /** Classes CSS adicionais no container externo */
+    className?: string;
+    /** Desabilitar botão próximo/salvar (ex: validação do step) */
+    disableNext?: boolean;
+    /** Ocultar botões de navegação do footer (para controle manual) */
+    hideNavigation?: boolean;
+    /** Conteúdo extra no footer (à esquerda dos botões de navegação) */
+    footerLeft?: React.ReactNode;
+}
+declare function DialogWizard({ open, onOpenChange, currentStep, onStepChange, steps, canGoToStep, children, title, description, onSave, saveLabel, nextLabel, backLabel, variant, isDirty, size, unsavedChangesTitle, unsavedChangesDescription, cancelText, leaveWithoutSavingText, className, disableNext, hideNavigation, footerLeft, }: DialogWizardProps): import("react/jsx-runtime").JSX.Element;
+export { DialogWizard };

package/dist/components/ui/input-group.d.ts

@@ -76,7 +76,7 @@ declare const InputGroupButton: React.ForwardRefExoticComponent<InputGroupButton
  * <InputGroupInput placeholder="Digite aqui..." />
  * ```
  */
-declare const InputGroupInput: React.ForwardRefExoticComponent<Omit<Omit<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & React.RefAttributes<HTMLInputElement>, "ref"> & React.RefAttributes<HTMLInputElement>>;
+declare const InputGroupInput: React.ForwardRefExoticComponent<Omit<Omit<import("./input").InputProps, "ref"> & React.RefAttributes<HTMLInputElement>, "ref"> & React.RefAttributes<HTMLInputElement>>;
 /**
  * InputGroupTextarea Component
  *

package/dist/components/ui/input.d.ts

@@ -9,29 +9,11 @@ import * as React from "react";
  * <Input type="text" placeholder="Digite seu nome" />
  * <Input type="email" placeholder="email@exemplo.com" />
  * <Input type="password" placeholder="Senha" />
- * ```
- *
- * ## Características
- * - Suporte a todos os tipos HTML (text, email, password, number, etc.)
- * - Estados de foco, disabled e error
- * - Integração com react-hook-form
- * - Estilos do design system
- *
- * ## Uso com Formulários
- * ```tsx
- * <FormField
- *   control={form.control}
- *   name="email"
- *   render={({ field }) => (
- *     <FormItem>
- *       <FormLabel>Email</FormLabel>
- *       <FormControl>
- *         <Input placeholder="email@exemplo.com" {...field} />
- *       </FormControl>
- *     </FormItem>
- *   )}
- * />
+ * <Input showCharCount maxLength={150} placeholder="Com contador" />
  * ```
  */
-declare const Input: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & React.RefAttributes<HTMLInputElement>>;
+export interface InputProps extends React.ComponentProps<"input"> {
+    showCharCount?: boolean;
+}
+declare const Input: React.ForwardRefExoticComponent<Omit<InputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
 export { Input };

package/dist/components/ui/resizable.d.ts

@@ -1,6 +1,6 @@
 import * as ResizablePrimitive from "react-resizable-panels";
 declare const ResizablePanelGroup: ({ className, ...props }: React.ComponentProps<typeof ResizablePrimitive.PanelGroup>) => import("react/jsx-runtime").JSX.Element;
-declare const ResizablePanel: import("react").ForwardRefExoticComponent<Omit<import("react").HTMLAttributes<HTMLLinkElement | HTMLElement | HTMLHeadElement | HTMLButtonElement | HTMLInputElement | HTMLLabelElement | HTMLObjectElement | HTMLAnchorElement | HTMLAreaElement | HTMLAudioElement | HTMLBaseElement | HTMLQuoteElement | HTMLBodyElement | HTMLBRElement | HTMLCanvasElement | HTMLTableColElement | HTMLDataElement | HTMLDataListElement | HTMLModElement | HTMLDetailsElement | HTMLDialogElement | HTMLDivElement | HTMLDListElement | HTMLEmbedElement | HTMLFieldSetElement | HTMLFormElement | HTMLHeadingElement | HTMLHRElement | HTMLHtmlElement | HTMLIFrameElement | HTMLImageElement | HTMLLegendElement | HTMLLIElement | HTMLMapElement | HTMLMetaElement | HTMLMeterElement | HTMLOListElement | HTMLOptGroupElement | HTMLOptionElement | HTMLOutputElement | HTMLParagraphElement | HTMLPreElement | HTMLProgressElement | HTMLScriptElement | HTMLSelectElement | HTMLSlotElement | HTMLSourceElement | HTMLSpanElement | HTMLStyleElement | HTMLTableElement | HTMLTableSectionElement | HTMLTableCellElement | HTMLTemplateElement | HTMLTextAreaElement | HTMLTimeElement | HTMLTitleElement | HTMLTableRowElement | HTMLTrackElement | HTMLUListElement | HTMLVideoElement | HTMLTableCaptionElement | HTMLMenuElement | HTMLPictureElement>, "id" | "onResize"> & {
+declare const ResizablePanel: import("react").ForwardRefExoticComponent<Omit<import("react").HTMLAttributes<HTMLLinkElement | HTMLElement | HTMLHeadElement | HTMLButtonElement | HTMLInputElement | HTMLDivElement | HTMLLabelElement | HTMLObjectElement | HTMLAnchorElement | HTMLAreaElement | HTMLAudioElement | HTMLBaseElement | HTMLQuoteElement | HTMLBodyElement | HTMLBRElement | HTMLCanvasElement | HTMLTableColElement | HTMLDataElement | HTMLDataListElement | HTMLModElement | HTMLDetailsElement | HTMLDialogElement | HTMLDListElement | HTMLEmbedElement | HTMLFieldSetElement | HTMLFormElement | HTMLHeadingElement | HTMLHRElement | HTMLHtmlElement | HTMLIFrameElement | HTMLImageElement | HTMLLegendElement | HTMLLIElement | HTMLMapElement | HTMLMetaElement | HTMLMeterElement | HTMLOListElement | HTMLOptGroupElement | HTMLOptionElement | HTMLOutputElement | HTMLParagraphElement | HTMLPreElement | HTMLProgressElement | HTMLScriptElement | HTMLSelectElement | HTMLSlotElement | HTMLSourceElement | HTMLSpanElement | HTMLStyleElement | HTMLTableElement | HTMLTableSectionElement | HTMLTableCellElement | HTMLTemplateElement | HTMLTextAreaElement | HTMLTimeElement | HTMLTitleElement | HTMLTableRowElement | HTMLTrackElement | HTMLUListElement | HTMLVideoElement | HTMLTableCaptionElement | HTMLMenuElement | HTMLPictureElement>, "id" | "onResize"> & {
     className?: string;
     collapsedSize?: number | undefined;
     collapsible?: boolean | undefined;

package/dist/components/ui/sidebar.d.ts

@@ -25,7 +25,7 @@ declare const Sidebar: React.ForwardRefExoticComponent<Omit<React.ClassAttribute
 declare const SidebarTrigger: React.ForwardRefExoticComponent<Omit<import("./button").ButtonProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
 declare const SidebarRail: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
 declare const SidebarInset: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SidebarInput: React.ForwardRefExoticComponent<Omit<Omit<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & React.RefAttributes<HTMLInputElement>, "ref"> & React.RefAttributes<HTMLInputElement>>;
+declare const SidebarInput: React.ForwardRefExoticComponent<Omit<Omit<import("./input").InputProps, "ref"> & React.RefAttributes<HTMLInputElement>, "ref"> & React.RefAttributes<HTMLInputElement>>;
 declare const SidebarHeader: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 declare const SidebarFooter: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 declare const SidebarSeparator: React.ForwardRefExoticComponent<Omit<Omit<import("@radix-ui/react-separator").SeparatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/components/ui/step-selector.d.ts

@@ -1,18 +1,20 @@
 /**
- * StepSelector - Componente de navegação para Wizards multi-etapas
+ * @deprecated Use `DialogWizard` para wizards em dialogs. O `StepSelector` será removido em versão futura.
+ * Para wizards dentro de Dialog, use o componente `DialogWizard` que implementa o padrão v2
+ * com stepper vertical lateral.
+ *
+ * StepSelector - Componente de navegação para Wizards multi-etapas (legacy)
  *
  * Combina um DropdownMenu para seleção de etapas com uma barra de Progress
- * para indicação visual do progresso. Ideal para uso em DialogFooter.
+ * para indicação visual do progresso.
  *
  * @example
  * ```tsx
- * <StepSelector
- *   currentStep={step}
- *   totalSteps={4}
- *   onStepChange={setStep}
- *   stepLabels={['Tipo', 'Dados', 'Config', 'Confirmar']}
- *   canGoToStep={(target) => target <= maxValidStep}
- * />
+ * // ✅ Novo padrão — use DialogWizard
+ * <DialogWizard steps={['Tipo', 'Dados', 'Config']} currentStep={step} ... />
+ *
+ * // ⚠️ Legacy — ainda funciona mas será removido
+ * <StepSelector currentStep={step} totalSteps={4} onStepChange={setStep} />
  * ```
  */
 export interface StepSelectorProps {

package/dist/components/ui/textarea.d.ts

@@ -1,5 +1,6 @@
 import * as React from "react";
 export interface TextareaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement> {
+    showCharCount?: boolean;
 }
 declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
 export { Textarea };

package/dist/crud/components/CrudTable.d.ts

@@ -40,8 +40,10 @@ export interface CrudTableProps<T extends BaseEntity & {
     resizeStorageKey?: string;
     enableColumnManager?: boolean;
     columnManagerStorageKey?: string;
+    /** Column keys to hide by default (before user interaction). Only used when no saved state exists. */
+    defaultHiddenColumns?: string[];
     /** Habilita agrupamento de colunas (GroupDropZone + opções de grupo no ColumnSettings). Default: false */
     enableGrouping?: boolean;
 }
-export declare const CrudTable: <T extends BaseEntity>({ manager, columns, onEdit, onView, onToggleStatus, onDelete, renderActions, customRowActions, enableBulkActions, rowActionsVariant, onNew, newButtonLabel, showNewButton, customActions, hideActionBar, showActionBar, showSearch, searchValue, onSearchChange, searchPlaceholder, bulkActions, onBulkDelete, filters, viewMode, onViewModeChange, showViewToggle, enableColumnResize, resizeStorageKey, enableColumnManager, columnManagerStorageKey, enableGrouping, }: CrudTableProps<T>) => import("react/jsx-runtime").JSX.Element;
+export declare const CrudTable: <T extends BaseEntity>({ manager, columns, onEdit, onView, onToggleStatus, onDelete, renderActions, customRowActions, enableBulkActions, rowActionsVariant, onNew, newButtonLabel, showNewButton, customActions, hideActionBar, showActionBar, showSearch, searchValue, onSearchChange, searchPlaceholder, bulkActions, onBulkDelete, filters, viewMode, onViewModeChange, showViewToggle, enableColumnResize, resizeStorageKey, enableColumnManager, columnManagerStorageKey, defaultHiddenColumns, enableGrouping, }: CrudTableProps<T>) => import("react/jsx-runtime").JSX.Element;
 export default CrudTable;

package/dist/crud/createCrudPage.d.ts

@@ -47,6 +47,8 @@ interface SimpleCrudPageConfig<T extends CrudEntity> {
     searchPlaceholder?: string;
     /** Exibir Action Bar (default: true) */
     showActionBar?: boolean;
+    /** Column keys to hide by default (before user interaction). Only used when no saved state exists. */
+    defaultHiddenColumns?: string[];
 }
 interface CrudPageGeneratorConfig<T extends CrudEntity> {
     manager: any;

package/dist/crud/hooks/useColumnManager.d.ts

@@ -8,6 +8,8 @@ export interface UseColumnManagerOptions<T> {
     columns: CrudColumn<T>[];
     storageKey?: string;
     enabled?: boolean;
+    /** Column keys to hide by default (before any user interaction). Only applied when no saved state exists. */
+    defaultHiddenColumns?: string[];
 }
 export interface UseColumnManagerReturn<T> {
     /** Columns filtered by visibility and reordered */
@@ -55,4 +57,4 @@ export interface GroupedData<T> {
     level: number;
     children?: GroupedData<T>[];
 }
-export declare function useColumnManager<T extends BaseEntity>({ columns, storageKey, enabled, }: UseColumnManagerOptions<T>): UseColumnManagerReturn<T>;
+export declare function useColumnManager<T extends BaseEntity>({ columns, storageKey, enabled, defaultHiddenColumns, }: UseColumnManagerOptions<T>): UseColumnManagerReturn<T>;

package/dist/exports/ui.d.ts

@@ -79,6 +79,7 @@ export * from '../components/ui/timepicker';
 export * from '../components/ui/electronic-signature-dialog';
 export * from '../components/ui/step-selector';
 export { StepSelector as Stepper } from '../components/ui/step-selector';
+export * from '../components/ui/dialog-wizard';
 export { ComboTree, type ComboTreeProps, type ComboTreeOption } from '../components/ui/combo-tree';
 export { ComboTree as TreeSelect } from '../components/ui/combo-tree';
 export type { ComboTreeProps as TreeSelectProps, ComboTreeOption as TreeSelectOption } from '../components/ui/combo-tree';