@nextelco/common-ui 2.1.98 → 2.1.99

package/dist/types/{components → legacy/components}/organisms/Profile/Profile.d.ts

@@ -7,5 +7,6 @@ type Props = {
     notifications?: ReactNode;
     logoutLabel?: string;
 };
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 declare const Profile: ({ user, handleLogout, notifications, logoutLabel }: Props) => React.JSX.Element;
 export default Profile;

package/dist/types/{components → legacy/components}/organisms/RoleGuard/RoleGuard.d.ts

@@ -10,6 +10,7 @@ import React, { type ReactNode } from 'react';
  *
  * As roles vêm no ACCESS token da API, não no id token — é o erro mais comum
  * nesta integração, e a razão de `obterToken` dever pedir o scope da API.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export interface RoleGuardProps {
     /** Roles com acesso. Lista vazia = qualquer autenticado entra. */
@@ -27,6 +28,10 @@ export interface RoleGuardProps {
     semPermissao: ReactNode;
     children: ReactNode;
 }
-/** Lê a claim `roles` de um JWT, sem validar a assinatura (quem valida é a API). */
+/**
+ * Lê a claim `roles` de um JWT, sem validar a assinatura (quem valida é a API).
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
 export declare function lerRolesDoToken(accessToken: string): string[];
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export default function RoleGuard({ rolesPermitidas, temSessao, aAutenticar, obterToken, onPrecisaInteracao, semSessao, aCarregar, semPermissao, children, }: RoleGuardProps): React.JSX.Element;

package/dist/types/{components → legacy/components}/organisms/Selector/Selector.d.ts

@@ -15,5 +15,6 @@ type SelectorProps<T extends SelectableElement> = {
     fetcher: Fetcher;
     working?: boolean;
 };
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare const Selector: <T extends SelectableElement>({ title, icon, onClose, onConfirm, initiallySelected, blocked, fetcher, single, working, onDisabled, }: SelectorProps<T>) => React.JSX.Element;
 export {};

package/dist/types/{components → legacy/components}/organisms/StatusMatrix/StatusMatrix.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface StatusMatrixRow {
     id: string;
     label: string;
@@ -7,17 +8,20 @@ export interface StatusMatrixRow {
     /** Texto pequeno à direita do rótulo (ex: "12/40"). */
     sublabel?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface StatusMatrixColumn {
     id: string;
     label: string;
     /** Faixa por cima das colunas consecutivas com o mesmo grupo (ex: "Ramal 1"). */
     group?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface StatusMatrixStatus {
     label: string;
     /** Cor da célula (CSS). */
     color: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface StatusMatrixCell {
     /** Chave em `statuses`. Sem estado = célula vazia. */
     status?: string;
@@ -27,6 +31,7 @@ export interface StatusMatrixCell {
     /** Mostra um ponto de aviso no canto da célula. */
     warning?: boolean;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface StatusMatrixProps {
     rows: StatusMatrixRow[];
     columns: StatusMatrixColumn[];
@@ -45,4 +50,5 @@ export interface StatusMatrixProps {
     /** Altura (px) do cabeçalho das colunas (rótulos verticais). Omisso = automática pelo rótulo mais comprido (64–260). */
     columnHeaderHeight?: number;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export default function StatusMatrix({ rows, columns, statuses, cell, cellSize, labelWidth, corner, showLegend, onCellClick, emptyText, className, columnHeaderHeight, }: StatusMatrixProps): React.JSX.Element;

package/dist/types/{components → legacy/components}/ui/Avisos.d.ts

@@ -1,5 +1,7 @@
 import React, { type ReactNode } from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export type TipoAviso = 'sucesso' | 'erro' | 'aviso' | 'info';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface OpcoesAviso {
     /** Botão no aviso (ex: "Tentar de novo", "Desfazer"). */
     acao?: {
@@ -9,6 +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. */
 export interface AvisosApi {
     sucesso: (mensagem: ReactNode, opcoes?: OpcoesAviso) => number;
     erro: (mensagem: ReactNode, opcoes?: OpcoesAviso) => number;
@@ -16,6 +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. */
 export interface AvisosProviderProps {
     children: ReactNode;
     /** Rótulo do botão de fechar (leitores de ecrã). */
@@ -29,7 +33,11 @@ export interface AvisosProviderProps {
  * 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.
  */
 export declare function AvisosProvider({ children, rotuloFechar, maximo }: AvisosProviderProps): React.JSX.Element;
-/** Avisos da app. Tem de estar dentro de um `AvisosProvider`. */
+/**
+ * Avisos da app. Tem de estar dentro de um `AvisosProvider`.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
 export declare function useAvisos(): AvisosApi;

package/dist/types/{components → legacy/components}/ui/BarraAcoes.d.ts

@@ -1,4 +1,5 @@
 import React, { type ReactNode } from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface BarraAcoesProps {
     /** Ações principais, à direita (ex: "Guardar"). A principal vai em último. */
     children: ReactNode;
@@ -13,5 +14,6 @@ export interface BarraAcoesProps {
  * Fixa ao fundo para "Guardar" estar sempre à vista: numa página longa o botão
  * no topo desaparece ao descer, e os botões repetidos em cima e em baixo
  * acabavam com textos diferentes.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export default function BarraAcoes({ children, esquerda, fixa }: BarraAcoesProps): React.JSX.Element;

package/dist/types/{components → legacy/components}/ui/CabecalhoPagina.d.ts

@@ -1,11 +1,15 @@
 import React, { type ReactNode } from 'react';
-/** Um nível do caminho por cima do título. */
+/**
+ * Um nível do caminho por cima do título.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
 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. */
 export interface CabecalhoPaginaProps {
     titulo: ReactNode;
     descricao?: ReactNode;
@@ -28,5 +32,6 @@ export interface CabecalhoPaginaProps {
  * 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;

package/dist/types/{components → legacy/components}/ui/Confirmacao.d.ts

@@ -1,4 +1,5 @@
 import React, { type ReactNode } from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface ConfirmacaoProps {
     aberto: boolean;
     titulo: ReactNode;
@@ -25,5 +26,6 @@ export interface ConfirmacaoProps {
  * "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;

package/dist/types/{components → legacy/components}/ui/FaixaAviso.d.ts

@@ -1,5 +1,7 @@
 import React, { type ReactNode } from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export type TomFaixa = 'aviso' | 'info' | 'erro';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface FaixaAvisoProps {
     children: ReactNode;
     tom?: TomFaixa;
@@ -16,5 +18,6 @@ export interface FaixaAvisoProps {
  * 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.
  */
 export default function FaixaAviso({ children, tom, acao, icone }: FaixaAvisoProps): React.JSX.Element;

package/dist/types/{components → legacy/components}/ui/Passos.d.ts

@@ -1,4 +1,5 @@
 import React, { type ReactNode } from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface Passo<T extends string> {
     id: T;
     rotulo: ReactNode;
@@ -7,6 +8,7 @@ export interface Passo<T extends string> {
     /** Passo com erros por corrigir. */
     erro?: boolean;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface PassosProps<T extends string> {
     passos: Passo<T>[];
     atual: T;
@@ -24,5 +26,6 @@ export interface PassosProps<T extends string> {
  *
  * Mostra onde se está, o que já está feito e onde há erros — o que um
  * formulário de seis secções seguidas não diz.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export default function Passos<T extends string>({ passos, atual, onMudar, livre, rotulo }: PassosProps<T>): React.JSX.Element;

package/dist/types/{components → legacy/components}/ui/Separadores.d.ts

@@ -1,4 +1,5 @@
 import React, { type ReactNode } from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface Separador<T extends string> {
     id: T;
     rotulo: ReactNode;
@@ -6,6 +7,7 @@ export interface Separador<T extends string> {
     contagem?: number;
     desativado?: boolean;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface SeparadoresProps<T extends string> {
     itens: Separador<T>[];
     ativo: T;
@@ -19,5 +21,6 @@ export interface SeparadoresProps<T extends string> {
  * 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.
  */
 export default function Separadores<T extends string>({ itens, ativo, onMudar, rotulo }: SeparadoresProps<T>): React.JSX.Element;

package/dist/types/{components → legacy/components}/ui/TextoAuto.d.ts

@@ -1,4 +1,5 @@
 import React, { type TextareaHTMLAttributes } from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export type TextoAutoProps = Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'rows'> & {
     /** Altura mínima, em linhas. */
     minLinhas?: number;
@@ -11,6 +12,7 @@ export type TextoAutoProps = Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, '
  *
  * Vinda do Auditorias IT (comentários e descrições), onde uma textarea fixa ou
  * cortava o texto ou ocupava meio ecrã vazia.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 declare const TextoAuto: React.ForwardRefExoticComponent<Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "rows"> & {
     /** Altura mínima, em linhas. */

package/dist/types/{components → legacy/components}/ui/Ui.d.ts

@@ -1,20 +1,28 @@
 import React, { type ReactNode } from 'react';
 /** Visual UI primitives (proef design system). Prefer these over repeating classes. */
-/** SLA status accepted by BadgeSla. */
+/**
+ * SLA status accepted by BadgeSla.
+ * @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;
-/** Colour-bordered group — the overview sections in the prototype. */
+/**
+ * Colour-bordered group — the overview sections in the prototype.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
 export declare function SectionGroup({ title, tone, children, }: {
     title: string;
     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;
@@ -51,12 +59,17 @@ export declare function Kpi({ label, value, tone, delta, onClick, bgTint, active
     /** 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;
-/** SLA badge — picks the tone and label from `status`. Labels overridable via `labels`. */
+/**
+ * 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.
+ */
 export declare function BadgeSla({ status, labels }: {
     status: StatusSla;
     labels?: {
@@ -65,9 +78,11 @@ export declare function BadgeSla({ status, labels }: {
         incumprido?: string;
     };
 }): React.JSX.Element;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare function ChipEstadoInterno({ estado }: {
     estado: string | null;
 }): React.JSX.Element;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare function Btn({ children, onClick, variant, active, disabled, title, type, }: {
     children: ReactNode;
     onClick?: () => void;
@@ -77,7 +92,10 @@ export declare function Btn({ children, onClick, variant, active, disabled, titl
     title?: string;
     type?: 'button' | 'submit';
 }): React.JSX.Element;
-/** Mutually exclusive button group (granularity, dimension…). */
+/**
+ * Mutually exclusive button group (granularity, dimension…).
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
 export declare function BtnGroup<T extends string>({ value, options, onChange, label, }: {
     value: T;
     options: {
@@ -88,6 +106,7 @@ export declare function BtnGroup<T extends string>({ value, options, onChange, l
     /** Rótulo opcional à esquerda (ex: "Situação"), com espaçamento próprio. */
     label?: string;
 }): React.JSX.Element;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare function Estado({ carregando, erro, vazio, labels, }: {
     carregando?: boolean;
     erro?: boolean;
@@ -98,6 +117,7 @@ export declare function Estado({ carregando, erro, vazio, labels, }: {
         empty?: string;
     };
 }): React.JSX.Element | null;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare function Modal({ open, onClose, title, children, wide }: {
     open: boolean;
     onClose: () => void;
@@ -105,7 +125,10 @@ export declare function Modal({ open, onClose, title, children, wide }: {
     children: ReactNode;
     wide?: boolean;
 }): React.JSX.Element | null;
-/** Rótulo pequeno em maiúsculas por cima do campo. */
+/**
+ * Rótulo pequeno em maiúsculas por cima do campo.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
 export declare function Campo({ label, children, className }: {
     label: string;
     children: ReactNode;
@@ -116,6 +139,7 @@ export declare function Campo({ label, children, className }: {
  *
  * A opção vazia é obrigatória e não opcional: sem ela não há como desfazer uma
  * escolha, e o utilizador fica preso ao primeiro valor que carregou.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export declare function CampoSelect({ label, value, options, onChange, placeholderVazio, disabled, className, }: {
     label: string;
@@ -135,6 +159,7 @@ export declare function CampoSelect({ label, value, options, onChange, placehold
  * Deliberadamente NÃO pesquisa a cada tecla: sobre dezenas de milhares de
  * registos isso seria um pedido por letra. Confirma-se com Enter ou ao sair do
  * campo.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export declare function CampoPesquisa({ label, valorInicial, onConfirmar, placeholder, className, }: {
     label: string;
@@ -143,16 +168,23 @@ export declare function CampoPesquisa({ label, valorInicial, onConfirmar, placeh
     placeholder?: string;
     className?: string;
 }): React.JSX.Element;
-/** Caixa de interruptor com rótulo à direita, alinhada com os campos ao lado. */
+/**
+ * Caixa de interruptor com rótulo à direita, alinhada com os campos ao lado.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
 export declare function CampoInterruptor({ label, checked, onChange, }: {
     label: string;
     checked: boolean;
     onChange: (v: boolean) => void;
 }): React.JSX.Element;
-/** Barra onde os campos de filtro assentam. */
+/**
+ * Barra onde os campos de filtro assentam.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
 export declare function BarraFiltros({ children }: {
     children: ReactNode;
 }): React.JSX.Element;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export type SeveridadeAlerta = 'critico' | 'grave' | 'atencao' | 'info';
 /**
  * Linha de uma lista de alertas.
@@ -160,6 +192,7 @@ export type SeveridadeAlerta = 'critico' | 'grave' | 'atencao' | 'info';
  * A severidade está na barra lateral colorida e não no fundo: uma lista de
  * cinquenta linhas com fundos saturados é ilegível, e o que se quer é poder
  * varrer a coluna da esquerda e saber onde parar.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export declare function LinhaAlerta({ severidade, icone, titulo, detalhe, referencia, onReferenciaClick, quando, }: {
     severidade: SeveridadeAlerta;
@@ -178,6 +211,7 @@ export declare function LinhaAlerta({ severidade, icone, titulo, detalhe, refere
  * origens, metade dos campos costuma não existir, e uma coluna de travessões
  * não informa ninguém. `mostrarVazios` repõe-os quando a ausência é o que
  * interessa ver.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export declare function ListaCampos({ campos, colunas, mostrarVazios, }: {
     campos: {

package/dist/types/{constants → legacy/constants}/FontWeight.d.ts

@@ -1,3 +1,4 @@
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare enum FontWeight {
     LIGHT = "light",
     MEDIUM = "medium",

package/dist/types/{contexts → legacy/contexts}/apiContext.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import { AxiosInstance } from 'axios';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare const ApiProvider: React.FC<{
     children: React.ReactNode;
     baseURL: string;

package/dist/types/{contexts → legacy/contexts}/authContext.d.ts

@@ -24,6 +24,8 @@ export interface AuthProviderProps {
     };
     allowedRoles: string[];
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare const AuthProvider: React.FC<AuthProviderProps>;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare const useAuth: () => AuthContextProps;
 export {};

package/dist/types/{contexts → legacy/contexts}/socketContext.d.ts

@@ -9,6 +9,8 @@ interface SocketProviderProps {
         query?: Record<string, string>;
     };
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare const SocketProvider: React.FC<SocketProviderProps>;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare const useSocket: () => Socket | null;
 export {};

package/dist/types/{exports → legacy/exports}/hooks.d.ts

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

package/dist/types/{exports → legacy/exports}/molecules.d.ts

@@ -1,7 +1,8 @@
 export { default as Modal } from '../components/molecules/Modal/Modal';
 export type { ModalSize } from '../components/molecules/Modal/Modal';
 export { default as SidebarDrawer } from '../components/molecules/Sidebar/Sidebar';
-export { default as MultiTagPicker, Option, } from '../components/molecules/MultiTagPicker/MultiTagPicker';
+export { default as MultiTagPicker } from '../components/molecules/MultiTagPicker/MultiTagPicker';
+export type { Option } from '../components/molecules/MultiTagPicker/MultiTagPicker';
 export { default as ConfirmModal } from '../components/molecules/ConfirmModal/ConfirmModal';
 export { default as UserAvatar } from '../components/molecules/UserAvatar/UserAvatar';
 export { default as PhotoAvatar } from '../components/molecules/PhotoAvatar/PhotoAvatar';

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

@@ -0,0 +1,7 @@
+export type { LoggedUser } from '../types/LoggedUser';
+export type { Menu, Submenu } from '../types/SidebarMenu';
+export type { Fetcher } from '../types/Fetcher';
+export type { IconTextTheme } from '../types/themes/IconTextThemes';
+export type { ActionButtonTheme, IconButtonTheme, MainButtonTheme, } from '../types/themes/ButtonThemes';
+export type { AcronymTheme } from '../types/themes/AcronymThemes';
+export type { CustomSwitchTheme } from '../types/themes/CustomSwitchThemes';

package/dist/types/{hooks → legacy/hooks}/useApi.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 type AllowedMethods = 'get' | 'post' | 'put' | 'delete' | 'patch';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface RequestOptions {
     method: AllowedMethods;
     url: string;
@@ -9,6 +10,7 @@ export interface RequestOptions {
     timeout?: number;
     signal?: AbortSignal;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare const useApi: () => {
     request: (options: RequestOptions) => Promise<any | null>;
     errors: React.ReactNode;

package/dist/types/{hooks → legacy/hooks}/useTheme.d.ts

@@ -1,3 +1,4 @@
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export type Theme = 'light' | 'dark' | 'system';
 /**
  * Gestor de tema light/dark/system para o `Sidebar`/`Layout` do common-ui.
@@ -6,6 +7,7 @@ export type Theme = 'light' | 'dark' | 'system';
  *
  *   const { theme, setTheme } = useTheme()
  *   <Layout theme={theme} onThemeChange={setTheme} ... />
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export declare function useTheme(): {
     theme: Theme;

package/dist/types/{pages → legacy/pages}/Error/ErrorPage.d.ts

@@ -11,5 +11,6 @@ interface ErrorProps {
      */
     clientId?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 declare const ErrorPage: React.FC<ErrorProps>;
 export default ErrorPage;

package/dist/types/{pages → legacy/pages}/Loading/Loading.d.ts

@@ -3,5 +3,6 @@ import './Loading.scss';
 type Props = {
     logo?: string;
 };
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 declare const LoadingPage: ({ logo }: Props) => React.JSX.Element;
 export default LoadingPage;

package/dist/types/{pages → legacy/pages}/Login/LoginScreen.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface LoginScreenProps {
     /** Título da app (ex: nome do portal). */
     appTitle?: string;
@@ -36,5 +37,6 @@ export interface LoginScreenProps {
  * Ecrã de login partilhado (design system proef): fundo navy, marca "proef",
  * título/subtítulo da app e botão de entrar. Agnóstico ao provider — a app passa
  * `onSignIn` (MSAL/Keycloak/…). Requer o CSS do common-ui.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export default function LoginScreen({ appTitle, subtitle, onSignIn, signInLabel, companyLabel, logo, error, topoDireita, acentos, }: LoginScreenProps): React.JSX.Element;

package/dist/types/{pages → legacy/pages}/NotFound/NotFound.d.ts

@@ -3,5 +3,6 @@ import './NotFound.scss';
 interface NotFoundProps {
     handleHome: () => void;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 declare const NotFound: React.FC<NotFoundProps>;
 export default NotFound;

package/dist/types/legacy/styles/utils/utils.d.ts

@@ -0,0 +1,2 @@
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export declare const getCSSVariable: (variable: string) => string;

package/dist/types/{types → legacy/types}/Fetcher.d.ts

@@ -1,3 +1,4 @@
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface Fetcher {
     endpoint: string;
     params?: Record<string, unknown>;

package/dist/types/{types → legacy/types}/LoggedUser.d.ts

@@ -1,3 +1,4 @@
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export type LoggedUser = {
     id: string;
     name: string;

package/dist/types/{types → legacy/types}/SidebarMenu.d.ts

@@ -1,9 +1,11 @@
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface Submenu {
     name: string;
     path: string;
     external: boolean;
     icon?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface Menu {
     name: string;
     submenus: Submenu[];

package/dist/types/legacy/types/themes/AcronymThemes.d.ts

@@ -0,0 +1,4 @@
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export interface AcronymTheme {
+    mode: 'dark' | 'light';
+}

package/dist/types/{types → legacy/types}/themes/ButtonThemes.d.ts

@@ -1,4 +1,5 @@
 import { FontWeight } from '../../constants/FontWeight';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface ActionButtonTheme {
     backgroundColor: string;
     fontColor: string;
@@ -7,11 +8,13 @@ export interface ActionButtonTheme {
     hoverBackgroundColor?: string;
     size: 'default' | 'compact' | 'large';
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface IconButtonTheme {
     backgroundColor: string;
     iconColor: string;
     size: 'default' | 'compact' | 'large' | 'ultra-compact';
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface MainButtonTheme {
     backgroundColor: string;
     color: string;

package/dist/types/legacy/types/themes/CustomSwitchThemes.d.ts

@@ -0,0 +1,4 @@
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export interface CustomSwitchTheme {
+    size: 'default' | 'compact' | 'large';
+}

package/dist/types/{types → legacy/types}/themes/IconTextThemes.d.ts

@@ -1,4 +1,5 @@
 import { FontWeight } from '../../constants/FontWeight';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface IconTextTheme {
     color: string;
     fontWeight?: FontWeight;

package/dist/types/legacy/utils/stringUtils.d.ts

@@ -0,0 +1,6 @@
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export declare function getAcronym(str: string): string;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export declare function getFirstAndLastName(str: string): string;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
+export declare function partialMatchWithUsername(search: string, username: string): boolean;

package/dist/types/v1/capabilities/documents/QRScanning/scanQRCodes.d.ts

@@ -0,0 +1,25 @@
+export interface ScanQRCodesOptions {
+    /**
+     * Continuar a procurar até um código satisfazer esta condição (ex: ser o QR
+     * de uma fatura). Um documento pode ter vários QR codes e o primeiro a ser
+     * lido é arbitrário. Por omissão, pára no primeiro código encontrado.
+     */
+    until?: (code: string) => boolean;
+}
+/**
+ * Indica onde está o `zxing_reader.wasm` servido pela app. Chamar uma vez no
+ * arranque, antes da primeira leitura. Sem isto, o ficheiro é descarregado da
+ * CDN jsDelivr (pode ser bloqueado por redes ou políticas de segurança).
+ */
+export declare function configureQRScanner(options: {
+    wasmUrl: string;
+}): void;
+/**
+ * Lê os QR codes de uma imagem ou PDF (1.ª página).
+ *
+ * Devolve o texto de cada código encontrado, sem repetidos, pela ordem em que
+ * foram lidos; vazio se não houver nenhum ou se o ficheiro não se puder ler.
+ * Depois de encontrar o que procura, faz ainda uma passagem para recolher os
+ * outros códigos da página (ex: QR do banco ao lado do QR fiscal).
+ */
+export declare function scanQRCodes(file: File, options?: ScanQRCodesOptions): Promise<string[]>;