@nextelco/common-ui 2.1.93 → 2.1.94

package/dist/types/components/ui/CabecalhoPagina.d.ts

@@ -0,0 +1,32 @@
+import React, { type ReactNode } from 'react';
+/** Um nível do caminho por cima do título. */
+export interface NivelCaminho {
+    rotulo: ReactNode;
+    /** Ligação normal. Para o router da app, usar `onClick` (ex: `() => navigate('/x')`). */
+    href?: string;
+    onClick?: () => void;
+}
+export interface CabecalhoPaginaProps {
+    titulo: ReactNode;
+    descricao?: ReactNode;
+    /**
+     * Caminho até à página (área › lista › registo). O último nível é a página
+     * atual e não leva ligação, mesmo que a traga.
+     */
+    caminho?: NivelCaminho[];
+    /** Botões da página (ex: "Novo", "Editar"). Ficam à direita e descem em ecrã estreito. */
+    acoes?: ReactNode;
+    /** Linha extra por baixo da descrição (etiquetas de estado, responsável…). */
+    extra?: ReactNode;
+    /** Rótulo acessível da navegação do caminho. */
+    rotuloCaminho?: string;
+}
+/**
+ * Cabeçalho comum a todas as páginas: caminho, título com a barra turquesa,
+ * descrição e ações.
+ *
+ * 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.
+ */
+export default function CabecalhoPagina({ titulo, descricao, caminho, acoes, extra, rotuloCaminho, }: CabecalhoPaginaProps): React.JSX.Element;

package/dist/types/components/ui/Confirmacao.d.ts

@@ -0,0 +1,29 @@
+import React, { type ReactNode } from 'react';
+export interface ConfirmacaoProps {
+    aberto: boolean;
+    titulo: ReactNode;
+    /** Explicação: o que vai acontecer, a que registo, se é reversível. */
+    children?: ReactNode;
+    onConfirmar: () => void;
+    onCancelar: () => void;
+    /** Texto do botão — o verbo da ação ("Eliminar", "Submeter"), não "OK". */
+    textoConfirmar?: string;
+    textoCancelar?: string;
+    /** `perigo` pinta a ação a vermelho e põe o foco em Cancelar. */
+    variante?: 'normal' | 'perigo';
+    /** A ação está a correr: botões desativados. */
+    aConfirmar?: boolean;
+    /** Uma segunda saída (ex: "Desativar" em vez de eliminar, "Eliminar só o contrato"). */
+    acaoSecundaria?: {
+        rotulo: string;
+        onClick: () => void;
+    };
+}
+/**
+ * Pedido de confirmação antes de uma ação. Substitui o `window.confirm()` do
+ * browser, que mostra o endereço do servidor, não diz que registo é e só tem
+ * "OK".
+ *
+ * Esc e clicar fora cancelam (exceto enquanto `aConfirmar`).
+ */
+export default function Confirmacao({ aberto, titulo, children, onConfirmar, onCancelar, textoConfirmar, textoCancelar, variante, aConfirmar, acaoSecundaria, }: ConfirmacaoProps): React.JSX.Element | null;

package/dist/types/components/ui/FaixaAviso.d.ts

@@ -0,0 +1,20 @@
+import React, { type ReactNode } from 'react';
+export type TomFaixa = 'aviso' | 'info' | 'erro';
+export interface FaixaAvisoProps {
+    children: ReactNode;
+    tom?: TomFaixa;
+    /** Ação à direita (ex: "Voltar ao meu perfil" no "Ver como"). */
+    acao?: {
+        rotulo: ReactNode;
+        onClick: () => void;
+    };
+    icone?: ReactNode;
+}
+/**
+ * Faixa no topo do conteúdo para um estado que afeta a página inteira: "Ver
+ * como" outro perfil, um serviço externo em baixo, dados possivelmente
+ * incompletos. Não é para resultados de ações — esses são avisos (`useAvisos`).
+ *
+ * Fica bem no slot `topBar` do Layout.
+ */
+export default function FaixaAviso({ children, tom, acao, icone }: FaixaAvisoProps): React.JSX.Element;

package/dist/types/components/ui/Paginas.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/ui/Passos.d.ts

@@ -0,0 +1,28 @@
+import React, { type ReactNode } from 'react';
+export interface Passo<T extends string> {
+    id: T;
+    rotulo: ReactNode;
+    /** Passo já preenchido e válido (✓). */
+    concluido?: boolean;
+    /** Passo com erros por corrigir. */
+    erro?: boolean;
+}
+export interface PassosProps<T extends string> {
+    passos: Passo<T>[];
+    atual: T;
+    /** Sem isto, os passos são só indicação (não se clica). */
+    onMudar?: (id: T) => void;
+    /**
+     * Todos os passos clicáveis. Num registo já existente (editar/visualizar)
+     * pode-se saltar para qualquer passo; num novo, só para os já concluídos.
+     */
+    livre?: boolean;
+    rotulo?: string;
+}
+/**
+ * Barra de passos para formulários longos (página própria, não pop-up).
+ *
+ * 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.
+ */
+export default function Passos<T extends string>({ passos, atual, onMudar, livre, rotulo }: PassosProps<T>): React.JSX.Element;

