@nextelco/common-ui 2.1.105 → 2.1.107

package/dist/tokens.css

@@ -0,0 +1,119 @@
+/* Tokens do V1: tamanhos, tipos de letra, sombras e cores partilhados pelos
+ * componentes. Mudar um valor aqui muda-o em todos os componentes que o usam.
+ *
+ * Cada token gera as classes do Tailwind com o seu nome (ex: --spacing-control
+ * → h-control, w-control; --text-control → text-control; --shadow-card →
+ * shadow-card). Uma app pode sobrepor qualquer um no seu próprio CSS
+ * (ex: `:root { --spacing-control: 38px }`).
+ *
+ * `static`: os tokens vão sempre para o CSS, mesmo os que só são usados
+ * dentro de outros valores (ex: a largura das etiquetas no FormGrid).
+ * Importado por tailwind.css e tailwind.layered.css. */
+@theme static {
+  /* Cores */
+  --color-primary-strong: #00124a; /* navy mais escuro, para gradientes */
+  --color-scrollbar: #c1c1c1;
+  --color-scrollbar-hover: #a8a8a8;
+
+  /* Tipos de letra */
+  --text-page-title: 24px; /* título da página (PageHeader) — o mesmo em todos os portais e ecrãs */
+  --text-page-title--line-height: 2rem;
+  --text-title: 15px; /* títulos de caixas e janelas */
+  --text-control: 13px; /* texto dos campos e botões */
+  --text-caption: 11px; /* contadores, avisos, tamanhos de ficheiro */
+  --text-micro: 10px; /* dicas por baixo das etiquetas */
+
+  /* Tamanhos */
+  --spacing-control: 32px; /* altura de todos os controlos: botões, campos, pesquisa, seletores (iguais lado a lado) */
+  --spacing-form-label: 172px; /* coluna das etiquetas no FormGrid */
+  --spacing-form-label-narrow: 112px; /* a mesma coluna, em sítios estreitos */
+  --spacing-page-x: 48px; /* margem lateral da página (AppShell), a partir de 640px */
+  --spacing-page-x-narrow: 16px; /* a mesma margem em ecrãs estreitos */
+  --spacing-page-top: 32px; /* espaço por cima da página (AppShell), a partir de 1024px */
+  --spacing-page-top-narrow: 80px; /* o mesmo espaço abaixo de 1024px, com lugar para o botão do menu */
+
+  /* Larguras a partir das quais o FormGrid muda (container queries: @max-form-md, @max-form-sm) */
+  --container-form-md: 680px; /* etiquetas mais estreitas */
+  --container-form-sm: 500px; /* etiquetas por cima dos campos */
+
+  /* Larguras máximas das janelas (Dialog): max-w-dialog-sm, -md, -lg */
+  --container-dialog-sm: 480px;
+  --container-dialog-md: 720px;
+  --container-dialog-lg: 1000px;
+  /* Espaço mínimo entre a janela e as bordas do ecrã */
+  --spacing-dialog-margin: 24px;
+
+  /* Animações de entrada das janelas */
+  --animate-dialog-in: dialog-in 0.2s cubic-bezier(0.2, 0.9, 0.3, 1.1) both;
+  --animate-backdrop-in: backdrop-in 0.2s ease-out both;
+
+  @keyframes dialog-in {
+    from { opacity: 0; transform: translateY(10px) scale(0.97); }
+  }
+  @keyframes backdrop-in {
+    from { opacity: 0; }
+  }
+
+  /* Sombras (na cor primária, para seguirem a paleta) */
+  --shadow-card: 0 10px 30px color-mix(in srgb, var(--color-primary) 8%, transparent);
+  --shadow-card-hover: 0 14px 36px color-mix(in srgb, var(--color-primary) 12%, transparent);
+  --shadow-card-active: 0 16px 40px color-mix(in srgb, var(--color-primary) 16%, transparent);
+  --shadow-popover: 0 6px 18px color-mix(in srgb, var(--color-primary) 12%, transparent);
+  --shadow-tile: 0 10px 24px color-mix(in srgb, var(--color-primary) 18%, transparent);
+  --shadow-page: 0 1px 5px color-mix(in srgb, var(--color-primary) 10%, transparent);
+  --shadow-modal: 0 24px 60px color-mix(in srgb, var(--color-primary) 25%, transparent);
+}
+
+/* Fundo do corpo das janelas: um brilho navy que desce do cabeçalho e
+   desvanece para a cor do cartão (branco no tema claro, escuro no tema
+   escuro). Na cor primária, para seguir a paleta. */
+@utility bg-canvas {
+  background-image:
+    radial-gradient(125% 70% at 50% -12%, color-mix(in srgb, var(--color-primary) 7%, transparent) 0%, transparent 55%),
+    linear-gradient(180deg, color-mix(in srgb, var(--color-primary) 5%, var(--color-card)) 0%, color-mix(in srgb, var(--color-primary) 2%, var(--color-card)) 55%, var(--color-card) 100%);
+}
+
+/* Esconde a barra de scroll do browser, mantendo o scroll (ex: quando há uma
+   barra desenhada por cima, como nas tabelas com `overlayScrollbars`). */
+@utility scrollbar-none {
+  scrollbar-width: none;
+  &::-webkit-scrollbar {
+    display: none;
+  }
+}
+
+/* Sem o aspeto do browser dentro de `v1-reset` (ex: a Table): botões sem fundo,
+   borda nem margens, e com a letra de quem os rodeia; tabelas sem espaço entre
+   células. A biblioteca não traz o preflight do Tailwind, para não mexer nas
+   páginas da app; isto só toca no que está dentro da classe.
+   Em `@layer base` e com especificidade zero (`:where`): qualquer classe do
+   componente ganha-lhe. */
+@layer base {
+  :where(.v1-reset) :where(button) {
+    appearance: none;
+    background: none;
+    border: 0;
+    padding: 0;
+    margin: 0;
+    font: inherit;
+    color: inherit;
+    letter-spacing: inherit;
+    text-transform: inherit;
+    cursor: pointer;
+  }
+  :where(.v1-reset) :where(button:disabled) {
+    cursor: default;
+  }
+  :where(.v1-reset) :where(input, select) {
+    font: inherit;
+    color: inherit;
+    margin: 0;
+  }
+  :where(.v1-reset) :where(table) {
+    border-collapse: collapse;
+  }
+  :where(.v1-reset) :where(th) {
+    font-weight: inherit;
+    text-align: inherit;
+  }
+}

