@selectwin/kit 0.1.73 → 0.1.74

package/dist/SelectDataTable.d.ts

@@ -40,7 +40,7 @@ export interface SelectDataColumn<T> {
  * guards mirror SelectMoney — storage unavailable = in-memory only.
  */
 export declare function useSelectPageSize(key: string, fallback: number, options?: number[]): [number, (size: number) => void];
-export declare function SelectDataTable<T>({ columns, items, getId, loading, empty, pagination, onRowClick, title, help, action, filters, columnsKey, }: {
+export declare function SelectDataTable<T>({ columns, items, getId, loading, empty, pagination, onRowClick, title, help, description, action, filters, columnsKey, }: {
     columns: SelectDataColumn<T>[];
     items: T[];
     getId: (item: T) => string;
@@ -89,11 +89,14 @@ export declare function SelectDataTable<T>({ columns, items, getId, loading, emp
     title?: ReactNode;
     /** Ajuda contextual: vira o "!" ao lado do título (SelectInfoTip). Precisa de `title`. */
     help?: ReactNode;
-    /** Right-aligned header action (e.g. an "Adicionar" button). */
+    /** Linha discreta ABAIXO do título (subtítulo/descrição da lista) — ver SelectTable. */
+    description?: ReactNode;
+    /** Ação sobre o RECURSO, à direita do título (ex.: "Criar link"). Controles da VISTA
+     *  (seletor de colunas) descem sozinhos para a faixa de filtros — não os passe aqui. */
     action?: ReactNode;
-    /** Filter controls (e.g. a SelectFilterBar) embedded in the table's header bar, left of
-     *  the action/column picker — table + filters read as ONE unit, and the bar stays
-     *  reachable when a filter empties the table. */
+    /** Filter controls (e.g. a SelectFilterBar) na PRÓPRIA faixa do card, entre o título e o
+     *  cabeçalho de colunas — table + filters read as ONE unit, and the bar stays reachable
+     *  when a filter empties the table. */
     filters?: ReactNode;
     /**
      * Enables the column-visibility picker (a gear in the header bar) and persists the

package/dist/SelectTable.d.ts

@@ -19,12 +19,22 @@ type SelectTableOwnProps = {
     title?: ReactNode;
     /** Ajuda contextual: vira o "!" ao lado do título (SelectInfoTip). Precisa de `title`. */
     help?: ReactNode;
+    /** Linha discreta ABAIXO do título (subtítulo/descrição da lista). Ocupa a largura da
+     *  faixa de identidade — por isso o filtro não pode dividir essa linha com ela. Texto
+     *  que ENSINA a plataforma continua sendo `help` (o "!"); aqui vai o que descreve o
+     *  recorte desta lista. */
+    description?: ReactNode;
     /** Right-aligned action in the header bar (e.g. an "Adicionar" button). */
     action?: ReactNode;
-    /** Filter controls (e.g. a SelectFilterBar) embedded in the header bar, left of the
-     *  action — the table and its filters read as ONE unit. The bar stays visible when a
-     *  filter empties the table (clearing the filter must remain reachable). */
+    /** Filter controls (e.g. a SelectFilterBar). Ganham a PRÓPRIA faixa, entre o título e o
+     *  cabeçalho de colunas — tabela e filtros seguem lendo como UMA unidade, e a barra
+     *  continua visível quando um filtro esvazia a tabela (limpar o filtro tem de continuar
+     *  alcançável). */
     filters?: ReactNode;
+    /** Controles da VISTA (seletor de colunas, "Personalizar") — à direita da faixa de
+     *  filtros, não junto do título. Sem `filters` não existe faixa de consulta, então eles
+     *  voltam para o lado do `action` (uma faixa só para a engrenagem seria vazia). */
+    tools?: ReactNode;
 };
 export type SelectTableProps = SelectTableOwnProps & Omit<ComponentPropsWithoutRef<'div'>, keyof SelectTableOwnProps>;
 export declare const SelectTable: import('react').ForwardRefExoticComponent<SelectTableOwnProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, keyof SelectTableOwnProps> & import('react').RefAttributes<HTMLDivElement>>;