@nextelco/common-ui 2.1.98 → 2.1.100

package/dist/types/{components → legacy/components}/charts/Charts.d.ts

@@ -1,5 +1,8 @@
 import React from 'react';
-/** Stacked series over a set of shared labels (e.g. a dimension over time). */
+/**
+ * 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: {
@@ -7,31 +10,48 @@ export interface SerieEmpilhada {
         valores: number[];
     }[];
 }
-/** A simple distribution: parallel arrays of labels and values. */
+/**
+ * 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[];
 }
-/** Categorical palette. Stable order so the same dimension always maps to the same color. */
+/**
+ * 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;
-/** Stacked bars for a dimension over time. */
+/**
+ * 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 }: {
     serie: SerieEmpilhada;
     altura?: number;
 }): React.JSX.Element;
-/** Horizontal bars of a distribution (top N). */
+/**
+ * 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 }: {
     dados: Distribuicao;
     altura?: number;
     limite?: number;
 }): React.JSX.Element;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare function Anel({ dados, altura, cores }: {
     dados: Distribuicao;
     altura?: number;
     cores?: string[];
 }): React.JSX.Element;
-/** Simple line chart — optionally formats values as currency. */
+/**
+ * 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 }: {
     dados: Distribuicao;
     altura?: number;
@@ -43,12 +63,14 @@ export declare function Linha({ dados, altura, euros: emEuros }: {
  * 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, }: {
     serie: SerieEmpilhada;
     altura?: number;
     area?: boolean;
 }): React.JSX.Element;
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface PontoRisco {
     responsavel: string;
     otsAtivas: number;
@@ -62,6 +84,7 @@ export interface PontoRisco {
  * 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[];

package/dist/types/{components → legacy/components}/layout/AppLauncher/AppLauncher.d.ts

@@ -1,4 +1,5 @@
 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;
@@ -10,6 +11,7 @@ export interface LauncherApp {
     /** 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. */
