@selectwin/kit 0.1.74 → 0.1.75

package/dist/internal/listChrome.d.ts

@@ -0,0 +1,60 @@
+import { ReactNode } from 'react';
+export interface SelectListChromeProps {
+    /** Faixa 1, à esquerda: o nome da lista. */
+    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). */
+    description?: ReactNode;
+    /** Faixa 1, à direita: ação sobre o RECURSO (Criar, Exportar). */
+    action?: ReactNode;
+    /** Faixa 2, à esquerda: os filtros (SelectFilterBar). */
+    filters?: ReactNode;
+    /** Faixa 2, à direita: controles da VISTA (colunas, "Personalizar"). Sem `filters` não
+     *  existe faixa 2 e eles voltam para o lado do `action`. */
+    tools?: ReactNode;
+}
+/** Quais faixas existem — de que a casca precisa para decidir bordas e colapso. */
+export declare function listChromeShape({ title, description, action, filters, tools }: SelectListChromeProps): {
+    hasFilters: boolean;
+    inlineTools: ReactNode;
+    hasIdentity: boolean;
+    hasTitleRow: boolean;
+};
+/** As faixas 1 e 2 — a faixa 3 (o conteúdo) é de quem chama. */
+export declare function SelectListChrome({ title, help, description, action, filters, tools }: SelectListChromeProps): import("react").JSX.Element;
+/**
+ * Rodapé da lista. Os campos de cursor (hasPrevious/onPrevious/hasNext/onNext) já dão o
+ * prev/next centrado; `total` + `pageSize` + `page` acrescentam o rótulo de contagem, e
+ * `onPage` (+ `pageCount`) os botões numerados.
+ */
+export interface SelectListPagination {
+    hasPrevious: boolean;
+    onPrevious: () => void;
+    hasNext: boolean;
+    onNext: () => void;
+    /** Total de itens em todas as páginas (alimenta o "de N"). */
+    total?: number;
+    /** Itens por página — com `total` + `page` rende o rótulo "X–Y de N". */
+    pageSize?: number;
+    /** Página atual, base 1. */
+    page?: number;
+    /** Total de páginas — com `onPage`, liga os botões numerados. */
+    pageCount?: number;
+    /** Pula para a página (base 1). */
+    onPage?: (page: number) => void;
+    /** Substantivo do rótulo, ex.: "produtos" (padrão: "resultados"). */
+    noun?: string;
+    /**
+     * Menu de tamanho de página ("N por página", canto inferior esquerdo) — o usuário
+     * escolhe quantos itens vê. Limite as opções a 50% do max do zod do endpoint (max 100
+     * → [10, 25, 50]). Exige `onPageSizeChange`; guarde o estado com `useSelectPageSize`
+     * para a escolha persistir por lista.
+     */
+    pageSizeOptions?: number[];
+    /** Aplica o novo tamanho (zere o offset no chamador). */
+    onPageSizeChange?: (size: number) => void;
+}
+export declare function SelectListFooter({ pagination }: {
+    pagination: SelectListPagination;
+}): import("react").JSX.Element;