@proef/common-ui 0.0.0-stage → 2.2.1

package/dist/tokens.css

@@ -0,0 +1,121 @@
+/* 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, -xl */
+  --container-dialog-sm: 480px;
+  --container-dialog-md: 720px;
+  --container-dialog-lg: 1000px;
+  /* Acompanha o ecrã: mapa e tabela lado a lado precisam de largura, mas o texto não deve atravessar o monitor todo */
+  --container-dialog-xl: min(1600px, 95vw);
+  /* 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/index.d.ts

@@ -0,0 +1,14 @@
+export * from './legacy/exports/atoms';
+export * from './legacy/exports/molecules';
+export * from './legacy/exports/organisms';
+export * from './legacy/exports/layout';
+export * from './legacy/exports/pages';
+export * from './legacy/exports/contexts';
+export * from './legacy/exports/hooks';
+export * from './legacy/exports/ui';
+export * from './legacy/exports/types';
+export * from './legacy/exports/styles';
+export * from './legacy/exports/utils';
+export * from './legacy/exports/charts';
+export { default as Sidebar } from './legacy/components/layout/Sidebar/Sidebar';
+export * from './v1';

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

@@ -0,0 +1,11 @@
+import React from 'react';
+import { AcronymTheme } from '../../../types/themes/AcronymThemes';
+import './Acronym.scss';
+type Props = {
+    name: string;
+    acronymOnly?: boolean;
+    theme: AcronymTheme;
+};
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const Acronym: ({ name, acronymOnly, theme }: Props) => React.JSX.Element;
+export default Acronym;

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

@@ -0,0 +1,9 @@
+import React from 'react';
+import './BreadCrumb.scss';
+interface BreadCrumbProps {
+    location: string;
+    onNavigate?: (path: string) => void;
+}
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const BreadCrumb: React.FC<BreadCrumbProps>;
+export default BreadCrumb;

package/dist/types/legacy/components/atoms/Button/variants/ActionButton.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import { PropsWithChildren } from 'react';
+import { ActionButtonTheme } from '../../../../types/themes/ButtonThemes';
+import './ActionButton.scss';
+type Props = PropsWithChildren<{
+    icon?: React.ReactNode;
+    title: string;
+    theme: ActionButtonTheme;
+    onClick: () => void;
+    disabled?: boolean;
+}>;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const ActionButton: ({ icon, title, theme, onClick, disabled, }: Props) => React.JSX.Element;
+export default ActionButton;

package/dist/types/legacy/components/atoms/Button/variants/FilterButton.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import { PropsWithChildren } from 'react';
+import './FilterButton.scss';
+type Props = PropsWithChildren<{
+    title: string;
+    selected: boolean;
+    onClick: () => void;
+    disabled?: boolean;
+}>;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const FilterButton: ({ title, selected, onClick, disabled, }: Props) => React.JSX.Element;
+export default FilterButton;

package/dist/types/legacy/components/atoms/Button/variants/IconButton.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import { PropsWithChildren } from 'react';
+import { type IconeQualquer } from '../../Icone/Icone';
+import { IconButtonTheme } from '../../../../types/themes/ButtonThemes';
+import './IconButton.scss';
+type Props = PropsWithChildren<{
+    /** FontAwesome, componente lucide ou elemento ja construido. */
+    icon: IconeQualquer;
+    onClick: () => void;
+    theme: IconButtonTheme;
+    disabled?: boolean;
+    /**
+     * Nome acessivel. Um botao so com icone nao tem texto, por isso sem isto fica
+     * anunciado como "botao" por um leitor de ecra — e invisivel para testes.
+     */
+    ariaLabel?: string;
+    /** Tooltip nativa; sem valor proprio assume o `ariaLabel`. */
+    title?: string;
+}>;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const IconButton: ({ icon, onClick, theme, disabled, ariaLabel, title, }: Props) => React.JSX.Element;
+export default IconButton;

