@actionexec/dashboards 0.18.0 → 0.19.1

package/README.md

@@ -65,8 +65,10 @@ seja identico ao do construtor da plataforma e ao PDF baixado.
 
 A folha vive num viewport com scroll nos dois eixos (a barra horizontal fica na
 borda visivel, nao no fundo da tabela) e uma faixa de periodos no topo, que marca
-a coluna mais a vista. Secoes com recuo se recolhem na tela; o PDF continua com o
-documento inteiro.
+a coluna mais a vista. Cada bloco recolhe na tela o que contem, pelo que o payload
+declara em `collapse`, e o titulo dele segue a vista com o total. O documento abre
+resumido, com os blocos que nao contem outro bloco recolhidos. O recuo sozinho nao
+cria secao. O PDF continua com o documento inteiro.
 
 **Abaixo de 600 px** (`layout="auto"` num celular, ou `layout="periods"`) a folha
 da lugar a um periodo por vez: seletor com setas de 40 px e um `<select>` nativo

package/dist/hooks/useCollapse.d.ts

@@ -1,13 +1,11 @@
 import type { StatementComputedLine } from '../types/statement';
 export interface CollapseState {
-    /** Ids das linhas que o leitor pode recolher: as que têm filhas. */
+    /** Ids das linhas que o leitor pode recolher: as que trazem um trecho. */
     collapsible: ReadonlySet<string>;
     /** Ids recolhidos agora. */
     collapsed: ReadonlySet<string>;
-    /** Ids escondidos porque algum ancestral está recolhido. */
+    /** Ids escondidos: estão no trecho de alguma linha recolhida. */
     hidden: ReadonlySet<string>;
-    /** Contas que cada seção guarda: a pista que a linha fechada mostra. */
-    accountCounts: ReadonlyMap<string, number>;
     /** Há seção para recolher? Decide se os botões da barra aparecem. */
     hasSections: boolean;
     toggle: (id: string) => void;

package/dist/hooks/useCurrentPeriod.d.ts

@@ -1,9 +1,19 @@
 import type { RefObject } from 'react';
+export interface CurrentPeriod {
+    /** Chave do período a marcar na faixa, ou null. */
+    current: string | null;
+    /**
+     * Fixa `key` como marcada. A marca só solta quando o leitor rola a folha na
+     * horizontal depois de a rolagem do clique assentar; rolar só na vertical
+     * (ler as contas) não mexe nela.
+     */
+    pin: (key: string) => void;
+}
 /**
- * Chave do período mais visível em `scrollRef`, ou null.
+ * Período a marcar em `scrollRef` (`current`) e o fixador do clique (`pin`).
  *
  * `keys` dita a ordem de desempate e, mudando, reanexa o observador: as
  * colunas são outras e os `th` também. Passe a lista memoizada; uma nova a
  * cada render religaria o observador a cada render.
  */
-export declare function useCurrentPeriod(scrollRef: RefObject<HTMLElement | null>, keys: readonly string[]): string | null;
+export declare function useCurrentPeriod(scrollRef: RefObject<HTMLElement | null>, keys: readonly string[]): CurrentPeriod;

package/dist/hooks/useStatementData.d.ts

@@ -7,6 +7,10 @@ export interface UseStatementDataResult {
     /** Filtros selecionados (formato string por id — temporais como "start|end"). */
     filters: Record<string, string>;
     setFilter(filterId: string, value: string): void;
+    /** Filtros que o leitor escolheu a mao; o default adotado do backend nao conta. */
+    touched: Record<string, boolean>;
+    /** Volta o filtro ao padrao do documento: o backend resolve o default e o estado o adota. */
+    clearFilter(filterId: string): void;
     downloadPdf(): void;
     downloading: boolean;
 }