@proef/common-ui 2.2.6 → 2.3.0

package/dist/types/legacy/components/molecules/DataTable/DataTable.d.ts

@@ -162,6 +162,9 @@ export interface DataTableLabels {
     total: string;
     /** Nome acessível da zona com scroll horizontal (só com `scrollAffordance`). */
     scrollRegion?: string;
+    /** Botões do popup de filtro: a escolha da lista só filtra ao confirmar (default 'Cancel'/'Confirm'). */
+    cancel?: string;
+    confirm?: string;
 }
 interface DataTableProps<T> {
     columns: DataTableColumn<T>[];

package/dist/types/legacy/components/organisms/GanttChart/GanttChart.d.ts

@@ -26,6 +26,14 @@ export interface GanttLegendItem {
     kind?: 'block' | 'marker';
 }
 /** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export interface GanttClickInfo {
+    row: GanttRow;
+    /** Dia clicado (ISO yyyy-mm-dd) — só nos losangos. */
+    day?: string;
+    /** Linha-pai quando `row` é uma linha-filho. */
+    parent?: GanttRow;
+}
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface GanttChartProps {
     rows: GanttRow[];
     /** Início e fim do eixo (ISO). */
@@ -48,13 +56,19 @@ export interface GanttChartProps {
         count?: number;
         parent?: GanttRow;
     }) => React.ReactNode;