package/dist/types/legacy/components/atoms/InputData/InputData.d.ts

@@ -23,7 +23,10 @@ export interface InputDataProps extends PropsBase {
     min?: string;
     max?: string;
 }
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+/**
+ * Migrado para o V1: adaptador do `DateInput` (dd/mm/aaaa sempre, calendário pelo ícone).
+ * @deprecated Legacy — usar o `DateInput` do V1. Ver Storybook › Legacy.
+ */
 export declare function InputData({ value, onChange, disabled, id, min, max }: InputDataProps): React.JSX.Element;
 /** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface InputHoraProps extends PropsBase {

package/dist/types/legacy/components/charts/Charts.d.ts

@@ -18,6 +18,11 @@ export interface Distribuicao {
     labels: string[];
     valores: number[];
 }
+/**
+ * Clique num elemento do gráfico: a etiqueta (ex: "Incidente"), a posição dela
+ * e o nome da série (quando há várias). Serve para filtrar ao clicar.
+ */
+export type CliqueGrafico = (label: string, indice: number, serie?: string) => void;
 /**
  * Categorical palette. Stable order so the same dimension always maps to the same color.
  * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
@@ -25,37 +30,77 @@ export interface Distribuicao {
 export declare const PALETA: string[];
 /** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare function cor(i: number): string;
+export interface BarrasProps {
+    labels: string[];
+    /** Uma ou várias séries (ex: "Atribuídos" e "Resolvidos"), lado a lado ou empilhadas. */
+    series: {
+        nome: string;
+        valores: number[];
+        cor?: string;
+    }[];
+    /** Barras deitadas, com as etiquetas à esquerda (bom para nomes compridos e rankings). */
+    horizontal?: boolean;
+    /** Séries empilhadas em vez de lado a lado. */
+    empilhado?: boolean;
+    /** Altura em px. Nas horizontais, por omissão cresce com o número de barras. */
+    altura?: number;
+    /** Só as primeiras N (ex: top 10). */
+    limite?: number;
+    /** Cor de cada barra, quando há uma só série (ex: a cor de cada estado). */
+    cores?: string[];
+    /** Formato dos valores no tooltip, nas etiquetas e no eixo (ex: minutos → "7h30"). */
+    formatar?: (v: number) => string;
+    /** Mostra o valor na ponta de cada barra. */
+    valores?: boolean;
+    /** Junta a percentagem do total ao valor (ex: "12 (34%)"); só com uma série. */
+    percentagem?: boolean;
+    /** Legenda das séries. Por omissão, só quando há mais do que uma. */
+    legenda?: boolean;
+    /** Formato das etiquetas do eixo (ex: datas). Por omissão, datas ISO ficam curtas. */
+    formatarEtiqueta?: (label: string) => string;
+    /** Clique numa barra: devolve a etiqueta, a posição e a série. */
+    onClick?: CliqueGrafico;
+}
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export declare function Barras({ labels: todas, series: todasSeries, horizontal, empilhado, altura, limite, cores, formatar, valores, percentagem, legenda, formatarEtiqueta, onClick, }: BarrasProps): React.JSX.Element;
 /**
  * Stacked bars for a dimension over time.
  * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
-export declare function BarrasEmpilhadas({ serie, altura }: {
+export declare function BarrasEmpilhadas({ serie, altura, onClick }: {
     serie: SerieEmpilhada;
     altura?: number;
+    onClick?: CliqueGrafico;
 }): React.JSX.Element;
 /**
  * Horizontal bars of a distribution (top N).
  * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
-export declare function BarrasHorizontais({ dados, altura, limite }: {
+export declare function BarrasHorizontais({ dados, altura, limite, onClick, }: {
     dados: Distribuicao;
     altura?: number;
     limite?: number;
+    onClick?: CliqueGrafico;
 }): React.JSX.Element;
 /** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
-export declare function Anel({ dados, altura, cores }: {
+export declare function Anel({ dados, altura, cores, formatar, onClick, }: {
     dados: Distribuicao;
     altura?: number;
     cores?: string[];
+    /** Formato dos valores no tooltip. */
+    formatar?: (v: number) => string;
+    /** Clique numa fatia: devolve a etiqueta e a posição. */
+    onClick?: CliqueGrafico;
 }): React.JSX.Element;
 /**
  * Simple line chart — optionally formats values as currency.
  * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
-export declare function Linha({ dados, altura, euros: emEuros }: {
+export declare function Linha({ dados, altura, euros: emEuros, onClick, }: {
     dados: Distribuicao;
     altura?: number;
     euros?: boolean;
+    onClick?: CliqueGrafico;
 }): React.JSX.Element;
 /**
  * Several lines over the same labels — NOT stacked.
@@ -65,10 +110,18 @@ export declare function Linha({ dados, altura, euros: emEuros }: {
  * stacking them would draw their sum, which means nothing.
  * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
-export declare function Linhas({ serie, altura, area, }: {
+export declare function Linhas({ serie, altura, area, cores, formatar, formatarEtiqueta, onClick, }: {
     serie: SerieEmpilhada;
     altura?: number;
     area?: boolean;
+    /** Cor de cada série, pela ordem. */
+    cores?: string[];
+    /** Formato dos valores no tooltip e no eixo. */
+    formatar?: (v: number) => string;
+    /** Formato das etiquetas do eixo (ex: datas). */
+    formatarEtiqueta?: (label: string) => string;
+    /** Clique num ponto: devolve a etiqueta (ex: o dia) e a série. */
+    onClick?: CliqueGrafico;
 }): React.JSX.Element;
 /** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface PontoRisco {

package/dist/types/legacy/components/layout/Layout/Layout.d.ts

@@ -1,13 +1,12 @@
 import React from 'react';
-import { SidebarMenuItem, SidebarLanguage, SidebarTheme } from '../Sidebar/Sidebar';
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+import { type SidebarMenuItem, type SidebarLanguage, type SidebarTheme } from '../Sidebar/Sidebar';
+/** @deprecated Legacy — usar `AppShellProps` do V1. */
 export interface LayoutProps {
     children: React.ReactNode;
     menus: SidebarMenuItem[];
     groupLabels?: Record<string, string>;
     appTitle?: string;
-    /** Barra superior opcional (título/alertas). Fica sticky acima do conteúdo,
-     * alinhada à direita da sidebar. Traz o seu próprio fundo/padding. */
+    /** Barra superior opcional (título/alertas), sticky acima do conteúdo. */
     topBar?: React.ReactNode;
     avatar?: React.ReactNode;
     onLogout?: () => void;
@@ -23,26 +22,14 @@ export interface LayoutProps {
         dark?: string;
         system?: string;
     };
-    /** Slot extra no rodapé da sidebar (ex: filtro global). Ver Sidebar.footer. */
     footer?: (isExpanded: boolean) => React.ReactNode;
-    /** Quando este build foi feito, por baixo do logout. Ver Sidebar.deployedAt. */
     deployedAt?: string | number | Date;
     deployedAtLabel?: string;
-    /**
-     * Estado inicial da sidebar (aberta/fechada). Sem isto mantém-se o comportamento de
-     * sempre: aberta no desktop, fechada em mobile. Passar isto serve para a app repor o
-     * que a pessoa tinha antes de recarregar a página (ex.: lido do seu próprio
-     * localStorage) — o Layout não persiste nada sozinho, tal como já acontece com `theme`.
-     */
+    /** Estado inicial da sidebar (aberta/fechada). */
     sidebarOpen?: boolean;
-    /**
-     * Chamado sempre que a sidebar abre/fecha por uma ação da pessoa (o atalho da própria
-     * Sidebar, ou o botão de expandir em mobile) — nunca pelo ajuste automático ao
-     * redimensionar a janela, que não é uma escolha dela. Mesmo padrão de
-     * `onThemeChange`: o Layout só avisa, quem usa decide se e como guardar.
-     */
+    /** Chamado quando a pessoa abre/fecha a sidebar. */
     onSidebarOpenChange?: (open: boolean) => void;
 }
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
-declare const Layout: ({ children, menus, groupLabels, appTitle, topBar, avatar, onLogout, logoutLabel, languages, currentLang, onLanguageChange, theme, onThemeChange, themeLabels, footer, deployedAt, deployedAtLabel, sidebarOpen: sidebarOpenProp, onSidebarOpenChange, }: LayoutProps) => React.JSX.Element;
+/** @deprecated Legacy — usar `AppShell` do V1. */
+declare const Layout: ({ children, menus, currentLang, logoutLabel, themeLabels, deployedAtLabel, footer, sidebarOpen, onSidebarOpenChange, ...rest }: LayoutProps) => React.JSX.Element;
 export default Layout;