package/dist/types/legacy/components/atoms/Button/variants/MainButton.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import { PropsWithChildren } from 'react';
+import { type IconeQualquer } from '../../Icone/Icone';
+import { MainButtonTheme } from '../../../../types/themes/ButtonThemes';
+import './MainButton.scss';
+type Props = PropsWithChildren<{
+    /** FontAwesome, componente lucide ou elemento ja construido. */
+    icon: IconeQualquer;
+    title: string;
+    description?: string;
+    theme: MainButtonTheme;
+    onClick: () => void;
+    disabled?: boolean;
+}>;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const MainButton: ({ icon, title, description, theme, onClick, disabled, }: Props) => React.JSX.Element;
+export default MainButton;

package/dist/types/legacy/components/atoms/Button/variants/TabButton.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import { PropsWithChildren } from 'react';
+import { IconProp } from '@fortawesome/fontawesome-svg-core';
+import './TabButton.scss';
+type Props = PropsWithChildren<{
+    icon: IconProp;
+    title: string;
+    selected: boolean;
+    onClick: () => void;
+    disabled?: boolean;
+}>;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const TabButton: ({ icon, title, selected, onClick, disabled }: Props) => React.JSX.Element;
+export default TabButton;

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

@@ -0,0 +1,15 @@
+import React from 'react';
+import './Field.scss';
+import { IconProp } from '@fortawesome/fontawesome-svg-core';
+type Props = {
+    iconPrev?: IconProp;
+    type?: 'cui-added' | 'cui-adding' | 'cui-adding_operator_name' | 'cui-number';
+    placeholder?: string;
+    disabled: boolean;
+    readOnly: boolean;
+    value?: string;
+    onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
+};
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const Field: ({ type, placeholder, disabled, readOnly, iconPrev, value, onChange, }: Props) => React.JSX.Element;
+export default Field;

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

@@ -0,0 +1,12 @@
+import React from 'react';
+import { IconProp } from '@fortawesome/fontawesome-svg-core';
+import './IconText.scss';
+import { IconTextTheme } from '../../../types/themes/IconTextThemes';
+interface IconTextProps {
+    icon: IconProp;
+    text: string;
+    theme: IconTextTheme;
+}
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const IconText: React.FC<IconTextProps>;
+export default IconText;

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

@@ -0,0 +1,31 @@
+import React, { type ReactNode } from 'react';
+import type { IconProp } from '@fortawesome/fontawesome-svg-core';
+/**
+ * Ícone agnóstico da biblioteca de ícones.
+ *
+ * A biblioteca nasceu em FontAwesome, mas todos os portais usam lucide — e o
+ * `Sidebar` sempre aceitou componentes ao estilo lucide. Resultado: metade da
+ * API pedia `IconProp` e obrigava um portal a instalar o FontAwesome só para
+ * pôr um ícone num botão.
+ *
+ * Este componente aceita as três formas, para a API poder ser uniformizada sem
+ * partir quem já passa `IconProp`:
+ *  - `IconProp` (FontAwesome), como antes;
+ *  - um elemento React já construído (`<Play size={14} />`);
+ *  - um componente de ícone (lucide: `Play`), que recebe `size` e `className`.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
+export type IconeQualquer = IconProp | ReactNode | React.ComponentType<{
+    size?: number;
+    className?: string;
+}>;
+interface Props {
+    icone: IconeQualquer;
+    /** Só aplicado às formas que o aceitam (componente de ícone e FontAwesome). */
+    tamanho?: number;
+    cor?: string;
+    className?: string;
+}
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export default function Icone({ icone, tamanho, cor, className }: Props): React.JSX.Element | null;
+export {};

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

@@ -0,0 +1,13 @@
+import React, { ChangeEvent } from 'react';
+import './Input.scss';
+type Props = {
+    placeholder?: string;
+    onChange: (e: ChangeEvent<HTMLInputElement>) => void;
+    onBlur?: (e: ChangeEvent<HTMLInputElement>) => void;
+    type?: 'number' | 'text';
+    value?: string | number | null;
+    disabled?: boolean;
+};
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const Input: ({ placeholder, onChange, onBlur, type, value, disabled, }: Props) => React.JSX.Element;
+export default Input;

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

