@nextelco/common-ui 2.1.105 → 2.1.107

package/dist/types/legacy/components/ui/Avisos.d.ts

@@ -1,7 +1,7 @@
 import React, { type ReactNode } from 'react';
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+/** @deprecated Legacy — usar `useToast` do V1. */
 export type TipoAviso = 'sucesso' | 'erro' | 'aviso' | 'info';
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+/** @deprecated Legacy — usar `ToastOptions` do V1. */
 export interface OpcoesAviso {
     /** Botão no aviso (ex: "Tentar de novo", "Desfazer"). */
     acao?: {
@@ -11,7 +11,7 @@ export interface OpcoesAviso {
     /** Milissegundos até fechar sozinho. 0 = só fecha à mão. */
     duracao?: number;
 }
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+/** @deprecated Legacy — usar `ToastApi` do V1. */
 export interface AvisosApi {
     sucesso: (mensagem: ReactNode, opcoes?: OpcoesAviso) => number;
     erro: (mensagem: ReactNode, opcoes?: OpcoesAviso) => number;
@@ -19,7 +19,7 @@ export interface AvisosApi {
     info: (mensagem: ReactNode, opcoes?: OpcoesAviso) => number;
     fechar: (id: number) => void;
 }
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+/** @deprecated Legacy — usar `ToastProviderProps` do V1. */
 export interface AvisosProviderProps {
     children: ReactNode;
     /** Rótulo do botão de fechar (leitores de ecrã). */
@@ -27,17 +27,7 @@ export interface AvisosProviderProps {
     /** Máximo de avisos visíveis ao mesmo tempo; os mais antigos saem. */
     maximo?: number;
 }
-/**
- * Avisos de resultado de ações ("Guardado", "Não foi possível eliminar").
- *
- * Substituem os `alert()` do browser e as caixas de erro feitas em cada página.
- * Pôr o provider uma vez à volta da app e usar `useAvisos()` onde for preciso.
- * Erros de validação de formulário NÃO vão aqui: ficam junto aos campos.
- * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
- */
+/** @deprecated Legacy — usar `ToastProvider` do V1. */
 export declare function AvisosProvider({ children, rotuloFechar, maximo }: AvisosProviderProps): React.JSX.Element;
-/**
- * Avisos da app. Tem de estar dentro de um `AvisosProvider`.
- * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
- */
+/** @deprecated Legacy — usar `useToast` do V1. */
 export declare function useAvisos(): AvisosApi;

package/dist/types/legacy/components/ui/CabecalhoPagina.d.ts

@@ -1,37 +1,23 @@
 import React, { type ReactNode } from 'react';
-/**
- * Um nível do caminho por cima do título.
- * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
- */
+/** @deprecated Legacy — usar `BreadcrumbItem` do V1. */
 export interface NivelCaminho {
     rotulo: ReactNode;
     /** Ligação normal. Para o router da app, usar `onClick` (ex: `() => navigate('/x')`). */
     href?: string;
     onClick?: () => void;
 }
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+/** @deprecated Legacy — usar `PageHeaderProps` do V1. */
 export interface CabecalhoPaginaProps {
     titulo: ReactNode;
     descricao?: ReactNode;
-    /**
-     * Caminho até à página (área › lista › registo). O último nível é a página
-     * atual e não leva ligação, mesmo que a traga.
-     */
+    /** Caminho até à página (área › lista › registo). O último nível é a página atual. */
     caminho?: NivelCaminho[];
-    /** Botões da página (ex: "Novo", "Editar"). Ficam à direita e descem em ecrã estreito. */
+    /** Botões da página (ex: "Novo", "Editar"). */
     acoes?: ReactNode;
     /** Linha extra por baixo da descrição (etiquetas de estado, responsável…). */
     extra?: ReactNode;
     /** Rótulo acessível da navegação do caminho. */
     rotuloCaminho?: string;
 }
-/**
- * Cabeçalho comum a todas as páginas: caminho, título com a barra turquesa,
- * descrição e ações.
- *
- * Existe para o título deixar de ser desenhado à mão em cada ecrã — com
- * tamanhos, cores e posições diferentes de página para página. O nome no menu,
- * o título e o último nível do caminho devem ser o mesmo texto.
- * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
- */
-export default function CabecalhoPagina({ titulo, descricao, caminho, acoes, extra, rotuloCaminho, }: CabecalhoPaginaProps): React.JSX.Element;
+/** @deprecated Legacy — usar `PageHeader` (ou `Page`) do V1. */
+export default function CabecalhoPagina({ titulo, descricao, caminho, acoes, extra, rotuloCaminho }: CabecalhoPaginaProps): React.JSX.Element;

package/dist/types/legacy/components/ui/CaixaPesquisa.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+/** @deprecated Legacy — usar `SearchInputProps` do V1. */
 export interface CaixaPesquisaProps {
     valor: string;
     onMudar: (valor: string) => void;
@@ -9,8 +10,5 @@ export interface CaixaPesquisaProps {
     className?: string;
     autoFocus?: boolean;
 }
-/**
- * Caixa de pesquisa das barras de tabela e listas: mesma altura (h-8) e cantos (rounded-lg) dos botões, do
- * Exportar e do seletor de colunas. Lupa à esquerda; com texto, um "×" para limpar (Esc também limpa).
- */
+/** @deprecated Legacy — usar `SearchInput` do V1. */
 export default function CaixaPesquisa({ valor, onMudar, placeholder, rotulo, className, autoFocus }: CaixaPesquisaProps): React.JSX.Element;

package/dist/types/legacy/components/ui/Confirmacao.d.ts

@@ -1,5 +1,5 @@
 import React, { type ReactNode } from 'react';
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+/** @deprecated Legacy — usar `ConfirmDialog` ou `useConfirm` do V1. */
 export interface ConfirmacaoProps {
     aberto: boolean;
     titulo: ReactNode;
@@ -20,12 +20,5 @@ export interface ConfirmacaoProps {
         onClick: () => void;
     };
 }
-/**
- * Pedido de confirmação antes de uma ação. Substitui o `window.confirm()` do
- * browser, que mostra o endereço do servidor, não diz que registo é e só tem
- * "OK".
- *
- * Esc e clicar fora cancelam (exceto enquanto `aConfirmar`).
- * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
- */
-export default function Confirmacao({ aberto, titulo, children, onConfirmar, onCancelar, textoConfirmar, textoCancelar, variante, aConfirmar, acaoSecundaria, }: ConfirmacaoProps): React.JSX.Element | null;
+/** @deprecated Legacy — usar `ConfirmDialog` ou `useConfirm` do V1. */
+export default function Confirmacao({ aberto, titulo, children, onConfirmar, onCancelar, textoConfirmar, textoCancelar, variante, aConfirmar, acaoSecundaria, }: ConfirmacaoProps): React.JSX.Element;

package/dist/types/legacy/components/ui/Escolha.d.ts

@@ -14,32 +14,22 @@ export interface EscolhaProps {
     rotulo: string;
     /** Texto do botão sem nada escolhido. */
     placeholder?: string;
-    /**
-     * Primeira opção "vazia" (valor ''), para desfazer a escolha (ex.: "Todas"). Sem isto não há como voltar atrás
-     * depois de escolher.
-     */
+    /** Primeira opção "vazia" (valor ''), para desfazer a escolha (ex.: "Todas"). */
     opcaoVazia?: string;
     disabled?: boolean;
     /** Caixa de pesquisa no topo da lista. Por omissão, só com mais de 10 opções. */
     pesquisa?: boolean;
     /** Largura (classes tailwind). Por omissão a do conteúdo, entre 10rem e 18rem (etiqueta: a do texto). */
     className?: string;
-    /**
-     * 'barra' (omissão): h-8, como os botões e filtros das barras. 'formulario': a altura dos campos de texto dos
-     * formulários (px-3 py-2), para alinhar com eles.
-     */
+    /** 'barra' (omissão): a altura dos botões e filtros. 'formulario': a altura dos campos dos formulários legacy (38px). */
     tamanho?: 'barra' | 'formulario';
-    /**
-     * 'campo' (omissão) ou 'etiqueta': o botão é uma etiqueta arredondada (ex.: o estado numa linha de tabela), com
-     * as cores de `corEtiqueta`. A lista é a mesma.
-     */
+    /** 'campo' (omissão) ou 'etiqueta': o botão é uma etiqueta arredondada, com as cores de `corEtiqueta`. */
     aspeto?: 'campo' | 'etiqueta';
     /** Classes de cor da etiqueta (fundo, texto e variante dark:), normalmente conforme o valor escolhido. */
     corEtiqueta?: string;
 }
 /**
- * Lista suspensa para escolher um valor (substitui o `<select>` nativo, que abre com o aspeto do sistema e não
- * segue o tema). Mesma altura e cantos dos botões e campos (h-8, rounded-lg); a lista tem o mesmo aspeto do
- * MenuAcoes. Teclado: ↑/↓, Home/End, Enter escolhe, Esc fecha; ao escrever com a lista aberta salta para a opção.
+ * Migrado para o V1: adaptador do `SelectInput` (a mesma lista desenhada, nomes antigos e textos em português).
+ * @deprecated Legacy — usar o `SelectInput` do V1. Ver Storybook › Legacy.
  */
 export default function Escolha({ valor, opcoes, onMudar, rotulo, placeholder, opcaoVazia, disabled, pesquisa, className, tamanho, aspeto, corEtiqueta, }: EscolhaProps): React.JSX.Element;

package/dist/types/legacy/components/ui/FaixaAviso.d.ts

@@ -13,11 +13,7 @@ export interface FaixaAvisoProps {
     icone?: ReactNode;
 }
 /**
- * Faixa no topo do conteúdo para um estado que afeta a página inteira: "Ver
- * como" outro perfil, um serviço externo em baixo, dados possivelmente
- * incompletos. Não é para resultados de ações — esses são avisos (`useAvisos`).
- *
- * Fica bem no slot `topBar` do Layout.
- * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ * Migrado para o V1: adaptador do `Notice` com `variant="banner"` (faixa no topo da página).
+ * @deprecated Legacy — usar o `Notice` do V1. Ver Storybook › Legacy.
  */
 export default function FaixaAviso({ children, tom, acao, icone }: FaixaAvisoProps): React.JSX.Element;

package/dist/types/legacy/components/ui/Separadores.d.ts

@@ -1,5 +1,5 @@
 import React, { type ReactNode } from 'react';
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+/** @deprecated Legacy — usar `TabItem` do V1. */
 export interface Separador<T extends string> {
     id: T;
     rotulo: ReactNode;
@@ -7,7 +7,7 @@ export interface Separador<T extends string> {
     contagem?: number;
     desativado?: boolean;
 }
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+/** @deprecated Legacy — usar `TabsProps` do V1. */
 export interface SeparadoresProps<T extends string> {
     itens: Separador<T>[];
     ativo: T;
@@ -15,12 +15,5 @@ export interface SeparadoresProps<T extends string> {
     /** Rótulo acessível do conjunto (ex: "Estado das faturas"). */
     rotulo?: string;
 }
-/**
- * Separadores de uma página, iguais em todo o portal.
- *
- * O ativo fica a navy com sublinhado (não turquesa: turquesa sobre branco não
- * tem contraste para texto). Setas esquerda/direita, Home e End mudam de
- * separador, como num tablist normal.
- * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
- */
+/** @deprecated Legacy — usar `Tabs` do V1. */
 export default function Separadores<T extends string>({ itens, ativo, onMudar, rotulo }: SeparadoresProps<T>): React.JSX.Element;

package/dist/types/legacy/components/ui/Ui.d.ts

@@ -5,13 +5,8 @@ import React, { type ReactNode } from 'react';
  * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export type StatusSla = 'ok' | 'risco' | 'incumprido';
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
-export declare function Card({ title, extra, children, className }: {
-    title?: ReactNode;
-    extra?: ReactNode;
-    children: ReactNode;
-    className?: string;
-}): React.JSX.Element;
+import { Card } from '../../../v1/primitives/display/Card/Card';
+export { Card };
 /**
  * Colour-bordered group — the overview sections in the prototype.
  * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
@@ -21,51 +16,10 @@ export declare function SectionGroup({ title, tone, children, }: {
     tone?: 'accent' | 'ok' | 'blue' | 'red' | 'purple' | 'yellow';
     children: ReactNode;
 }): React.JSX.Element;
-export type KpiTone = 'default' | 'brand' | 'ok' | 'risco' | 'incumprido';
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
-export declare function Kpi({ label, value, tone, delta, onClick, bgTint, active, hint, dot, barra, rodape, denso, }: {
-    label: string;
-    value: ReactNode;
-    tone?: KpiTone;
-    delta?: ReactNode;
-    onClick?: () => void;
-    /** Ponto colorido antes do rótulo — liga o indicador à cor que ele tem no mapa ou na legenda. */
-    dot?: string;
-    /**
-     * Barra por baixo do valor. Um número é uma percentagem; uma lista é uma
-     * barra repartida, com cada troço proporcional ao seu peso.
-     *
-     * Serve para o indicador dizer a PROPORÇÃO e não só o valor: "253 concluídas"
-     * não diz nada sem saber de quantas.
-     */
-    barra?: number | {
-        peso: number;
-        cor: string;
-    }[];
-    /** Linha pequena no fim, para um dado que acompanha mas não é o indicador. */
-    rodape?: ReactNode;
-    /**
-     * Faixa fina em vez de cartão.
-     *
-     * Oito indicadores em cartões de 88px empurram o conteúdo para fora do ecrã,
-     * e o conteúdo é que é o trabalho. Denso alinha à esquerda e corta a altura
-     * para metade — os números continuam a ler-se, e o mapa fica acima da dobra.
-     */
-    denso?: boolean;
-    /** Fundo colorido (tom claro) em vez de só o número — opt-in, sem quebrar o uso existente. */
-    bgTint?: boolean;
-    /** Filtro ativo (KPI clicável selecionado): contorno azul. */
-    active?: boolean;
-    /** Tooltip do KPI clicável (ex: "Filtrar a tabela"). */
-    hint?: string;
-}): React.JSX.Element;
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
-export type BadgeTone = 'ok' | 'risco' | 'incumprido' | 'neutral' | 'accent';
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
-export declare function Badge({ tone, children }: {
-    tone?: BadgeTone;
-    children: ReactNode;
-}): React.JSX.Element;
+import { Kpi, type KpiTone } from '../../../v1/primitives/display/Kpi/Kpi';
+export { Kpi, type KpiTone };
+import { Badge, type BadgeTone } from '../../../v1/primitives/display/Badge/Badge';
+export { Badge, type BadgeTone };
 /**
  * SLA badge — picks the tone and label from `status`. Labels overridable via `labels`.
  * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
@@ -82,7 +36,10 @@ export declare function BadgeSla({ status, labels }: {
 export declare function ChipEstadoInterno({ estado }: {
     estado: string | null;
 }): React.JSX.Element;
-/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+/**
+ * Migrado para o V1: é o `Button` do V1 (mesmo aspeto); isto só mantém a API antiga.
+ * @deprecated Legacy — usar `Button` do V1.
+ */
 export declare function Btn({ children, onClick, variant, active, disabled, title, type, }: {
     children: ReactNode;
     onClick?: () => void;
@@ -94,7 +51,8 @@ export declare function Btn({ children, onClick, variant, active, disabled, titl
 }): React.JSX.Element;
 /**
  * Mutually exclusive button group (granularity, dimension…).
- * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ * Migrado para o V1: é o `SegmentedControl` do V1; isto só mantém a API antiga.
+ * @deprecated Legacy — usar `SegmentedControl` do V1.
  */
 export declare function BtnGroup<T extends string>({ value, options, onChange, label, }: {
     value: T;

package/dist/types/legacy/components/ui/painelFlutuante.d.ts

@@ -1,20 +1,16 @@
-import { type CSSProperties } from 'react';
 /**
- * Aspeto comum das listas suspensas (Escolha e MenuAcoes): cartão arredondado com sombra, nos dois temas.
- * Um só sítio para as duas ficarem iguais.
+ * Migrado para o V1 (`useFloatingPanel`): estes nomes ficam para o MenuAcoes e o código legacy.
+ * @deprecated Legacy — usar o `useFloatingPanel` do V1.
  */
 export declare const CLS_PAINEL = "fixed z-[60] min-w-[10rem] max-h-72 overflow-auto rounded-xl border border-slate-200 bg-white py-1 text-sm shadow-lg dark:border-slate-700 dark:bg-slate-900";
-/** Item de uma lista suspensa; `ativo` = o que o teclado tem selecionado. */
-export declare const clsItem: (ativo: boolean, perigo?: boolean) => string;
-/**
- * Painel flutuante preso a um botão: posição fixa (não é cortado por tabelas ou modais com scroll), abre para
- * cima quando não cabe por baixo, fecha ao clicar fora, com Esc, ao fazer scroll fora dele ou ao redimensionar.
- */
+/** @deprecated Legacy — usar o `itemClass` do V1. */
+export declare const clsItem: (active: boolean, danger?: boolean) => string;
+/** @deprecated Legacy — usar o `useFloatingPanel` do V1. */
 export declare function usePainelFlutuante(alinhar?: 'esquerda' | 'direita'): {
     aberto: boolean;
     setAberto: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     fechar: () => void;
     refBotao: import("react").RefObject<HTMLButtonElement | null>;
     refPainel: import("react").RefObject<HTMLDivElement | null>;
-    estilo: CSSProperties;
+    estilo: import("react").CSSProperties;
 };

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

@@ -11,7 +11,7 @@ export { default as IconButton } from '../components/atoms/Button/variants/IconB
 export { default as TabButton } from '../components/atoms/Button/variants/TabButton';
 export { default as MainButton } from '../components/atoms/Button/variants/MainButton';
 export { default as Stack } from '../components/atoms/Stack/Stack';
-export { default as Tooltip } from '../components/atoms/Tooltip/Tooltip';
+export { default as Tooltip } from '../../v1/components/overlays/Tooltip/Tooltip';
 export { default as Input } from '../components/atoms/Input/Input';
 export { default as Icone } from '../components/atoms/Icone/Icone';
 export type { IconeQualquer } from '../components/atoms/Icone/Icone';

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

@@ -1,2 +1,2 @@
-export { PALETA, cor, BarrasEmpilhadas, BarrasHorizontais, Anel, Linha, Linhas, Bolhas, } from '../components/charts/Charts';
-export type { SerieEmpilhada, Distribuicao, PontoRisco } from '../components/charts/Charts';
+export { PALETA, cor, Barras, BarrasEmpilhadas, BarrasHorizontais, Anel, Linha, Linhas, Bolhas, } from '../components/charts/Charts';
+export type { SerieEmpilhada, Distribuicao, PontoRisco, BarrasProps, CliqueGrafico } from '../components/charts/Charts';

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

@@ -1,4 +1,4 @@
 export { useApi } from '../hooks/useApi';
 export type { RequestOptions } from '../hooks/useApi';
-export { useTheme } from '../hooks/useTheme';
-export type { Theme } from '../hooks/useTheme';
+export { useTheme } from '../../v1/capabilities/theme/useTheme';
+export type { Theme } from '../../v1/capabilities/theme/useTheme';

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

@@ -9,8 +9,8 @@ export { default as PhotoAvatar } from '../components/molecules/PhotoAvatar/Phot
 export { default as DataTable } from '../components/molecules/DataTable/DataTable';
 export { timestampDeData } from '../components/molecules/DataTable/DataTable';
 export type { DataTableColumn, DataTableLabels, DataTableView, DataTableEstado, } from '../components/molecules/DataTable/DataTable';
-export { default as ColumnPicker, applyColumnLayout, orderColumns, } from '../components/molecules/ColumnPicker/ColumnPicker';
-export type { ColumnPickerItem, ColumnPickerLabels, } from '../components/molecules/ColumnPicker/ColumnPicker';
+export { default as ColumnPicker, applyColumnLayout, orderColumns, useColumnLayout, } from '../components/molecules/ColumnPicker/ColumnPicker';
+export type { ColumnPickerItem, ColumnPickerLabels, ColumnPickerProps, ColumnLayout, UseColumnLayoutOptions, UseColumnLayoutResult, } from '../components/molecules/ColumnPicker/ColumnPicker';
 export { default as FileDropzone } from '../components/molecules/FileDropzone/FileDropzone';
 export type { FileDropzoneProps, FileDropzoneLabels } from '../components/molecules/FileDropzone/FileDropzone';
 export { default as LanguageSwitcher } from '../components/molecules/LanguageSwitcher/LanguageSwitcher';

package/dist/types/v1/capabilities/overlay/useFloatingPanel.d.ts

@@ -0,0 +1,20 @@
+import { type CSSProperties } from 'react';
+/**
+ * Aspeto comum das listas suspensas (SelectInput, MenuAcoes): cartão arredondado com sombra, nos dois temas.
+ * Um só sítio para ficarem iguais.
+ */
+export declare const PANEL_CLASS = "fixed z-[60] min-w-[10rem] max-h-72 overflow-auto rounded-xl border border-slate-200 bg-white py-1 text-sm shadow-lg dark:border-slate-700 dark:bg-slate-900";
+/** Item de uma lista suspensa; `active` = o que o teclado tem selecionado. */
+export declare const itemClass: (active: boolean, danger?: boolean) => string;
+/**
+ * Painel flutuante preso a um botão: posição fixa (não é cortado por tabelas ou janelas com scroll), abre para
+ * cima quando não cabe por baixo, fecha ao clicar fora, ao fazer scroll fora dele ou ao redimensionar.
+ */
+export declare function useFloatingPanel(align?: 'left' | 'right'): {
+    open: boolean;
+    setOpen: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    close: () => void;
+    triggerRef: import("react").RefObject<HTMLButtonElement | null>;
+    panelRef: import("react").RefObject<HTMLDivElement | null>;
+    style: CSSProperties;
+};

package/dist/types/v1/capabilities/theme/useIsDark.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Se a app está em escuro agora (a classe `.dark` no `<html>`), e muda quando o
+ * tema muda.
+ *
+ * Para o que não pode usar o `dark:` do Tailwind e precisa das cores em
+ * JavaScript: gráficos, `<iframe>`, SVG com cores por props. O componente volta
+ * a desenhar quando o tema muda.
+ */
+export declare function useIsDark(): boolean;
+export default useIsDark;

package/dist/types/v1/capabilities/theme/useTheme.d.ts

@@ -0,0 +1,29 @@
+export type Theme = 'light' | 'dark' | 'system';
+/** Chave da escolha no localStorage. A mesma nos portais (Tickets, AuditoriasIT). */
+export declare const THEME_STORAGE_KEY = "theme";
+/** Põe ou tira a classe `.dark` no `<html>`: é a ela que os componentes e os tokens reagem. */
+export declare function applyTheme(theme: Theme): void;
+/**
+ * Script para pôr no `<head>` do `index.html`, antes do CSS: aplica o tema
+ * guardado antes da primeira pintura (sem o clarão branco ao abrir em escuro).
+ *
+ * O build também o põe em `dist/theme-boot.js`, para a app o injetar no
+ * `index.html` sem o copiar (ex: num plugin `transformIndexHtml` do Vite).
+ */
+export declare const themeBootScript = "(function(){try{var k='theme',o='proef-theme',v=localStorage.getItem(k)||localStorage.getItem(o)||'system';if(v==='dark'||(v==='system'&&window.matchMedia('(prefers-color-scheme: dark)').matches))document.documentElement.classList.add('dark')}catch(e){}})();";
+/**
+ * Tema da app: claro, escuro ou o do sistema. Guarda a escolha (sozinho, a cada
+ * mudança), aplica a classe `.dark` no `<html>`, segue o sistema em `system` e
+ * acompanha a escolha feita noutro separador.
+ *
+ *   const { theme, setTheme } = useTheme()
+ *   <AppShell theme={theme} onThemeChange={setTheme} …/>
+ *
+ * Para não haver clarão ao abrir, pôr o `themeBootScript` no `index.html`.
+ */
+export declare function useTheme(): {
+    theme: Theme;
+    setTheme: (t: Theme) => void;
+    cycle: () => void;
+};
+export default useTheme;

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

@@ -0,0 +1,33 @@
+import React from 'react';
+export interface PaginationLabels {
+    /** "{page}" e "{pages}" são substituídos (ex: "Página {page} de {pages}"). */
+    page: string;
+    /** "{count}" é substituído pelo total de registos (ex: "{count} resultados"). */
+    total: string;
+    perPage: string;
+    prev: string;
+    next: string;
+}
+export declare const DEFAULT_PAGINATION_LABELS: PaginationLabels;
+export interface PaginationProps {
+    /** Página atual, a contar de 1. */
+    page: number;
+    /** Número de páginas. */
+    pages: number;
+    onPageChange: (page: number) => void;
+    /** Total de registos (mostrado à esquerda). */
+    total?: number;
+    /** Registos por página e as opções do seletor (sem opções, não há seletor). */
+    pageSize?: number;
+    pageSizeOptions?: number[];
+    onPageSizeChange?: (size: number) => void;
+    labels?: Partial<PaginationLabels>;
+    className?: string;
+}
+/**
+ * Paginação por baixo de uma lista: "Página 1 de 4", o total, quantos por página e
+ * Anterior/Seguinte. É a mesma que a `DataTable` mostra; usar esta quando a app pagina
+ * no servidor (a tabela recebe só a página atual).
+ */
+export default function Pagination({ page, pages, onPageChange, total, pageSize, pageSizeOptions, onPageSizeChange, labels, className, }: PaginationProps): React.JSX.Element;
+export { Pagination };

package/dist/types/v1/components/feedback/Toast/Toast.d.ts

@@ -0,0 +1,51 @@
+import React from 'react';
+export type ToastTone = 'success' | 'error' | 'warning' | 'info';
+export interface ToastOptions {
+    /** Linha em negrito por cima da mensagem. */
+    title?: string;
+    /** Botão no aviso (ex: Desfazer, Tentar de novo). Fecha o aviso depois de correr. */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+    /**
+     * Quanto tempo fica visível, em ms. `0`: fica até ser fechado. Por omissão
+     * depende do tipo: ler um erro demora mais do que um "Guardado".
+     */
+    duration?: number;
+}
+export interface ToastApi {
+    success: (message: React.ReactNode, options?: ToastOptions) => number;
+    error: (message: React.ReactNode, options?: ToastOptions) => number;
+    warning: (message: React.ReactNode, options?: ToastOptions) => number;
+    info: (message: React.ReactNode, options?: ToastOptions) => number;
+    /** Fecha um aviso pelo número que as funções acima devolvem. */
+    dismiss: (id: number) => void;
+}
+export interface ToastProviderProps {
+    children: React.ReactNode;
+    /** Nome do botão × de cada aviso, para leitores de ecrã. Por omissão: "Fechar aviso". */
+    closeLabel?: string;
+    /** Nome da zona dos avisos, para leitores de ecrã. Por omissão: "Avisos". */
+    regionLabel?: string;
+    /** Máximo de avisos visíveis ao mesmo tempo; os mais antigos saem. Por omissão 4. */
+    max?: number;
+}
+/**
+ * Avisos da app. Fora de um ToastProvider dá erro, para não se perderem
+ * avisos sem ninguém reparar.
+ */
+export declare function useToast(): ToastApi;
+/**
+ * Avisos do resultado de uma ação, no canto inferior direito (ex: "Ticket
+ * guardado", "Não foi possível apagar").
+ *
+ * Monta-se uma vez à volta da app; em qualquer ecrã, `useToast()` dá
+ * `success`, `error`, `warning` e `info`. Desaparecem sozinhos (os erros
+ * ficam mais tempo); com o rato por cima ficam até ele sair. Aparecem por cima
+ * de uma janela (Dialog) aberta.
+ *
+ * Substituem o `alert()` do browser. Erros de validação de um formulário não
+ * vão aqui: ficam junto aos campos.
+ */
+export default function ToastProvider({ children, closeLabel, regionLabel, max }: ToastProviderProps): React.JSX.Element;

package/dist/types/v1/components/forms/FormField/FormField.d.ts

@@ -21,9 +21,9 @@ export interface FormFieldProps {
     end?: React.ReactNode;
     /** Ocupa a linha toda (ex: observações, anexo). */
     wide?: boolean;
-    /** Etiqueta alinhada ao topo em vez de ao meio (campos altos, como o TextArea). */
+    /** Etiqueta alinhada ao topo em vez de ao meio (campos altos, como o [TextArea](?path=/docs/v1-primitives-forms-textarea--docs)). */
     alignTop?: boolean;
-    /** O campo: TextInput, SelectInput, TextArea ou outro. */
+    /** O campo: [TextInput](?path=/docs/v1-primitives-forms-textinput--docs), [SelectInput](?path=/docs/v1-primitives-forms-selectinput--docs), [TextArea](?path=/docs/v1-primitives-forms-textarea--docs), [LookupInput](?path=/docs/v1-primitives-forms-lookupinput--docs) ou outro. */
     children: React.ReactNode;
 }
 /**
@@ -31,7 +31,7 @@ export interface FormFieldProps {
  * [FormGrid](?path=/docs/v1-components-forms-formgrid--docs).
  *
  * Liga a etiqueta ao campo (clicar na etiqueta foca o campo) e passa-lhe o
- * `required`, se o campo for TextInput, SelectInput ou TextArea.
+ * `required`, se o campo for [TextInput](?path=/docs/v1-primitives-forms-textinput--docs), [SelectInput](?path=/docs/v1-primitives-forms-selectinput--docs), [TextArea](?path=/docs/v1-primitives-forms-textarea--docs) ou [LookupInput](?path=/docs/v1-primitives-forms-lookupinput--docs).
  */
 export default function FormField({ label, required, hint, marks, markSlots, aside, end, wide, alignTop, children }: FormFieldProps): React.JSX.Element;
 export interface FieldMarkProps {

package/dist/types/v1/components/forms/FormGrid/FormGrid.d.ts

@@ -15,6 +15,8 @@ export declare const useFormGrid: () => {
  *
  * Adapta-se à largura do sítio onde está (não à do ecrã): abaixo de 680 px as
  * etiquetas estreitam; abaixo de 500 px cada etiqueta fica por cima do campo.
+ *
+ * **Exemplo completo:** [Formulário em modal](?path=/docs/v1-patterns-forms-formulário-em-modal--docs).
  */
 export default function FormGrid({ columns, className, children }: FormGridProps): React.JSX.Element;
 /** Linha de separação entre grupos de campos, a toda a largura. */

package/dist/types/v1/components/layout/AppShell/AppShell.d.ts

@@ -0,0 +1,35 @@
+import React from 'react';
+import { type SideNavLabels, type SideNavProps } from '../SideNav/SideNav';
+export interface AppShellLabels extends SideNavLabels {
+    openMenu: string;
+}
+export interface AppShellProps extends Omit<SideNavProps, 'open' | 'onOpenChange' | 'footer' | 'labels'> {
+    children: React.ReactNode;
+    /** Conteúdo extra no rodapé do menu, por cima do tema (ex: um filtro global). */
+    sidebarFooter?: (expanded: boolean) => React.ReactNode;
+    /** Barras no topo, com a largura toda (ex: "A ver como…", "A sincronizar…"). Empurram o menu e a página para baixo. */
+    banners?: React.ReactNode;
+    /** Barra fixa por cima da página, à direita do menu (ex: título e alertas). Traz o seu próprio fundo. */
+    topBar?: React.ReactNode;
+    /**
+     * A página ocupa a altura que sobra do ecrã, sem scroll da página (ex:
+     * quadros e listas que fazem scroll por dentro, com o `Page` em `fill`).
+     * As margens são as mesmas das outras páginas.
+     */
+    fullHeight?: boolean;
+    /** Menu aberto ao entrar (ecrãs grandes). Por omissão sim; fechado fica só com os ícones. */
+    defaultOpen?: boolean;
+    /** A pessoa abriu ou fechou o menu (para a app guardar a escolha, se quiser). */
+    onOpenChange?: (open: boolean) => void;
+    labels?: Partial<AppShellLabels>;
+}
+/**
+ * A moldura da app: o menu lateral (`SideNav`) à esquerda e a página à
+ * direita, com barras opcionais no topo.
+ *
+ * Em ecrãs pequenos (< 1024px) o menu é uma gaveta, aberta pelo botão no canto,
+ * que fecha ao mudar de página.
+ *
+ * Precisa de estar dentro de um Router do react-router.
+ */
+export default function AppShell({ children, sidebarFooter, banners, topBar, fullHeight, defaultOpen, onOpenChange, labels, ...sideNav }: AppShellProps): React.JSX.Element;

package/dist/types/v1/components/layout/Page/Page.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import { type PageHeaderProps } from '../PageHeader/PageHeader';
+export interface PageProps extends PageHeaderProps {
+    /** Separadores da página (ex: `<Tabs …/>`), entre o cabeçalho e o conteúdo. */
+    tabs?: React.ReactNode;
+    /**
+     * A página ocupa a altura que sobra e o conteúdo faz scroll por dentro (ex:
+     * quadros e listas compridas). Usar com o `fullHeight` do `AppShell`.
+     */
+    fill?: boolean;
+    children: React.ReactNode;
+}
+/**
+ * Uma página da app: cabeçalho (`PageHeader`), separadores opcionais e o
+ * conteúdo, sempre com os mesmos espaços entre eles. As margens à volta vêm do
+ * `AppShell`; a página não põe as suas.
+ *
+ * **Caminho automático**: dentro do `AppShell`, numa página que está num grupo
+ * do menu, o caminho por cima do título é "grupo › página" (ex: "App & Dev ›
+ * Sprints"), com os nomes do menu. Passar `breadcrumb` substitui-o (ex: no
+ * detalhe de um registo); `breadcrumb={[]}` tira-o.
+ */
+export default function Page({ tabs, fill, children, breadcrumb, ...header }: PageProps): React.JSX.Element;