@proef/common-ui 0.0.0-stage → 2.2.0

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;

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

@@ -0,0 +1,16 @@
+import React, { ReactNode } from 'react';
+import './Header.scss';
+import { IconProp } from '@fortawesome/fontawesome-svg-core';
+type Props = {
+    title: string;
+    subTitle?: string;
+    icon?: IconProp;
+    sideBar: boolean;
+    handleSideBar: () => void;
+    profile: ReactNode;
+    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/legacy/components/layout/Layout/Layout.d.ts

@@ -0,0 +1,35 @@
+import React from 'react';
+import { type SidebarMenuItem, type SidebarLanguage, type SidebarTheme } from '../Sidebar/Sidebar';
+/** @deprecated Legacy — usar `AppShellProps` do V1. */
+export interface LayoutProps {
+    children: React.ReactNode;
+    menus: SidebarMenuItem[];
+    groupLabels?: Record<string, string>;
+    appTitle?: string;
+    /** Barra superior opcional (título/alertas), sticky acima do conteúdo. */
+    topBar?: React.ReactNode;
+    avatar?: React.ReactNode;
+    onLogout?: () => void;
+    logoutLabel?: string;
+    languages?: SidebarLanguage[];
+    currentLang?: string;
+    onLanguageChange?: (code: string) => void;
+    theme?: SidebarTheme;
+    onThemeChange?: (theme: SidebarTheme) => void;
+    themeLabels?: {
+        label?: string;
+        light?: string;
+        dark?: string;
+        system?: string;
+    };
+    footer?: (isExpanded: boolean) => React.ReactNode;
+    deployedAt?: string | number | Date;
+    deployedAtLabel?: string;
+    /** Estado inicial da sidebar (aberta/fechada). */
+    sidebarOpen?: boolean;
+    /** Chamado quando a pessoa abre/fecha a sidebar. */
+    onSidebarOpenChange?: (open: boolean) => void;
+}
+/** @deprecated Legacy — usar `AppShell` do V1. */
+declare const Layout: ({ children, menus, currentLang, logoutLabel, themeLabels, deployedAtLabel, footer, sidebarOpen, onSidebarOpenChange, ...rest }: LayoutProps) => React.JSX.Element;
+export default Layout;

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

@@ -0,0 +1,56 @@
+import React from 'react';
+import { type SideNavItem, type SideNavLabels } from '../../../../v1/components/layout/SideNav/SideNav';
+/** @deprecated Legacy — usar `SideNavTheme` do V1. */
+export type SidebarTheme = 'light' | 'dark' | 'system';
+/** @deprecated Legacy — usar `languages` do `SideNav` do V1. */
+export interface SidebarLanguage {
+    code: string;
+    label: string;
+}
+/** @deprecated Legacy — usar `SideNavItem` do V1. */
+export interface SidebarMenuItem {
+    to: string;
+    icon: React.ComponentType<{
+        size?: number;
+        className?: string;
+    }>;
+    label: string;
+    group?: string;
+    end?: boolean;
+    /** Contador opcional (ex: aprovações pendentes). */
+    badge?: number;
+    /** Destino fora da aplicação: abre em separador novo. */
+    external?: boolean;
+}
+/** @deprecated Legacy — usar `SideNavProps` do V1. */
+export interface SidebarProps {
+    isOpen?: boolean;
+    setIsOpen?: (isOpen: boolean) => void;
+    menus: SidebarMenuItem[];
+    groupLabels?: Record<string, string>;
+    appTitle?: string;
+    avatar?: React.ReactNode;
+    onLogout?: () => void;
+    logoutLabel?: string;
+    languages?: SidebarLanguage[];
+    currentLang?: string;
+    onLanguageChange?: (code: string) => void;
+    theme?: SidebarTheme;
+    onThemeChange?: (theme: SidebarTheme) => void;
+    themeLabels?: {
+        label?: string;
+        light?: string;
+        dark?: string;
+        system?: string;
+    };
+    footer?: (isExpanded: boolean) => React.ReactNode;
+    deployedAt?: string | number | Date;
+    deployedAtLabel?: string;
+}
+/** Itens do menu antigo no formato do V1 (`badge` → `badges`). */
+export declare const menuV1: (menus: SidebarMenuItem[]) => SideNavItem[];
+/** Os textos por omissão do menu antigo, para não mudarem nas apps que ainda o usam. */
+export declare const labelsV1: (p: Pick<SidebarProps, "logoutLabel" | "themeLabels" | "deployedAtLabel">) => Partial<SideNavLabels>;
+/** @deprecated Legacy — usar `SideNav` (ou `AppShell`) do V1. */
+declare const Sidebar: ({ isOpen, setIsOpen, menus, currentLang, logoutLabel, themeLabels, deployedAtLabel, ...rest }: SidebarProps) => React.JSX.Element;
+export default Sidebar;

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

@@ -0,0 +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/legacy/components/layout/TopBar/TopBar.d.ts

@@ -0,0 +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/legacy/components/layout/TopNavLayout/TopNavLayout.d.ts

@@ -0,0 +1,43 @@
+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[];
+    appTitle: string;
+    appSubtitle?: string;
+    /** Logo custom à esquerda. Sem isto: barra turquesa + appTitle/appSubtitle. */
+    logo?: React.ReactNode;
+    avatar?: React.ReactNode;
+    userName?: string;
+    onLogout?: () => void;
+    logoutLabel?: string;
+    languages?: SidebarLanguage[];
+    currentLang?: string;
+    onLanguageChange?: (code: string) => void;
+    theme?: SidebarTheme;
+    onThemeChange?: (theme: SidebarTheme) => void;
+    themeLabels?: {
+        label?: string;
+        light?: string;
+        dark?: string;
+        system?: string;
+    };
+    /** Largura máxima do conteúdo/nav (px). Default 1400. */
+    maxWidth?: number;
+}
+/**
+ * Layout com navegação HORIZONTAL no topo (design system proef) — para portais
+ * 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/legacy/components/molecules/BarraValor/BarraValor.d.ts

@@ -0,0 +1,28 @@
+import React, { type ReactNode } from 'react';
+/**
+ * Lista de barras horizontais — a forma mais legível de comparar poucas
+ * dezenas de valores (horas por pessoa, por plano, por etiqueta).
+ *
+ * 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;
+    rotulo: string;
+    valor: number;
+    /** 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. */
+    maximo?: number;
+    /** Classe de cor da barra. */
+    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/legacy/components/molecules/ColumnPicker/ColumnPicker.d.ts

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

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

@@ -0,0 +1,13 @@
+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;
+    handleCancel: () => void;
+    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;