package/dist/types/components/ui/Separadores.d.ts

@@ -0,0 +1,23 @@
+import React, { type ReactNode } from 'react';
+export interface Separador<T extends string> {
+    id: T;
+    rotulo: ReactNode;
+    /** Número à frente do rótulo (ex: faturas por mapear). Omitir quando não interessa. */
+    contagem?: number;
+    desativado?: boolean;
+}
+export interface SeparadoresProps<T extends string> {
+    itens: Separador<T>[];
+    ativo: T;
+    onMudar: (id: T) => void;
+    /** Rótulo acessível do conjunto (ex: "Estado das faturas"). */
+    rotulo?: string;
+}
+/**
+ * Separadores de uma página, iguais em todo o portal.
+ *
+ * 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.
+ */
+export default function Separadores<T extends string>({ itens, ativo, onMudar, rotulo }: SeparadoresProps<T>): React.JSX.Element;

package/dist/types/components/ui/TextoAuto.d.ts

@@ -0,0 +1,21 @@
+import React, { type TextareaHTMLAttributes } from 'react';
+export type TextoAutoProps = Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'rows'> & {
+    /** Altura mínima, em linhas. */
+    minLinhas?: number;
+    /** A partir daqui deixa de crescer e passa a ter scroll. */
+    maxLinhas?: number;
+};
+/**
+ * Caixa de texto que cresce com o conteúdo até `maxLinhas`; a partir daí tem
+ * scroll. Enter muda de linha (não submete).
+ *
+ * Vinda do Auditorias IT (comentários e descrições), onde uma textarea fixa ou
+ * cortava o texto ou ocupava meio ecrã vazia.
+ */
+declare const TextoAuto: React.ForwardRefExoticComponent<Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "rows"> & {
+    /** Altura mínima, em linhas. */
+    minLinhas?: number;
+    /** A partir daqui deixa de crescer e passa a ter scroll. */
+    maxLinhas?: number;
+} & React.RefAttributes<HTMLTextAreaElement>>;
+export default TextoAuto;

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

@@ -1,2 +1,18 @@
 export { Card, SectionGroup, Kpi, Badge, BadgeSla, ChipEstadoInterno, Btn, BtnGroup, Estado, Modal as ProefModal, Campo, CampoSelect, CampoPesquisa, CampoInterruptor, BarraFiltros, LinhaAlerta, ListaCampos, } from '../components/ui/Ui';
 export type { BadgeTone, StatusSla, SeveridadeAlerta } from '../components/ui/Ui';
+export { default as CabecalhoPagina } from '../components/ui/CabecalhoPagina';
+export type { CabecalhoPaginaProps, NivelCaminho } from '../components/ui/CabecalhoPagina';
+export { default as Separadores } from '../components/ui/Separadores';
+export type { SeparadoresProps, Separador } from '../components/ui/Separadores';
+export { default as Passos } from '../components/ui/Passos';
+export type { PassosProps, Passo } from '../components/ui/Passos';
+export { default as BarraAcoes } from '../components/ui/BarraAcoes';
+export type { BarraAcoesProps } from '../components/ui/BarraAcoes';
+export { default as FaixaAviso } from '../components/ui/FaixaAviso';
+export type { FaixaAvisoProps, TomFaixa } from '../components/ui/FaixaAviso';
+export { default as TextoAuto } from '../components/ui/TextoAuto';
+export type { TextoAutoProps } from '../components/ui/TextoAuto';
+export { default as Confirmacao } from '../components/ui/Confirmacao';
+export type { ConfirmacaoProps } from '../components/ui/Confirmacao';
+export { AvisosProvider, useAvisos } from '../components/ui/Avisos';
+export type { AvisosApi, AvisosProviderProps, OpcoesAviso, TipoAviso } from '../components/ui/Avisos';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextelco/common-ui",
-  "version": "2.1.93",
+  "version": "2.1.94",
   "description": "",
   "main": "dist/bundle.js",
   "types": "dist/types/index.d.ts",
@@ -16,7 +16,8 @@
     "pubOnlySameVersion": "npm run build && npm publish",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:ci": "vitest run --coverage"
+    "test:ci": "vitest run --coverage",
+    "release": "node scripts/release.mjs"
   },
   "keywords": [],
   "author": "",