@@ -0,0 +1,38 @@
+import React from 'react';
+/**
+ * Campo de data e campo de hora.
+ *
+ * Deliberadamente em cima do `<input type="date|time">` do browser: o calendário
+ * nativo é acessível, traduzido e com teclado, e um calendário próprio seria
+ * centenas de linhas para ficar pior. O que a biblioteca acrescenta é o aspeto
+ * uniforme e a mesma API dos restantes campos.
+ *
+ * O valor é sempre `yyyy-mm-dd` (data) e `hh:mm` (hora) — os formatos que o
+ * input devolve, independentemente do que o browser mostra ao utilizador.
+ */
+interface PropsBase {
+    value: string;
+    onChange: (valor: string) => void;
+    disabled?: boolean;
+    /** Para associar a uma etiqueta externa. */
+    id?: string;
+}
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export interface InputDataProps extends PropsBase {
+    /** Limites, no mesmo formato do valor (yyyy-mm-dd). */
+    min?: string;
+    max?: string;
+}
+/**
+ * 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 {
+    /** Passo em segundos; 60 esconde os segundos (o default do browser). */
+    step?: number;
+}
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export declare function InputHora({ value, onChange, disabled, id, step }: InputHoraProps): React.JSX.Element;
+export default InputData;

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

@@ -0,0 +1,11 @@
+import React from 'react';
+import './Label.scss';
+import { IconProp } from '@fortawesome/fontawesome-svg-core';
+type Props = {
+    title: string;
+    type: 'cui-main_options' | 'cui-added' | 'cui-adding' | 'cui-form_title' | 'cui-choose_operator_title' | 'cui-add_operator_title' | 'cui-choose_operator_name' | 'cui-add_operator_name' | 'cui-title' | 'cui-mode' | 'cui-breadcrumb';
+    iconPrev?: IconProp;
+};
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const Label: ({ title, type, iconPrev }: Props) => React.JSX.Element;
+export default Label;

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

@@ -0,0 +1,10 @@
+import React from 'react';
+import './MultiTagPickerTag.scss';
+interface TagProps {
+    id: string;
+    label: string;
+    selected: boolean;
+    handleTagChange: (changedTo: boolean) => void;
+}
+declare const Select: React.FC<TagProps>;
+export default Select;

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

@@ -0,0 +1,15 @@
+import React from 'react';
+import './SearchSelect.scss';
+interface Option {
+    value: string;
+    label: string;
+}
+type Props = {
+    placeholder: string;
+    options: Option[];
+    option: string;
+    onChange: (value: string) => void;
+    disabled?: boolean;
+};
+declare function SearchSelect({ placeholder, options, option, disabled, onChange, }: Props): React.JSX.Element;
+export default SearchSelect;

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

@@ -0,0 +1,16 @@
+import React from 'react';
+import './Select.scss';
+interface SelectOption {
+    value: string;
+    label: string;
+}
+interface SelectProps {
+    placeholder: string;
+    options: SelectOption[];
+    value: string;
+    onChange: (value: string) => void;
+    disabled?: boolean;
+}
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const Select: React.FC<SelectProps>;
+export default Select;

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

@@ -0,0 +1,9 @@
+import React, { PropsWithChildren } from 'react';
+type Props = PropsWithChildren<{
+    spacing?: number;
+    direction: 'row' | 'column';
+    wrap: boolean;
+}>;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const Stack: ({ children, spacing, direction, wrap, }: Props) => React.JSX.Element;
+export default Stack;

package/dist/types/legacy/components/atoms/Switch/CustomSwitch.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import { CustomSwitchTheme } from '../../../types/themes/CustomSwitchThemes';
+import './CustomSwitch.scss';
+type CustomSwitchProps = {
+    label: string;
+    activated: boolean;
+    onChange: () => void;
+    theme: CustomSwitchTheme;
+};
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const CustomSwitch: React.FC<CustomSwitchProps>;
+export default CustomSwitch;

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

