@proef/common-ui 0.0.0-stage → 2.2.1

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;