package/dist/types/legacy/components/layout/Sidebar/Sidebar.d.ts

@@ -1,12 +1,13 @@
 import React from 'react';
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+import { type SideNavItem, type SideNavLabels } from '../../../../v1/components/layout/SideNav/SideNav';
+/** @deprecated Legacy — usar `SideNavTheme` do V1. */
 export type SidebarTheme = 'light' | 'dark' | 'system';
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+/** @deprecated Legacy — usar `languages` do `SideNav` do V1. */
 export interface SidebarLanguage {
     code: string;
     label: string;
 }
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+/** @deprecated Legacy — usar `SideNavItem` do V1. */
 export interface SidebarMenuItem {
     to: string;
     icon: React.ComponentType<{
@@ -16,16 +17,12 @@ export interface SidebarMenuItem {
     label: string;
     group?: string;
     end?: boolean;
-    /** Contador opcional (ex: aprovações pendentes). Igual ao badge do Sidebar dos Tickets. */
+    /** Contador opcional (ex: aprovações pendentes). */
     badge?: number;
-    /**
-     * Destino fora da aplicação (SharePoint, portal antigo, etc.): abre em
-     * separador novo em vez de navegar pelo router. Sem isto, um URL absoluto
-     * ia parar ao NavLink, que o trata como rota interna e dá página em branco.
-     */
+    /** Destino fora da aplicação: abre em separador novo. */
     external?: boolean;
 }
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+/** @deprecated Legacy — usar `SideNavProps` do V1. */
 export interface SidebarProps {
     isOpen?: boolean;
     setIsOpen?: (isOpen: boolean) => void;
@@ -35,13 +32,9 @@ export interface SidebarProps {
     avatar?: React.ReactNode;
     onLogout?: () => void;
     logoutLabel?: string;
-    /** Selector de idioma no rodapé da sidebar. Só aparece se `languages` vier. */
     languages?: SidebarLanguage[];
     currentLang?: string;
     onLanguageChange?: (code: string) => void;
-    /** Selector de tema (light/dark/system) no rodapé. Só aparece se `onThemeChange` vier.
-     * O common-ui só renderiza a UI + chama o callback — aplicar a classe `.dark`
-     * no <html> é responsabilidade da app (o seu gestor de tema). */
     theme?: SidebarTheme;
     onThemeChange?: (theme: SidebarTheme) => void;
     themeLabels?: {
@@ -50,20 +43,14 @@ export interface SidebarProps {
         dark?: string;
         system?: string;
     };
-    /** Slot extra no topo do rodapé (acima de tema/idioma/logout). Render-prop
-     * com o estado expandido → ex: filtro global (AgendamentoEDP → AoFilterDropdown). */
     footer?: (isExpanded: boolean) => React.ReactNode;
-    /**
-     * Quando este build foi feito — aparece por baixo do logout.
-     *
-     * Serve para responder a "isto já tem a correcção?": diz a idade do código
-     * que o browser está mesmo a correr, e não a que o servidor tem. A app é que
-     * decide a QUEM o mostra (tipicamente só admins) — passar a prop é mostrá-la.
-     */
     deployedAt?: string | number | Date;
-    /** Tooltip do rodapé, para a app o traduzir. */
     deployedAtLabel?: string;
 }
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
-declare const Sidebar: ({ isOpen, setIsOpen, menus, groupLabels, appTitle, avatar, onLogout, logoutLabel, languages, currentLang, onLanguageChange, theme, onThemeChange, themeLabels, footer, deployedAt, deployedAtLabel, }: SidebarProps) => React.JSX.Element;
+/** Itens do menu antigo no formato do V1 (`badge` → `badges`). */
+export declare const menuV1: (menus: SidebarMenuItem[]) => SideNavItem[];
+/** Os textos por omissão do menu antigo, para não mudarem nas apps que ainda o usam. */
+export declare const labelsV1: (p: Pick<SidebarProps, "logoutLabel" | "themeLabels" | "deployedAtLabel">) => Partial<SideNavLabels>;
+/** @deprecated Legacy — usar `SideNav` (ou `AppShell`) do V1. */
+declare const Sidebar: ({ isOpen, setIsOpen, menus, currentLang, logoutLabel, themeLabels, deployedAtLabel, ...rest }: SidebarProps) => React.JSX.Element;
 export default Sidebar;

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

@@ -1,8 +1,11 @@
 import React from 'react';
+import type { DataTableColumn } from '../DataTable/DataTable';
 /** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface ColumnPickerItem {
     key: string;
     label: string;
+    /** Escondida por omissão — é assim que o "Repor" a deixa. */
+    defaultHidden?: boolean;
 }
 /** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface ColumnPickerLabels {
@@ -10,11 +13,20 @@ export interface ColumnPickerLabels {
     title: string;
     all: string;
     none: string;
+    /** @deprecated O botão repõe ordem e visibilidade — usar `reset`. Continua a servir de texto quando `reset` não vem. */
     resetOrder: string;
+    /** Texto do botão que repõe ordem e colunas visíveis por omissão. */
+    reset?: string;
     moveUp: string;
     moveDown: string;
 }
-interface Props {
+/** Layout de colunas guardável (ex.: numa API): chaves escondidas e ordem (vazia = ordem natural). */
+export interface ColumnLayout {
+    hidden: string[];
+    order: string[];
+}
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export interface ColumnPickerProps {
     /** Colunas pela ordem em que estão a ser desenhadas (já reordenadas). */
     columns: ColumnPickerItem[];
     hidden: Set<string>;
@@ -27,6 +39,13 @@ interface Props {
      * nenhumas não é utilizável. Default 1.
      */
     keepFirst?: number;
+    /** Chaves que ficam sempre à vista: a caixa aparece marcada e desativada, e "Nenhuma" não as esconde. */
+    alwaysVisible?: string[];
+    /**
+     * Substitui o "Repor". Por omissão chama `onOrderChange([])` e `onHiddenChange` com as `defaultHidden`;
+     * o `useColumnLayout` passa aqui o seu `reset`, para repor as duas coisas num só aviso.
+     */
+    onReset?: () => void;
     labels?: Partial<ColumnPickerLabels>;
 }
 /**
@@ -40,7 +59,7 @@ interface Props {
  * voltarem a aparecer.
  * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
-export default function ColumnPicker({ columns, hidden, onHiddenChange, order, onOrderChange, keepFirst, labels, }: Props): React.JSX.Element;
+export default function ColumnPicker({ columns, hidden, onHiddenChange, order, onOrderChange, keepFirst, alwaysVisible, onReset, labels, }: ColumnPickerProps): React.JSX.Element;
 /**
  * Reordena as colunas por `order`. Chaves fora de `order` ficam no fim, pela ordem natural —
  * assim uma ordem guardada antes de a tabela ganhar colunas novas continua a servir, em vez
@@ -60,4 +79,38 @@ export declare function orderColumns<C extends {
 export declare function applyColumnLayout<C extends {
     key: string;
 }>(columns: C[], order: string[], hidden: Set<string>): C[];
-export {};
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export interface UseColumnLayoutOptions {
+    /**
+     * Layout guardado (ex.: vindo de uma API). Pode chegar depois de montar: aplica-se quando deixa de ser
+     * `undefined` — a não ser que a pessoa já tenha mexido entretanto. Sem layout guardado não se passa
+     * (ficam as `defaultHidden`).
+     */
+    initial?: ColumnLayout;
+    /** Chamado a cada mudança feita pela pessoa (inclui o "Repor"). É aqui que a app guarda. */
+    onChange?: (layout: ColumnLayout) => void;
+    /** Chaves que nunca se escondem (ver `ColumnPicker.alwaysVisible`). */
+    alwaysVisible?: string[];
+}
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export interface UseColumnLayoutResult<C extends ColumnPickerItem> {
+    /** Colunas a passar à tabela: ordenadas e sem as escondidas. */
+    visibleColumns: C[];
+    layout: ColumnLayout;
+    /** Muda o layout (valor ou função do anterior) e avisa `onChange`. */
+    setLayout: (next: ColumnLayout | ((prev: ColumnLayout) => ColumnLayout)) => void;
+    /** Volta à ordem natural com as `defaultHidden` escondidas, e avisa `onChange`. */
+    reset: () => void;
+    /** Props prontas para `<ColumnPicker {...pickerProps} />`. */
+    pickerProps: Pick<ColumnPickerProps, 'hidden' | 'onHiddenChange' | 'order' | 'onOrderChange' | 'alwaysVisible' | 'onReset'> & {
+        columns: C[];
+    };
+}
+/**
+ * Estado do layout de colunas (visibilidade + ordem) para ligar ao `ColumnPicker` e à tabela.
+ *
+ * Não guarda nada: quem persiste (sessão, API do servidor…) é a app, com `initial` + `onChange`. Arranca com
+ * as `defaultHidden` escondidas e as `alwaysVisible` nunca saem.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
+export declare function useColumnLayout<T, C extends ColumnPickerItem = DataTableColumn<T>>(columns: C[], { initial, onChange, alwaysVisible }?: UseColumnLayoutOptions): UseColumnLayoutResult<C>;

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

@@ -35,8 +35,9 @@ export interface DataTableColumn<T> {
     /** Chave usada só para ORDENAR os grupos (sobrepõe-se a `value` ao agrupar por esta coluna). */
     groupSortKey?: (row: T) => string | number | null | undefined;
     /**
-     * Filtros extra desenhados como funis adicionais no cabeçalho desta coluna — para filtrar
-     * por um campo que não tem coluna própria (ex: filtrar a coluna "Obra" por concelho).
+     * Filtros extra no cabeçalho desta coluna — para filtrar por um campo que não tem coluna
+     * própria (ex: filtrar a coluna "Obra" por concelho). Partilham o funil da coluna: o popup
+     * mostra no topo um seletor (coluna + cada filtro extra) para escolher a lista a filtrar.
      */
     extraFilters?: {
         key: string;
@@ -57,6 +58,17 @@ export interface DataTableColumn<T> {
      * valor escolhido ganha o seu chip, removível à parte.
      */
     valueChipColors?: Record<string, string>;
+    /**
+     * Vários valores de filtro por linha (ex.: um equipamento com várias aplicações). Alimenta a lista do funil,
+     * o filtro (a linha passa se QUALQUER um dos seus valores estiver escolhido) e os chips. Sem isto, um valor
+     * por linha (`value`). Ao agrupar, usa o `value` da linha (a combinação de valores, ex.: "Hardware, Rede").
+     */
+    filterValues?: (row: T) => ReadonlyArray<string | number | null | undefined>;
+    /**
+     * Escondida à partida no layout de colunas (`useColumnLayout` e o "Repor" do `ColumnPicker`). A tabela em
+     * si desenha as colunas que recebe.
+     */
+    defaultHidden?: boolean;
 }
 /**
  * Ordenação, filtros e agrupamento do cabeçalho vivem dentro da tabela. Quem está por fora
@@ -117,16 +129,25 @@ export interface DataTableLabels {
     moreOptions: string;
     /** Aviso no popup enquanto `allData` não chegou — as opções ainda são só as de `data`. */
     loadingOptions: string;
-    /** Placeholders dos dois campos do filtro por intervalo (colunas numéricas e de datas). */
+    /** Placeholders dos dois campos do filtro por intervalo nas colunas numéricas. */
     min: string;
     max: string;
+    /** Rótulos dos dois campos do filtro por intervalo nas colunas de datas (default 'From'/'To'). */
+    from?: string;
+    to?: string;
     /** {page}/{pages} são substituídos. */
     page: string;
     prev: string;
     next: string;
-    /** Ordenação a partir do popup de filtro. */
+    /** Ordenação a partir do popup de filtro, nas colunas de texto (A→Z / Z→A). */
     sortAsc: string;
     sortDesc: string;
+    /** Ordenação a partir do popup nas colunas de datas (default 'Oldest first'/'Newest first'). */
+    sortOldest?: string;
+    sortNewest?: string;
+    /** Ordenação a partir do popup nas colunas numéricas (default 'Smallest first'/'Largest first'). */
+    sortSmallest?: string;
+    sortLargest?: string;
     /** Agrupamento. {label} é o nome da coluna. */
     groupBy: string;
     ungroup: string;
@@ -139,6 +160,8 @@ export interface DataTableLabels {
     selectAllResults: string;
     /** Rótulo da linha de total (`totalRow`). */
     total: string;
+    /** Nome acessível da zona com scroll horizontal (só com `scrollAffordance`). */
+    scrollRegion?: string;
 }
 interface DataTableProps<T> {
     columns: DataTableColumn<T>[];
@@ -161,6 +184,12 @@ interface DataTableProps<T> {
     isAllDataLoading?: boolean;
     /** Força o modo cliente mesmo sem interação (desde que `allData` exista). */
     alwaysClient?: boolean;
+    /**
+     * Total de linhas no servidor (paginação de servidor). Fora do modo cliente, `data` é só a página à
+     * vista — o texto de resultados da toolbar usa então este total em vez do nº de linhas de `data`.
+     * Em modo cliente (ou com filtros ativos) conta-se, como sempre, as linhas filtradas.
+     */
+    totalCount?: number;
     /**
      * Avisa quando a tabela passa (ou deixa) de trabalhar sobre `allData`. Quem tem paginação
      * de servidor por fora usa isto para a esconder: em modo cliente as linhas à vista já não
@@ -186,13 +215,26 @@ interface DataTableProps<T> {
     isError?: boolean;
     /** max-height do viewport com scroll (default 70vh). */
     maxHeight?: string;
-    /** Linhas por página. Sem isto, mostra tudo (pode ser lento com muitas linhas). */
+    /**
+     * Linhas por página. Sem isto, mostra tudo (pode ser lento com muitas linhas).
+     *
+     * Com `allData` quem pagina `data` é a app (paginação de servidor): a tabela só pagina em modo cliente
+     * (filtros/ordenação/agrupamento ativos), senão paginava outra vez a página que já recebeu.
+     * Com `storageKey`, o tamanho escolhido no selector fica na sessão (`dt_pagesize_<storageKey>`).
+     */
     pageSize?: number;
     /** Mostra um selector de linhas por página com estas opções. */
     pageSizeOptions?: number[];
     /** Caixa de seleção por linha + no cabeçalho. */
     selectable?: boolean;
     onSelectionChange?: (selectedKeys: Set<string>) => void;
+    /** Linhas que se podem selecionar (default: todas). As outras mostram a caixa desativada e ficam fora do "selecionar todas". */
+    isRowSelectable?: (row: T) => boolean;
+    /**
+     * Seleção inicial (chaves de `rowKey`). Volta a ser aplicada quando muda por valor (não por identidade) —
+     * ex.: uma pré-seleção vinda de outro ecrã. Não chama `onSelectionChange`: quem a passa já a conhece.
+     */
+    initialSelectedKeys?: Iterable<string | number>;
     /** Mudar este número limpa a seleção (ex: depois de uma ação em massa). */
     clearSelectionTrigger?: number;
     /** Guarda filtros e intervalos no sessionStorage com esta chave (e as larguras das colunas no localStorage). */
@@ -203,7 +245,8 @@ interface DataTableProps<T> {
     resizableColumns?: boolean;
     /**
      * "Ordenar A→Z / Z→A" no topo do popup de filtro. Ligado por omissão (o cabeçalho é o mesmo em todos os
-     * portais); `false` desliga. Os textos vêm de `labels.sortAsc`/`sortDesc` (por omissão em inglês).
+     * portais); `false` desliga. Os textos dependem do `sortType`: `labels.sortAsc`/`sortDesc` no texto,
+     * `sortOldest`/`sortNewest` nas datas e `sortSmallest`/`sortLargest` nos números (por omissão em inglês).
      */
     sortFromFilter?: boolean;
     /**
@@ -241,6 +284,28 @@ interface DataTableProps<T> {
     totalRow?: boolean;
     /** Agrupamento inicial (chaves de colunas, por ordem de nível). A pessoa pode mudá-lo depois. */
     defaultGroupBy?: string[];
+    /**
+     * Agrupamento controlado (chaves de colunas, por ordem de nível). Com isto a tabela usa este valor (ignora
+     * `defaultGroupBy` e a sessão) e as mudanças da pessoa chegam por `onGroupByChange`.
+     */
+    groupBy?: string[];
+    /** Chamado quando a pessoa muda o agrupamento (também sem `groupBy`, só para acompanhar). */
+    onGroupByChange?: (keys: string[]) => void;
+    /** Chamado quando a ordenação muda (`null` = sem ordenação). Também ao montar, se a inicial não for nenhuma. */
+    onSortChange?: (sort: {
+        key: string;
+        dir: 'asc' | 'desc';
+    } | null) => void;
+    /**
+     * Chamado quando os filtros por valor das colunas mudam (chave → valores escolhidos). Também ao montar, se
+     * vierem filtros da sessão. Só os ativos; os intervalos ficam de fora (ver `viewRef`).
+     */
+    onColumnFiltersChange?: (filters: Record<string, string[]>) => void;
+    /**
+     * Torna focável a zona com scroll horizontal (`role="region"`, nome em `labels.scrollRegion`) e deixa
+     * deslizá-la com ←/→/Home/End. Default desligado.
+     */
+    scrollAffordance?: boolean;
 }
 /**
  * Timestamp de um valor de coluna de data. As apps passam a data já formatada (`value:
@@ -275,5 +340,5 @@ export declare function pesquisaCuringa(q: string): (v: string) => boolean;
  * filtrar, ordenar e agrupar só olhariam para a página à vista.
  * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
-export default function DataTable<T>({ columns, data, allData, onDataNeeded, isAllDataLoading, alwaysClient, onClientModeChange, rowKey, onRowClick, onRowDoubleClick, rowClassName, onVisibleRowsChange, isLoading, isError, maxHeight, pageSize, pageSizeOptions, selectable, onSelectionChange, clearSelectionTrigger, storageKey, defaultMaxColumnWidth, resizableColumns, sortFromFilter, filterMode, defaultSortKey, defaultSortDir, viewRef, exportFileName, onExport, extraToolbar, emptySubLabel, emptyIcon, labels, totalRow, defaultGroupBy, }: DataTableProps<T>): React.JSX.Element;
+export default function DataTable<T>({ columns, data, allData, onDataNeeded, isAllDataLoading, alwaysClient, totalCount, onClientModeChange, rowKey, onRowClick, onRowDoubleClick, rowClassName, onVisibleRowsChange, isLoading, isError, maxHeight, pageSize, pageSizeOptions, selectable, onSelectionChange, isRowSelectable, initialSelectedKeys, clearSelectionTrigger, storageKey, defaultMaxColumnWidth, resizableColumns, sortFromFilter, filterMode, defaultSortKey, defaultSortDir, viewRef, exportFileName, onExport, extraToolbar, emptySubLabel, emptyIcon, labels, totalRow, defaultGroupBy, groupBy, onGroupByChange, onSortChange, onColumnFiltersChange, scrollAffordance, }: DataTableProps<T>): React.JSX.Element;
 export {};

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

@@ -6,15 +6,14 @@ interface UserAvatarProps {
     company?: string | null;
     jobTitle?: string | null;
     department?: string | null;
+    /** Tamanho, forma e cores das iniciais (classes Tailwind), como antes. */
     className?: string;
     /** Mostra o cartão de detalhes em hover (foto ampliada + nome/email). Default: off. */
     showCard?: boolean;
 }
 /**
- * Avatar de utilizador: mostra a foto (se disponível) ou as iniciais, com um
- * cartão de detalhes em hover (via portal). Usa classes Tailwind — a app
- * consumidora é responsável por gerar o CSS Tailwind.
- * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ * Migrado para o V1: adaptador do `Avatar` (nomes antigos; o tamanho e as cores vêm do `className`).
+ * @deprecated Legacy — usar o `Avatar` (ou o `Person`, com o nome ao lado) do V1. Ver Storybook › Legacy.
  */
-export default function UserAvatar({ name, photo, email, company, jobTitle, department, className, showCard, }: UserAvatarProps): React.JSX.Element;
+export default function UserAvatar({ name, photo, email, company, jobTitle, department, className, showCard }: UserAvatarProps): React.JSX.Element;
 export {};