@selectwin/kit 0.1.74 → 0.1.75

package/dist/SelectCardGrid.d.ts

@@ -0,0 +1,28 @@
+import { ReactNode } from 'react';
+import { SelectListChromeProps, SelectListPagination } from './internal/listChrome';
+export declare function SelectCardGrid<T>({ items, getId, renderItem, loading, skeletonCount, empty, pagination, create, minCardWidth, title, help, description, action, filters, tools, }: {
+    items: T[];
+    getId: (item: T) => string;
+    /** O card de um item — tipicamente um SelectRecordCard. */
+    renderItem: (item: T) => ReactNode;
+    loading?: boolean;
+    /** Quantos cards-esqueleto enquanto carrega (padrão 6 — duas fileiras). */
+    skeletonCount?: number;
+    empty?: {
+        icon?: ReactNode;
+        heading: ReactNode;
+        text?: ReactNode;
+        action?: ReactNode;
+    };
+    /** Rodapé de paginação — mesma prop da SelectDataTable. */
+    pagination?: SelectListPagination;
+    /** Card tracejado no fim da grade. Substitui o botão de criar na barra do título:
+     *  numa grade de componentes, criar É um item da grade. */
+    create?: {
+        label: ReactNode;
+        description?: ReactNode;
+        onAction: () => void;
+    };
+    /** Piso da coluna da grade (`auto-fill` + `minmax`). */
+    minCardWidth?: string;
+} & SelectListChromeProps): import("react").JSX.Element;

package/dist/SelectDataTable.d.ts

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+import { SelectListPagination } from './internal/listChrome';
 /**
  * Grid-track width for a date/time column — a FIXED width that fits a full pt-BR
  * "dd/mm/aaaa, hh:mm" without clipping (the problem a bare `1fr` column had: it shared the
@@ -55,34 +56,9 @@ export declare function SelectDataTable<T>({ columns, items, getId, loading, emp
      * Footer pager. The cursor fields (hasPrevious/onPrevious/hasNext/onNext) are enough for a
      * basic centered prev/next pager. Provide `total` + `pageSize` + `page` to show the count
      * label, and additionally `onPage` (+ optional `pageCount`) to render numbered page buttons.
+     * O mesmo rodapé da SelectCardGrid (internal/listChrome) — ver SelectListPagination.
      */
-    pagination?: {
-        hasPrevious: boolean;
-        onPrevious: () => void;
-        hasNext: boolean;
-        onNext: () => void;
-        /** Total item count across all pages (drives the "de N" label). */
-        total?: number;
-        /** Items per page — with `total` + `page` yields the "X–Y de N" range label. */
-        pageSize?: number;
-        /** Current page, 1-based. */
-        page?: number;
-        /** Total pages — enables numbered buttons when paired with `onPage`. */
-        pageCount?: number;
-        /** Jump to a 1-based page (enables numbered buttons). */
-        onPage?: (page: number) => void;
-        /** Noun for the count label, e.g. "produtos" (defaults to "resultados"). */
-        noun?: string;
-        /**
-         * Page-size menu ("N por página", bottom-left of the footer) — the user picks how many
-         * rows per page. Cap the options at 50% of the backend's zod max for the endpoint
-         * (e.g. max 100 → [10, 25, 50]). Requires `onPageSizeChange`; pair the state with
-         * `useSelectPageSize` so the choice persists per table.
-         */
-        pageSizeOptions?: number[];
-        /** Apply a new page size (also reset the offset to the first page in the caller). */
-        onPageSizeChange?: (size: number) => void;
-    };
+    pagination?: SelectListPagination;
     onRowClick?: (item: T) => void;
     /** Card title in the table's own header bar — renders a self-contained titled card
      *  (don't wrap in SelectSection; the table is already a card). */

package/dist/SelectRecordCard.d.ts