+    /** Clique num losango (marker). Torna-o clicável. */
+    onMarkerClick?: (info: GanttClickInfo & {
+        day: string;
+    }) => void;
+    /** Clique no rótulo de uma linha-filho (as linhas-pai continuam a expandir/recolher). */
+    onRowClick?: (info: GanttClickInfo) => void;
     /** Nomes dos meses (i18n). Default PT. */
     monthNames?: string[];
     emptyText?: string;
     className?: string;
 }
 /** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
-export default function GanttChart({ rows, start, end, dayWidth, labelWidth, labelHeader, legend, expanded: expandedProp, onExpandedChange, renderTooltip, monthNames, emptyText, className, }: GanttChartProps): React.JSX.Element;
+export default function GanttChart({ rows, start, end, dayWidth, labelWidth, labelHeader, legend, expanded: expandedProp, onExpandedChange, renderTooltip, onMarkerClick, onRowClick, monthNames, emptyText, className, }: GanttChartProps): React.JSX.Element;
 /**
  * Utilitário: ISO de um dia do eixo (para quem precisa de formatar tooltips).
  * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.

package/dist/types/legacy/exports/organisms.d.ts

@@ -2,7 +2,7 @@ export { default as Profile } from '../components/organisms/Profile/Profile';
 export { LazyLoader } from '../components/organisms/LazyLoader/LazyLoader';
 export { Selector } from '../components/organisms/Selector/Selector';
 export { default as GanttChart, ganttDiaIso } from '../components/organisms/GanttChart/GanttChart';
-export type { GanttRow, GanttLegendItem, GanttChartProps } from '../components/organisms/GanttChart/GanttChart';
+export type { GanttRow, GanttLegendItem, GanttChartProps, GanttClickInfo } from '../components/organisms/GanttChart/GanttChart';
 export { default as StatusMatrix } from '../components/organisms/StatusMatrix/StatusMatrix';
 export type { StatusMatrixProps, StatusMatrixRow, StatusMatrixColumn, StatusMatrixStatus, StatusMatrixCell } from '../components/organisms/StatusMatrix/StatusMatrix';
 export { default as MapaPontos } from '../components/organisms/MapaPontos/MapaPontos';

package/dist/types/v1/components/data/Charts/Charts.d.ts

@@ -0,0 +1,103 @@
+import React from 'react';
+/** Uma série: nome (legenda e tooltip), um valor por etiqueta e, opcionalmente, a cor. */
+export interface ChartSeries {
+    name: string;
+    values: number[];
+    color?: string;
+}
+/** Clique num elemento: a etiqueta (ex: "Incidente"), a posição e a série (quando há várias). */
+export type ChartClick = (label: string, index: number, series?: string) => void;
+interface ChartBaseProps {
+    /** Altura em px. */
+    height?: number;
+    /** A carregar: mostra um bloco a pulsar com a altura do gráfico (a página não salta). */
+    loading?: boolean;
+    /** Texto quando não há dados ou é tudo zero. */
+    emptyLabel?: string;
+    /** Descrição para leitores de ecrã (ex: "Tickets por estado"). */
+    ariaLabel?: string;
+    /** Clique num elemento — tipicamente filtra a página. */
+    onClick?: ChartClick;
+    /**
+     * Etiqueta selecionada (ex: o filtro ativo): as outras ficam esbatidas. Com `onClick`,
+     * mostra o que o clique filtrou sem precisar de outra legenda.
+     */
+    activeLabel?: string | null;
+    className?: string;
+}
+/**
+ * A paleta dos gráficos no tema atual (lida dos tokens `--color-chart-N`). Para legendas
+ * ou indicadores fora do gráfico com as mesmas cores das séries.
+ */
+export declare function useChartPalette(): string[];
+/** 'YYYY-Sxx' / 'YYYY-MM' / 'YYYY-MM-DD' → etiqueta curta no eixo; o resto fica igual. */
+export declare function shortDateLabel(b: string): string;
+export interface BarChartProps extends ChartBaseProps {
+    labels: string[];
+    /** Uma ou várias séries (ex: "Atribuídos" e "Resolvidos"), lado a lado ou empilhadas. */
+    series: ChartSeries[];
+    /** Barras deitadas, com as etiquetas à esquerda (bom para nomes compridos e rankings). */
+    horizontal?: boolean;
+    /** Séries empilhadas em vez de lado a lado. */
+    stacked?: boolean;
+    /** Só as primeiras N (ex: top 10). */
+    limit?: number;
+    /** Cor de cada barra, quando há uma só série (ex: a cor de cada estado). */
+    colors?: string[];
+    /** Formato dos valores no tooltip, nas etiquetas e no eixo (ex: minutos → "7h30"). */
+    format?: (v: number) => string;
+    /** Valor na ponta de cada barra (não nas empilhadas). */
+    showValues?: boolean;
+    /** Junta a percentagem do total ao valor (ex: "12 (34%)"); só com uma série. */
+    showPercent?: boolean;
+    /** Legenda das séries. Por omissão, só quando há mais do que uma. */
+    legend?: boolean;
+    /** Formato das etiquetas do eixo. Por omissão, datas ISO ficam curtas (`shortDateLabel`). */
+    formatLabel?: (label: string) => string;
+}
+/**
+ * Barras verticais ou deitadas, de uma ou várias séries, lado a lado ou empilhadas.
+ *
+ * Clique numa barra com `onClick`; com `activeLabel`, as outras ficam esbatidas (o filtro
+ * aplicado lê-se no próprio gráfico). Sem dados, mostra `emptyLabel`; a carregar, um bloco.
+ */
+export declare function BarChart({ labels: allLabels, series: allSeries, horizontal, stacked, height, limit, colors, format, showValues, showPercent, legend, formatLabel, onClick, activeLabel, loading, emptyLabel, ariaLabel, className, }: BarChartProps): React.JSX.Element;
+export interface DonutChartProps extends ChartBaseProps {
+    labels: string[];
+    values: number[];
+    /** Cor de cada fatia (ex: a cor de cada estado). Por omissão, a paleta. */
+    colors?: string[];
+    /** Formato dos valores no tooltip e nas fatias. */
+    format?: (v: number) => string;
+    /**
+     * Texto no centro do anel. `true` mostra o total (com `format`); um texto mostra esse
+     * texto (ex: "128 tickets").
+     */
+    centerLabel?: boolean | string;
+}
+/**
+ * Anel de uma distribuição (ex: tickets por estado). Percentagem no tooltip, valor nas
+ * fatias com espaço para ele e, com `centerLabel`, o total no meio.
+ */
+export declare function DonutChart({ labels, values, height, colors, format, centerLabel, onClick, activeLabel, loading, emptyLabel, ariaLabel, className, }: DonutChartProps): React.JSX.Element;
+export interface LineChartProps extends ChartBaseProps {
+    labels: string[];
+    /**
+     * Uma ou várias linhas sobre as mesmas etiquetas — NÃO empilhadas: duas séries que medem
+     * o mesmo em dois momentos (criados vs fechados) leem-se uma contra a outra.
+     */
+    series: ChartSeries[];
+    /** Área por baixo de cada linha. Só se lê bem com uma ou duas séries. */
+    area?: boolean;
+    /** Cor de cada série, pela ordem (ou `color` na série). */
+    colors?: string[];
+    /** Formato dos valores no tooltip e no eixo. */
+    format?: (v: number) => string;
+    /** Formato das etiquetas do eixo. Por omissão, datas ISO ficam curtas. */
+    formatLabel?: (label: string) => string;
+    /** Legenda das séries. Por omissão, só quando há mais do que uma. */
+    legend?: boolean;
+}
+/** Linhas sobre o tempo (ou outra sequência), com o tooltip de todas as séries no mesmo ponto. */
+export declare function LineChart({ labels, series, height, area, colors, format, formatLabel, legend, onClick, loading, emptyLabel, ariaLabel, className, }: LineChartProps): React.JSX.Element;
+export {};

package/dist/types/v1/index.d.ts

@@ -70,6 +70,8 @@ export { Pagination } from './components/data/Pagination/Pagination';
 export type { PaginationProps, PaginationLabels } from './components/data/Pagination/Pagination';
 export { FilterChips } from './primitives/display/FilterChips/FilterChips';
 export type { FilterChipsProps, FilterChipItem } from './primitives/display/FilterChips/FilterChips';
+export { BarChart, DonutChart, LineChart, useChartPalette, shortDateLabel } from './components/data/Charts/Charts';
+export type { BarChartProps, DonutChartProps, LineChartProps, ChartSeries, ChartClick } from './components/data/Charts/Charts';
 export { Card } from './primitives/display/Card/Card';
 export type { CardProps } from './primitives/display/Card/Card';
 export { Kpi } from './primitives/display/Kpi/Kpi';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proef/common-ui",
-  "version": "2.2.6",
+  "version": "2.3.0",
   "description": "",
   "main": "dist/esm/index.js",
   "module": "dist/esm/index.js",