@@ -0,0 +1,149 @@
+import React from 'react';
+/**
+ * Stacked series over a set of shared labels (e.g. a dimension over time).
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
+export interface SerieEmpilhada {
+    labels: string[];
+    series: {
+        nome: string;
+        valores: number[];
+    }[];
+}
+/**
+ * A simple distribution: parallel arrays of labels and values.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
+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.
+ */
+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, 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, 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, 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, onClick, }: {
+    dados: Distribuicao;
+    altura?: number;
+    euros?: boolean;
+    onClick?: CliqueGrafico;
+}): React.JSX.Element;
+/**
+ * Several lines over the same labels — NOT stacked.
+ *
+ * Separate from `BarrasEmpilhadas` on purpose: two series that measure the same
+ * thing at two moments (created vs closed) must be read against each other, and
+ * 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, 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 {
+    responsavel: string;
+    otsAtivas: number;
+    percentagemForaPrazo: number;
+    valorPenalizado: number;
+}
+/**
+ * Risk-map bubbles: x = active OTs, y = % overdue, r = penalized value.
+ * The radius is normalized against the max so bubbles stay readable at any scale.
+ *
+ * Axis titles and the tooltip formatter are exposed as optional props with
+ * neutral English defaults (previously hardcoded Portuguese) so the component
+ * carries no locale of its own.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
+export declare function Bolhas({ pontos, altura, onClick, xTitle, yTitle, tooltipLabel, }: {
+    pontos: PontoRisco[];
+    altura?: number;
+    onClick?: (p: PontoRisco) => void;
+    xTitle?: string;
+    yTitle?: string;
+    tooltipLabel?: (p: PontoRisco) => string;
+}): React.JSX.Element;

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

@@ -0,0 +1,35 @@
+import React from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export interface LauncherApp {
+    /** Título da app (linha principal). */
+    title: string;
+    /** Subtítulo opcional. */
+    description?: string;
+    /** Ícone (ReactNode) — a app passa o seu (ex: <FontAwesomeIcon .../>). */
+    icon?: React.ReactNode;
+    onClick: () => void;
+    /** Tooltip opcional; default = description || title. */
+    title2?: string;
+}
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export interface AppLauncherProps {
+    apps: LauncherApp[];
+    /** Cabeçalho (ex: <>Bem-vindo <strong>Vinst</strong></>). O <strong> fica turquesa. */
+    heading?: React.ReactNode;
+    /** Texto quando não há apps. */
+    emptyLabel?: string;
+    /** Fundo: cor sólida (default) ou imagem. */
+    bgColor?: string;
+    bgImage?: string | null;
+    accentColor1?: string;
+    accentColor2?: string;
+    /** Altura da nav do TopNavLayout para o cálculo de min-height. */
+    navHeight?: string;
+}
+/**
+ * Ecrã de launcher de aplicações (grid centrado de cartões em vidro sobre fundo
+ * escuro). Feito para viver dentro do <main> do TopNavLayout — cancela o padding
+ * dele com margens negativas para ficar full-bleed. Ícones vêm da app (ReactNode).
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
+export default function AppLauncher({ apps, heading, emptyLabel, bgColor, bgImage, accentColor1, accentColor2, navHeight, }: AppLauncherProps): React.JSX.Element;

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

@@ -0,0 +1,8 @@
+import React from 'react';
+import './Error.scss';
+interface ErrorProps {
+    messages: string[];
+}
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const Error: React.FC<ErrorProps>;
+export default Error;

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

@@ -0,0 +1,11 @@
+import React from 'react';
+import './Footer.scss';
+export interface FooterProps {
+    /** Nome do responsável pelo tratamento de dados (aviso RGPD). */
+    companyName?: string;
+    /** Email de contacto para exercer direitos RGPD. */
+    contactEmail?: string;
+}
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+declare const Footer: React.FC<FooterProps>;
+export default Footer;