@@ -0,0 +1,42 @@
+import { ReactNode, ComponentPropsWithoutRef } from 'react';
+export type SelectRecordCardTone = 'success' | 'critical' | 'warning' | 'info' | 'neutral';
+type SelectRecordCardOwnProps = {
+    /** Visual da esquerda — SelectLayoutThumb, SelectAvatar ou um ícone. */
+    media?: ReactNode;
+    title: ReactNode;
+    /** Linha de apoio sob o título (ex.: o SelectCopyableId do id — passe `reveal="always"`,
+     *  que fora de tabela não há hover de linha para revelar o botão de copiar). */
+    subtitle?: ReactNode;
+    /** Canto direito do topo — tipicamente um SelectRowActions. */
+    actions?: ReactNode;
+    /** Badges no meio do card (layout, escopo, canal…). */
+    tags?: ReactNode;
+    /** Rodapé à esquerda: bolinha + rótulo do estado. Sem `status` e sem `meta` o rodapé
+     *  não é renderizado. Estado AUSENTE é `undefined`, nunca um "provável" — o card não
+     *  inventa veredito para dado que a lista não trouxe. */
+    status?: {
+        tone?: SelectRecordCardTone;
+        label: ReactNode;
+    };
+    /** Rodapé à direita — normalmente a data de atualização. */
+    meta?: ReactNode;
+    /** Rota do card inteiro (o menu de ações segue clicável). */
+    to?: string;
+    /** Faixa de destaque no topo (ex.: o registro em vigor). */
+    accent?: boolean;
+};
+export type SelectRecordCardProps = SelectRecordCardOwnProps & Omit<ComponentPropsWithoutRef<'div'>, keyof SelectRecordCardOwnProps>;
+export declare const SelectRecordCard: import('react').ForwardRefExoticComponent<SelectRecordCardOwnProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, keyof SelectRecordCardOwnProps> & import('react').RefAttributes<HTMLDivElement>>;
+/**
+ * SelectLayoutThumb — o mini-wireframe que abre o card de um template de checkout:
+ * `steps` desenha etapas empilhadas (multi-step), `columns` desenha as colunas de uma
+ * página só (one-step). É o glifo que faz o card ler como COMPONENTE — sem ele o card é
+ * uma linha de tabela com bordas.
+ */
+export type SelectLayoutThumbProps = {
+    kind: 'steps' | 'columns';
+} & Omit<ComponentPropsWithoutRef<'span'>, 'children'>;
+export declare const SelectLayoutThumb: import('react').ForwardRefExoticComponent<{
+    kind: "steps" | "columns";
+} & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref">, "children"> & import('react').RefAttributes<HTMLSpanElement>>;
+export {};

package/dist/index.d.ts

@@ -79,6 +79,8 @@ export { SelectConfirmModal } from './SelectConfirmModal';
 export { SelectFormModal } from './SelectFormModal';
 export { detectSelectTheme } from './detectSelectTheme';
 export { SelectDataTable, SELECT_COL_DATETIME, useSelectPageSize } from './SelectDataTable';
+export { SelectCardGrid } from './SelectCardGrid';
+export { SelectRecordCard, SelectLayoutThumb } from './SelectRecordCard';
 export { SelectPagination } from './SelectPagination';
 export { SelectFilterBar } from './SelectFilterBar';
 export { SelectTagSelect } from './SelectTagSelect';
@@ -207,6 +209,8 @@ export type { SelectRowAction } from './SelectRowActions';
 export type { SelectStatusMeta } from './SelectStatusBadge';
 export type { SelectTimelineItem, SelectTimelineTone } from './SelectTimeline';
 export type { SelectDataColumn } from './SelectDataTable';
+export type { SelectRecordCardProps, SelectRecordCardTone, SelectLayoutThumbProps } from './SelectRecordCard';
+export type { SelectListPagination } from './internal/listChrome';
 export type { SelectPaginationProps } from './SelectPagination';
 export type { SelectFilterDef } from './SelectFilterBar';
 export type { SelectTagOption } from './SelectTagSelect';