@@ -28,5 +30,6 @@ export interface AppLauncherProps {
  * 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/{components → legacy/components}/layout/Error/Error.d.ts

@@ -3,5 +3,6 @@ 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/{components → legacy/components}/layout/Footer/Footer.d.ts

@@ -6,5 +6,6 @@ export interface FooterProps {
     /** 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;

package/dist/types/{components → legacy/components}/layout/Header/Header.d.ts

@@ -11,5 +11,6 @@ type Props = {
     handleHome: () => void;
     background?: string;
 };
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 declare const Header: ({ title, subTitle, icon, sideBar, handleSideBar, profile, handleHome, background, }: Props) => React.JSX.Element;
 export default Header;

package/dist/types/{components → legacy/components}/layout/Layout/Layout.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import { SidebarMenuItem, SidebarLanguage, SidebarTheme } from '../Sidebar/Sidebar';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface LayoutProps {
     children: React.ReactNode;
     menus: SidebarMenuItem[];
@@ -42,5 +43,6 @@ export interface LayoutProps {
      */
     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;
 export default Layout;

package/dist/types/{components → legacy/components}/layout/Sidebar/Sidebar.d.ts

@@ -1,9 +1,12 @@
 import React from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export type SidebarTheme = 'light' | 'dark' | 'system';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface SidebarLanguage {
     code: string;
     label: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface SidebarMenuItem {
     to: string;
     icon: React.ComponentType<{
@@ -22,6 +25,7 @@ export interface SidebarMenuItem {
      */
     external?: boolean;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface SidebarProps {
     isOpen?: boolean;
     setIsOpen?: (isOpen: boolean) => void;
@@ -60,5 +64,6 @@ export interface SidebarProps {
     /** 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;
 export default Sidebar;

package/dist/types/{components → legacy/components}/layout/Spinner/Spinner.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
 import './Spinner.scss';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 declare const Spinner: React.FC;
 export default Spinner;

package/dist/types/{components → legacy/components}/layout/TopBar/TopBar.d.ts

@@ -1,8 +1,10 @@
 import React from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface TopBarProps {
     searchPlaceholder?: string;
     onSearch?: (value: string) => void;
     right?: React.ReactNode;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 declare const TopBar: ({ searchPlaceholder, onSearch, right }: TopBarProps) => React.JSX.Element;
 export default TopBar;

package/dist/types/{components → legacy/components}/layout/TopNavLayout/TopNavLayout.d.ts

@@ -1,10 +1,12 @@
 import React from 'react';
 import type { SidebarLanguage, SidebarTheme } from '../Sidebar/Sidebar';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface TopNavItem {
     to: string;
     label: string;
     end?: boolean;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface TopNavLayoutProps {
     children: React.ReactNode;
     menus: TopNavItem[];
@@ -35,6 +37,7 @@ export interface TopNavLayoutProps {
  * com muitas secções de topo. Alternativa ao `Layout` (sidebar). Parametrizado:
  * `menus` (tabs), marca, avatar/logout e selectores de idioma/tema à direita.
  * Requer o CSS do common-ui + react-router.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 declare const TopNavLayout: ({ children, menus, appTitle, appSubtitle, logo, avatar, userName, onLogout, logoutLabel, languages, currentLang, onLanguageChange, theme, onThemeChange, themeLabels, maxWidth, }: TopNavLayoutProps) => React.JSX.Element;
 export default TopNavLayout;

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

@@ -6,6 +6,7 @@ import React, { type ReactNode } from 'react';
  * Não é um gráfico: não traz eixos, escalas nem biblioteca de charts. A barra é
  * proporcional ao maior valor da lista, que é o que se quer para comparar
  * grandezas entre linhas.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export interface LinhaBarra {
     chave: string;
@@ -14,6 +15,7 @@ export interface LinhaBarra {
     /** O que aparece à direita (ex: "3h20"). Sem isto mostra o número cru. */
     texto?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface BarraValorProps {
     linhas: LinhaBarra[];
     /** Máximo da escala. Sem isto usa o maior valor da lista. */
@@ -22,4 +24,5 @@ export interface BarraValorProps {
     cor?: string;
     vazio?: ReactNode;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export default function BarraValor({ linhas, maximo, cor, vazio, }: BarraValorProps): React.JSX.Element;

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

@@ -1,8 +1,10 @@
 import React from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface ColumnPickerItem {
     key: string;
     label: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface ColumnPickerLabels {
     /** Texto do botão (escondido em ecrãs estreitos — a contagem fica sempre). */
     title: string;
@@ -36,6 +38,7 @@ interface Props {
  *
  * As colunas escondidas continuam listadas, para poderem ser reordenadas antes de
  * 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;
 /**
@@ -45,11 +48,15 @@ export default function ColumnPicker({ columns, hidden, onHiddenChange, order, o
  *
  * É esta lista (com as escondidas incluídas) que o `ColumnPicker` recebe: uma coluna que
  * deixasse de ser listada por estar escondida não tinha como voltar.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export declare function orderColumns<C extends {
     key: string;
 }>(columns: C[], order: string[]): C[];
-/** `orderColumns` + remoção das escondidas. É o que se passa à tabela. */
+/**
+ * `orderColumns` + remoção das escondidas. É o que se passa à tabela.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
 export declare function applyColumnLayout<C extends {
     key: string;
 }>(columns: C[], order: string[], hidden: Set<string>): C[];

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

@@ -1,5 +1,6 @@
 import React, { ReactNode } from 'react';
 import './ConfirmModal.scss';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 interface ConfirmModal {
     title: string;
     children: ReactNode;
@@ -7,5 +8,6 @@ interface ConfirmModal {
     handleConfirm: () => void;
     working: boolean;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 declare function ConfirmModal({ title, children, handleCancel, handleConfirm, working, }: ConfirmModal): React.JSX.Element;
 export default ConfirmModal;

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

@@ -1,4 +1,5 @@
 import React from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface DataTableColumn<T> {
     key: string;
     label: string;
@@ -61,6 +62,7 @@ export interface DataTableColumn<T> {
  * Ordenação, filtros e agrupamento do cabeçalho vivem dentro da tabela. Quem está por fora
  * (ex: exportar para Excel, guardar uma vista) precisa deles — daí este handle, preenchido
  * em `viewRef`.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export interface DataTableView<T> {
     /** Aplica ordenação + filtros de coluna a qualquer lista (ex: ao dataset completo). */
@@ -82,6 +84,7 @@ export interface DataTableView<T> {
 /**
  * O que uma vista guardada leva da tabela. Sets viram arrays porque isto é serializado
  * para JSON.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export interface DataTableEstado {
     columnFilters?: Record<string, string[]>;
@@ -94,6 +97,7 @@ export interface DataTableEstado {
     /** Colunas por que se agrupa, pela ordem dos níveis. */
     groupBy?: string[];
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface DataTableLabels {
     /** {count} é substituído pelo total (após filtros). */
     results: string;
@@ -238,6 +242,7 @@ interface DataTableProps<T> {
  * dataPt(...)` → "14/08/2026"), e `new Date("14/08/2026")` devolve `Invalid Date` — ou, pior,
  * lê "06/03/2026" como 3 de junho, à americana. Daí o parse explícito de dd/mm/aaaa antes do
  * fallback para o `Date` nativo (que trata do ISO).
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export declare function timestampDeData(v: unknown): number;
 /**
@@ -263,6 +268,7 @@ export declare function pesquisaCuringa(q: string): (v: string) => boolean;
  *
  * Com paginação de servidor, passa também `allData`/`onDataNeeded`: sem o dataset completo,
  * 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, 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 {};

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

@@ -1,4 +1,5 @@
 import React from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface FileDropzoneLabels {
     /** Texto principal (ex: "Arraste os ficheiros para aqui ou clique para escolher"). */
     title: string;
@@ -9,6 +10,7 @@ export interface FileDropzoneLabels {
     /** Mostrado quando há ficheiros rejeitados pela extensão. {n} = quantidade. */
     rejected?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface FileDropzoneProps {
     /** Extensões aceites, ex: ".xlsx" ou ".xlsx,.xls". */
     accept?: string;
@@ -19,4 +21,5 @@ export interface FileDropzoneProps {
     labels: FileDropzoneLabels;
     className?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export default function FileDropzone({ accept, multiple, disabled, loading, onFiles, labels, className }: FileDropzoneProps): React.JSX.Element;

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

@@ -13,11 +13,13 @@ import type { SidebarLanguage } from '../../layout/Sidebar/Sidebar';
  * Estende-o em vez de criar um tipo paralelo: a mesma lista serve a sidebar e
  * este seletor, e duas formas do mesmo conceito acabariam a divergir.
  * `name` é o nome por extenso, que só este mostra.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export interface Idioma extends SidebarLanguage {
     /** Nome por extenso na lista (ex: 'Português'). Sem isto usa-se o `label`. */
     name?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface LanguageSwitcherProps {
     idiomas: Idioma[];
     /** Código do idioma activo. Aceita 'pt-PT' — compara pelo prefixo. */
@@ -27,4 +29,5 @@ export interface LanguageSwitcherProps {
     variant?: 'dark' | 'light' | 'pill';
     compact?: boolean;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export default function LanguageSwitcher({ idiomas, actual, onEscolher, variant, compact, }: LanguageSwitcherProps): React.JSX.Element;

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

@@ -6,8 +6,10 @@ import './Modal.scss';
  * Sem `size` o modal mede-se pelo conteúdo (entre `min-width: 500px` e
  * `max-width: 90%`), que é o comportamento histórico — não se define um
  * default para não mexer na aparência dos portais que já o usam.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export type ModalSize = 'sm' | 'md' | 'lg' | 'xl';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 declare const Modal: React.ForwardRefExoticComponent<{
     title: string;
     modalOnly?: boolean;

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

@@ -1,5 +1,6 @@
 import React from 'react';
 import './MultiTagPicker.scss';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface Option {
     id: string;
     label: string;
@@ -19,5 +20,6 @@ export interface MultiTagPickerProps {
     handleAddItem: (item: Option) => void;
     loadMore?: () => void;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 declare const MultiTagPicker: React.FC<MultiTagPickerProps>;
 export default MultiTagPicker;

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

@@ -26,6 +26,7 @@ interface Props {
  * Avatar com a foto real do MS Graph. Fallback: iniciais (UserAvatar).
  * Token: via `getToken` (recomendado) ou, em alternativa, via `useMsal` interno.
  * Peers: @azure/msal-react, @azure/msal-browser.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export default function PhotoAvatar({ oid, name, email, className, showCard, getToken }: Props): React.JSX.Element;
 export {};

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

@@ -9,6 +9,7 @@ import React, { type ReactNode } from 'react';
  *
  * Fecha ao clicar fora e com Escape. Parece detalhe, mas dentro de um modal uma
  * lista que não fecha tapa o resto do formulário.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export interface OpcaoPesquisa {
     valor: string;
@@ -16,6 +17,7 @@ export interface OpcaoPesquisa {
     /** Segunda linha: contexto que distingue homónimos. Também é pesquisável. */
     contexto?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface SeletorPesquisaProps {
     opcoes: OpcaoPesquisa[];
     /** Opção escolhida (`valor`), ou null. */
@@ -42,4 +44,5 @@ export interface SeletorPesquisaProps {
     /** Ícone opcional à esquerda do campo. */
     icone?: ReactNode;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export default function SeletorPesquisa({ opcoes, valor, onChange, onTextoLivre, aCarregar, erro, maximo, labels, icone, }: SeletorPesquisaProps): React.JSX.Element;

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

@@ -7,5 +7,6 @@ interface SidebarProps {
     onClose: () => void;
     children: ReactNode;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 declare const Sidebar: React.FC<SidebarProps>;
 export default Sidebar;

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

@@ -14,6 +14,7 @@ interface UserAvatarProps {
  * 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.
  */
 export default function UserAvatar({ name, photo, email, company, jobTitle, department, className, showCard, }: UserAvatarProps): React.JSX.Element;
 export {};

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

@@ -1,4 +1,5 @@
 import React from 'react';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface GanttRow {
     id: string;
     label: string;
@@ -18,11 +19,13 @@ export interface GanttRow {
     section?: string;
     children?: GanttRow[];
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface GanttLegendItem {
     label: string;
     color: string;
     kind?: 'block' | 'marker';
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface GanttChartProps {
     rows: GanttRow[];
     /** Início e fim do eixo (ISO). */
@@ -50,6 +53,10 @@ export interface GanttChartProps {
     emptyText?: string;
     className?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export default function GanttChart({ rows, start, end, dayWidth, labelWidth, labelHeader, legend, expanded: expandedProp, onExpandedChange, renderTooltip, monthNames, emptyText, className, }: GanttChartProps): React.JSX.Element;
-/** Utilitário: ISO de um dia do eixo (para quem precisa de formatar tooltips). */
+/**
+ * Utilitário: ISO de um dia do eixo (para quem precisa de formatar tooltips).
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
 export declare const ganttDiaIso: (start: string, offset: number) => string;

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

@@ -8,6 +8,7 @@ import React, { type ReactNode } from 'react';
  *
  * Arrastar e largar é opcional: sem `onMover`, o quadro é só de leitura — é o
  * caso de quem mostra dados de um sistema externo que não pode escrever.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export interface KanbanColuna {
     id: string;
@@ -17,6 +18,7 @@ export interface KanbanColuna {
     /** Conteúdo extra no cabeçalho, à direita da contagem (ex: total de horas). */
     extra?: ReactNode;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface KanbanProps<T> {
     colunas: KanbanColuna[];
     itens: T[];
@@ -38,4 +40,5 @@ export interface KanbanProps<T> {
         adicionar?: string;
     };
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export default function Kanban<T>({ colunas, itens, colunaDoItem, chaveDoItem, cartao, onAbrirItem, onMover, onAdicionar, labels, }: KanbanProps<T>): React.JSX.Element;

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

@@ -9,6 +9,7 @@ interface LazyLoaderProps<T> {
     scrollThreshold?: number | string;
     limit?: number;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export declare const LazyLoader: <T extends {
     id: string | number;
 }>({ endpoint, params, children, scrollableTarget, className, height, scrollThreshold, limit, }: LazyLoaderProps<T>) => React.JSX.Element;

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

@@ -25,13 +25,17 @@ import 'leaflet.heat';
  * As folhas de estilo do Leaflet têm de ser importadas pelo projeto:
  *   import 'leaflet/dist/leaflet.css'
  *   import 'leaflet.markercluster/dist/MarkerCluster.css'
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export interface PontoMapa {
     id: string;
     lat: number;
     lng: number;
 }
-/** Um fundo de mapa: o que o selector mostra e o que o Leaflet carrega. */
+/**
+ * Um fundo de mapa: o que o selector mostra e o que o Leaflet carrega.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
 export interface FundoMapa {
     id: string;
     rotulo: string;
@@ -49,13 +53,17 @@ export interface FundoMapa {
     tamanhoTile?: number;
     deslocamentoZoom?: number;
 }
-/** Uma fatia do anel de um marcador: uma cor e quantos registos ela representa. */
+/**
+ * Uma fatia do anel de um marcador: uma cor e quantos registos ela representa.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
+ */
 export interface FatiaMapa {
     cor: string;
     n: number;
     /** Nome legível, para a dica nativa do marcador. */
     rotulo?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface MapaPontosLabels {
     semPontos: string;
     semBiblioteca: string;
@@ -64,6 +72,7 @@ export interface MapaPontosLabels {
     truncado?: string;
     fecharAviso?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface MapaPontosProps<T extends PontoMapa> {
     pontos: T[];
     /** Cor do marcador. Devolver a mesma cor para todos é perfeitamente válido. */
@@ -193,4 +202,5 @@ export interface MapaPontosProps<T extends PontoMapa> {
     labels?: Partial<MapaPontosLabels>;
     className?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export default function MapaPontos<T extends PontoMapa>({ pontos, cor, balao, forma, fatias, selo, contorno, raio, rotulo, aproximado, onPontoClick, centro, zoom, altura, agrupar, tema, urlTiles, atribuicaoTiles, truncadoEm, percurso, calor, pesoCalor, fundos, onSeleccionarArea, legenda, labels, className, }: MapaPontosProps<T>): React.JSX.Element;

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

@@ -9,6 +9,7 @@ import React from 'react';
  * dimensão do filtro, e isso só o servidor sabe fazer.
  *
  * Genérico de propósito: recebe secções e opções, devolve escolhas.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export interface OpcaoFiltro {
     valor: string;
@@ -16,7 +17,9 @@ export interface OpcaoFiltro {
     /** Quantos registos esta opção daria. `undefined` não desenha contagem. */
     total?: number;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export type TipoCampoFiltro = 'opcoes' | 'atalhos' | 'livre';
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface CampoFiltro {
     /** Identifica o campo nos valores devolvidos. */
     chave: string;
@@ -33,6 +36,7 @@ export interface CampoFiltro {
     /** Conteúdo próprio (datas, interruptores…), quando `tipo` é `livre`. */
     conteudo?: React.ReactNode;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface SeccaoFiltros {
     chave: string;
     titulo: string;
@@ -40,6 +44,7 @@ export interface SeccaoFiltros {
     /** Aberta na primeira vez. Depois manda o que o utilizador fizer. */
     aberta?: boolean;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface PainelFiltrosLabels {
     titulo: string;
     limpar: string;
@@ -50,6 +55,7 @@ export interface PainelFiltrosLabels {
     verTodas: string;
     verMenos: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface PainelFiltrosProps {
     seccoes: SeccaoFiltros[];
     /** Valores actuais: chave do campo → valores escolhidos. */
@@ -59,4 +65,5 @@ export interface PainelFiltrosProps {
     labels?: Partial<PainelFiltrosLabels>;
     className?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export default function PainelFiltros({ seccoes, valores, onChange, onLimpar, labels, className, }: PainelFiltrosProps): React.JSX.Element;

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

@@ -7,6 +7,7 @@ import React from 'react';
  *
  * O atalho é registado em `window` e não num campo: a utilidade disto é poder
  * ser chamada de qualquer sítio da aplicação sem ter de lá chegar com o rato.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export interface ResultadoPesquisa {
     id: string;
@@ -16,6 +17,7 @@ export interface ResultadoPesquisa {
     /** Agrupador opcional, mostrado como cabeçalho. */
     grupo?: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface PesquisaRapidaLabels {
     titulo: string;
     placeholder: string;
@@ -23,6 +25,7 @@ export interface PesquisaRapidaLabels {
     aEscrever: string;
     dica: string;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export interface PesquisaRapidaProps {
     aberta: boolean;
     onFechar: () => void;
@@ -33,6 +36,7 @@ export interface PesquisaRapidaProps {
     minimo?: number;
     labels?: Partial<PesquisaRapidaLabels>;
 }
+/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */
 export default function PesquisaRapida({ aberta, onFechar, procurar, onEscolher, minimo, labels, }: PesquisaRapidaProps): React.JSX.Element | null;
 /**
  * Regista Ctrl/Cmd + K e devolve o estado de abertura.
@@ -40,6 +44,7 @@ export default function PesquisaRapida({ aberta, onFechar, procurar, onEscolher,
  * Em hook para quem usa a paleta não ter de repetir a escuta do teclado — e
  * porque o atalho tem de ser removido ao desmontar, que é o passo que se
  * esquece.
+ * @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy.
  */
 export declare function usarAtalhoPesquisa(): {
     aberta: boolean;