@wgalleti/primevue-components 1.7.2 → 1.9.0

package/dist/types/editableTable.d.ts

@@ -6,8 +6,8 @@ export type EditableRow = Record<string, unknown>;
  *  `date` edita com o `WDatePicker` (digitação com máscara, calendário, F2 = hoje)
  *  e guarda `YYYY-MM-DD` na linha — o mesmo formato que a API recebe. */
 export type EditableColumnEditor = 'number' | 'text' | 'select' | 'date' | 'none';
-/** Papel da coluna quando a tabela vira card (tablet em pé). Ver `EditableColumnDef.card`. */
-export type EditableCardRole = 'title' | 'actions' | 'meta' | 'field' | 'read' | 'hidden';
+/** Papel da coluna quando a tabela vira card (componente com menos de 840px). Ver `EditableColumnDef.card`. */
+export type EditableCardRole = 'title' | 'actions' | 'meta' | 'value' | 'field' | 'read' | 'hidden';
 /**
  * Coluna do WEditableTable. Diferente do `ColumnDef` (que descreve uma coluna de
  * listagem vinda da API), aqui a coluna também descreve COMO se edita a célula e
@@ -16,7 +16,8 @@ export type EditableCardRole = 'title' | 'actions' | 'meta' | 'field' | 'read' |
 export interface EditableColumnDef {
     field: string;
     header: string;
-    /** Largura fixa da coluna (`'120px'`, `120` → px, `'12rem'`). Sem isso a coluna é fluida. */
+    /** Largura fixa da coluna (`'120px'`, `120` → px, `'12rem'`). Sem isso a coluna é fluida,
+     *  com piso de `--w-col-title-min`: abaixo da soma, a grade rola na horizontal. */
     width?: string | number;
     /** Alinhamento do conteúdo. Default: `right` para `editor: 'number'`, senão `left`. */
     align?: 'left' | 'center' | 'right';
@@ -48,7 +49,8 @@ export interface EditableColumnDef {
      *  Colunas sem grupo ficam com a célula de cima vazia. */
     group?: string;
     /**
-     * Papel da coluna no **modo card** (tablet em pé, `< 840px`).
+     * Papel da coluna no **modo card** (o próprio componente com menos de 840px de
+     * largura — não a janela).
      *
      * Sem declarar nada a tabela já vira card: a primeira coluna é o `title` e as
      * demais viram `field`. Declare para dar hierarquia ao card — o que se lê de
@@ -57,14 +59,34 @@ export interface EditableColumnDef {
      * - `title` — a manchete do card (uma por linha; sobrando, a primeira vence)
      * - `actions` — ações da linha, ao lado do título
      * - `meta` — contexto compacto sob o título, duas por linha (talhão, saldo)
+     * - `value` — o número principal do card (saldo, total da linha): largura
+     *   cheia, logo abaixo do contexto, rótulo pequeno em cima e o número grande,
+     *   em negrito. Pode receber um campo pelo slot `#cell-*` (ex.: `InputNumber`):
+     *   ele ocupa o lugar da manchete, largura cheia e no tamanho dela. O total do
+     *   rodapé de uma coluna `value` também sai como manchete
      * - `field` — rótulo à esquerda e o controle à direita, largura cheia
-     * - `read` — derivado: mesma régua do `field` (rótulo, caixa e número na mesma
-     *   coluna), com a caixa tinta e sem borda — borda é o que se edita
+     * - `read` — derivado: mesma régua do `field` (rótulo e número na mesma coluna),
+     *   mas como TEXTO, sem caixa nem borda — borda é o que se edita; o que só se
+     *   lê é texto
      * - `hidden` — fora do card (a coluna continua na tabela larga)
      *
      * `field` e `read` aparecem na ORDEM DAS COLUNAS, intercalados — o miolo do card
      * lê na mesma sequência da tabela. Posição fixa só para `title`, `actions`, `meta`
-     * (contexto, logo abaixo do título) e a expansão, que fecha o card.
+     * (contexto, logo abaixo do título), `value` (logo abaixo do contexto) e a
+     * expansão, que fecha o card.
+     *
+     * **Papel por linha**: passe uma função `(row) => papel` quando a mesma coluna
+     * muda de natureza conforme a linha — ex.: o valor é `InputNumber` na linha em
+     * modo manual (`'field'`) e número calculado nas demais (`'value'`). É chamada
+     * por linha × coluna no render: mantenha-a pura e barata (só ler a linha).
+     * Use a função para `meta`, `value`, `field`, `read` (e `hidden`). `title` e
+     * `actions` são da TABELA, não da linha: declare-os fixos. O título é decidido
+     * uma vez (o primeiro `card: 'title'` fixo, senão a primeira coluna); qualquer
+     * outra coluna que resolva `'title'` — fixa duplicada ou função — cai em `field`.
+     *
+     * **Rodapé**: o total não tem linha, então segue a coluna — `value` fixo sai como
+     * manchete; com função, sai como manchete se ALGUMA linha resolve `value` (a parte
+     * nunca fica maior que o todo); senão, compacto (`read`).
      */
-    card?: EditableCardRole;
+    card?: EditableCardRole | ((row: EditableRow) => EditableCardRole);
 }

package/dist/types/groupedSelectList.d.ts

@@ -0,0 +1,15 @@
+/** Chave de uma linha do WGroupedSelectList (o valor de `dataKey`). */
+export type GroupedSelectKey = string | number;
+/** Escopo dos slots `group-header` e `group-meta` do WGroupedSelectList. */
+export interface GroupedSelectGroupScope {
+    groupKey: string;
+    /** Rótulo do grupo (`groupLabel` ou a própria chave). */
+    label: string;
+    /** Todas as linhas do grupo, na ordem de `items`. */
+    items: Record<string, unknown>[];
+    /** Linhas do grupo que estão em `selection`. */
+    selectedCount: number;
+    /** Linhas do grupo que podem ser selecionadas. */
+    selectableCount: number;
+    collapsed: boolean;
+}

package/dist/types/index.d.ts

@@ -4,6 +4,7 @@ export type { FieldDef, FieldType, FieldValidateContext, FkCrudConfig, SelectOpt
 export type { EditableCardRole, EditableColumnDef, EditableColumnEditor, EditableRow, } from './editableTable';
 export type { CheckListItem, CheckListLevel } from './checkList';
 export type { AttentionItem, AttentionItemClickEvent, AttentionSeverity } from './attentionList';
+export type { GroupedSelectGroupScope, GroupedSelectKey } from './groupedSelectList';
 export type { KanbanColumn, KanbanMoveEvent } from './kanban';
 export type { MarkdownHeading, MarkdownRenderResult } from './markdown';
 export type { TabItem } from './tabs';

package/dist/types/kpi.d.ts

@@ -21,6 +21,8 @@ export interface KpiItem {
     size?: 'default' | 'compact';
     /** O card é o filtro aplicado à lista (borda na cor do tom, `aria-pressed`). */
     active?: boolean;
+    /** O tom da severidade pinta só o ícone (`icon`, padrão) ou também o valor (`value`). */
+    tint?: 'icon' | 'value';
     /**
      * `false` deixa o card estático mesmo com listener de `item-click` no WKpiGrid — para o
      * número que só informa numa grade em que os outros cards são filtros.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wgalleti/primevue-components",
-  "version": "1.7.2",
+  "version": "1.9.0",
   "type": "module",
   "license": "MIT",
   "publishConfig": {