@archbase/security-ui 4.1.1 → 4.2.0

package/dist/securityDiagnostics/ArchbaseSecurityDiagnosticsView.d.ts

@@ -1,2 +1,20 @@
 import { ArchbaseSecurityDiagnosticsViewProps } from './types';
-export declare function ArchbaseSecurityDiagnosticsView({ height, width, defaultTab, tabs, slots, onError, }: ArchbaseSecurityDiagnosticsViewProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * A segurança do tenant como um diretório navegável — o <b>leitor</b>.
+ *
+ * <p>Deliberadamente separada da {@link ArchbaseSecurityView}, que é o <b>editor</b>: aquela tem uma
+ * aba por tabela e serve para mudar o estado; esta responde perguntas e não escreve nada. Misturá-las
+ * produziria uma tela com dois motivos para mudar.
+ *
+ * <p><b>Por que árvore, e não abas.</b> As três abas anteriores — panorama, efetivo e simulação —
+ * respondiam três perguntas sem se conversarem: descobrir uma permissão inerte no panorama não
+ * levava a lugar nenhum, e simular exigia digitar de cabeça o nome do recurso. Uma árvore de
+ * objetos, no espírito de um AD, dá <b>uma</b> navegação: seleciona-se o objeto e se vê tudo sobre
+ * ele, incluindo o caminho para o próximo.
+ *
+ * <p>Panorama e Simular continuam existindo — como nós da mesma árvore, não como abas paralelas. É
+ * o que permite a simulação receber sujeito e capacidade por clique, em vez de digitação: <b>escolher
+ * substitui lembrar</b>, e errar uma letra deixa de produzir um "não pode" indistinguível de uma
+ * negação real.
+ */
+export declare const ArchbaseSecurityDiagnosticsView: ({ height, width, slots, onError, }: ArchbaseSecurityDiagnosticsViewProps) => import("react/jsx-runtime").JSX.Element;

package/dist/securityDiagnostics/DiagnosticPrimitives.d.ts

@@ -4,13 +4,19 @@ import { ArchbaseDiagnosticAttribute, ArchbaseDiagnosticCard, ArchbaseDiagnostic
 export declare const severityColor: (severity: ArchbaseDiagnosticSeverity) => string;
 export interface MetricCardProps {
     card: ArchbaseDiagnosticCard;
+    /**
+     * Abre o detalhe do card. Ausente quando a métrica não tem lista por trás — e aí o cartão não
+     * fica clicável, para não prometer uma navegação que não existe.
+     */
+    onOpen?: (card: ArchbaseDiagnosticCard) => void;
 }
 /** Cartão de métrica: valor grande, denominador, rótulo e o porquê importa. */
-export declare const MetricCard: ({ card }: MetricCardProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MetricCard: ({ card, onOpen }: MetricCardProps) => import("react/jsx-runtime").JSX.Element;
 export interface MetricCardsProps {
     cards: ArchbaseDiagnosticCard[];
+    onOpenCard?: (card: ArchbaseDiagnosticCard) => void;
 }
-export declare const MetricCards: ({ cards }: MetricCardsProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MetricCards: ({ cards, onOpenCard }: MetricCardsProps) => import("react/jsx-runtime").JSX.Element;
 export interface FlagStripProps {
     flags: ArchbaseDiagnosticFlag[];
 }

package/dist/securityDiagnostics/EffectiveAccessPanel.d.ts

@@ -2,5 +2,12 @@ import { ArchbaseSecurityDiagnosticsSlots } from './types';
 export interface EffectiveAccessPanelProps {
     slots?: ArchbaseSecurityDiagnosticsSlots;
     onError?: (message: string) => void;
+    /**
+     * Pessoa escolhida fora do painel — na árvore do explorador.
+     *
+     * Quando presente, o painel consulta sozinho e a caixa de busca some: escolher na árvore já é a
+     * busca, e deixar as duas na tela faria a pessoa se perguntar qual das duas vale.
+     */
+    userId?: string;
 }
-export declare const EffectiveAccessPanel: ({ slots, onError }: EffectiveAccessPanelProps) => import("react/jsx-runtime").JSX.Element;
+export declare const EffectiveAccessPanel: ({ slots, onError, userId }: EffectiveAccessPanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/securityDiagnostics/OverviewItemsDrawer.d.ts

@@ -0,0 +1,18 @@
+import { ArchbaseDiagnosticCard } from './types';
+export interface OverviewItemsDrawerProps {
+    /** O cartão clicado. `null` mantém o painel fechado. */
+    card: ArchbaseDiagnosticCard | null;
+    onClose: () => void;
+}
+/**
+ * A lista por trás de um número do Panorama.
+ *
+ * <p>Um cartão diz "29 ações inativas". Sozinho, isso informa que existe um problema e não permite
+ * fazer nada a respeito — para agir é preciso saber <b>quais</b> são, e por quê. Este painel é o que
+ * transforma o Panorama de tela de leitura em ponto de partida de trabalho.
+ *
+ * <p>É um só para as seis métricas, e não seis listas: o backend devolve a mesma forma
+ * ({@code label} / {@code detail} / {@code reason}) para permissões, usuários, ações e recursos.
+ * Seis telas divergiriam com o tempo; esta acompanha qualquer métrica nova sem alteração.
+ */
+export declare const OverviewItemsDrawer: ({ card, onClose }: OverviewItemsDrawerProps) => import("react/jsx-runtime").JSX.Element;

package/dist/securityDiagnostics/SimulationPanel.d.ts

@@ -2,5 +2,19 @@ import { ArchbaseSecurityDiagnosticsSlots } from './types';
 export interface SimulationPanelProps {
     slots?: ArchbaseSecurityDiagnosticsSlots;
     onError?: (message: string) => void;
+    /**
+     * Sujeito e capacidade escolhidos na árvore.
+     *
+     * <p><b>Escolher substitui lembrar.</b> Digitar {@code tms.ordemservico} de cabeça é a origem do
+     * falso negativo: errar uma letra devolve "não pode", indistinguível de uma negação real. Com a
+     * escolha vinda da árvore, a resposta passa a significar o que diz.
+     *
+     * <p>Os campos continuam editáveis — a árvore preenche, não tranca.
+     */
+    initial?: {
+        userId?: string;
+        resource?: string;
+        action?: string;
+    };
 }
-export declare const SimulationPanel: ({ slots, onError }: SimulationPanelProps) => import("react/jsx-runtime").JSX.Element;
+export declare const SimulationPanel: ({ slots, onError, initial }: SimulationPanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/securityDiagnostics/explorer/ActionNodePanel.d.ts

@@ -0,0 +1,19 @@
+import { ArchbaseSecurityDiagnosticsSlots } from '../types';
+export interface ActionNodePanelProps {
+    id: string;
+    label: string;
+    slots?: ArchbaseSecurityDiagnosticsSlots;
+    onSelectUser?: (userId: string, label: string) => void;
+    onSimulate?: () => void;
+}
+/**
+ * Quem alcança esta capacidade — a consulta reversa.
+ *
+ * <p><b>A pergunta que antes não tinha resposta.</b> "Quem consegue aprovar custo?" só se
+ * respondia abrindo grupo por grupo no admin e cruzando na cabeça, com resultado que dependia de
+ * quem cruzou.
+ *
+ * <p>Administrador aparece na lista com a via marcada. Ele alcança sem concessão nenhuma, e
+ * omiti-lo daria a resposta errada justamente para as contas que mais importam numa auditoria.
+ */
+export declare const ActionNodePanel: ({ id, label, slots, onSelectUser, onSimulate }: ActionNodePanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/securityDiagnostics/explorer/GroupNodePanel.d.ts

@@ -0,0 +1,19 @@
+import { ArchbaseSecurityDiagnosticsSlots } from '../types';
+export interface GroupNodePanelProps {
+    id: string;
+    slots?: ArchbaseSecurityDiagnosticsSlots;
+    /** `PROFILE` troca o endpoint e o texto; a forma da resposta é a mesma de propósito. */
+    kind: 'GROUP' | 'PROFILE';
+    onSelectUser?: (userId: string, label: string) => void;
+}
+/**
+ * O que uma via concede, e quem está nela.
+ *
+ * <p><b>Os dois juntos porque separados enganam.</b> Ver o que o grupo concede não diz o que seus
+ * membros podem: cada um acumula o perfil, os outros grupos e as concessões diretas. Um grupo com
+ * três capacidades pode ter um membro que faz tudo, por outra via — e é o total que decide o acesso.
+ *
+ * <p>Grupo e perfil compartilham este painel de propósito: para quem lê, é a mesma pergunta, muda só
+ * a via. Duas telas obrigariam a aprender duas coisas para uma ideia.
+ */
+export declare const GroupNodePanel: ({ id, kind, slots, onSelectUser }: GroupNodePanelProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/securityDiagnostics/explorer/SecurityTree.d.ts

@@ -0,0 +1,19 @@
+import { ExplorerSelection } from './selection';
+export interface SecurityTreeProps {
+    selected: ExplorerSelection | null;
+    onSelect: (selecao: ExplorerSelection) => void;
+}
+/**
+ * A árvore de objetos de segurança.
+ *
+ * <p><b>Carrega por demanda, ramo a ramo.</b> Um tenant real tem centenas de recursos e ações;
+ * montar a árvore inteira numa carga obriga o servidor a materializar o catálogo para exibir cinco
+ * linhas, e trava o navegador ao renderizar. Cada ramo busca ao abrir, e a busca vai para o
+ * servidor — filtrar no cliente exigiria ter carregado tudo antes, que é o problema que a
+ * paginação existe para evitar.
+ *
+ * <p>O marcador colorido no nó vem do servidor e é o que leva o olho até onde há problema. Sem ele,
+ * achar um recurso com ação desativada entre uma centena exige abrir ramo por ramo — e ninguém faz
+ * isso.
+ */
+export declare const SecurityTree: ({ selected, onSelect }: SecurityTreeProps) => import("react/jsx-runtime").JSX.Element;

package/dist/securityDiagnostics/explorer/selection.d.ts

@@ -0,0 +1,15 @@
+import { ArchbaseTreeNodeKind } from '@archbase/security';
+/**
+ * O que está selecionado na árvore.
+ *
+ * <p>Os dois primeiros não são objetos do catálogo: são as duas ferramentas que antes eram abas
+ * próprias. Tratá-los como nós da mesma árvore é o que faz a tela ter <b>uma</b> navegação em vez
+ * de duas — e é o que permite a simulação receber o sujeito e a capacidade por clique, em vez de
+ * digitação.
+ */
+export type ExplorerSelectionKind = ArchbaseTreeNodeKind | 'OVERVIEW' | 'SIMULATE';
+export interface ExplorerSelection {
+    kind: ExplorerSelectionKind;
+    id: string;
+    label: string;
+}

package/dist/securityDiagnostics/explorer/situacao.d.ts

@@ -0,0 +1,12 @@
+import { ReactNode } from 'react';
+/**
+ * A situação de uma concessão, em linguagem de quem opera.
+ *
+ * <p>O backend fala {@code EFFECTIVE}, {@code INERT} e {@code DENIED} — vocabulário do modelo. Quem
+ * lê a tela quer saber se a permissão <b>vale</b>. "Inerte" não é palavra que alguém use para
+ * decidir o que fazer; "não vale" é.
+ *
+ * <p>A tradução fica num lugar só de propósito: repetida em cada painel, uma tela acabaria dizendo
+ * "inerte" e outra "não vale" para a mesma coisa.
+ */
+export declare const situacaoBadge: (situacao?: string | null) => ReactNode;

package/dist/securityDiagnostics/index.d.ts

@@ -1,6 +1,12 @@
 export * from './types';
 export * from './DiagnosticPrimitives';
 export * from './OverviewPanel';
+export * from './OverviewItemsDrawer';
 export * from './EffectiveAccessPanel';
 export * from './SimulationPanel';
 export * from './ArchbaseSecurityDiagnosticsView';
+export * from './explorer/SecurityTree';
+export * from './explorer/GroupNodePanel';
+export * from './explorer/ActionNodePanel';
+export * from './explorer/selection';
+export * from './explorer/situacao';

package/dist/securityDiagnostics/types.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { ArchbaseAccessDecision, ArchbaseAccessOverview, ArchbaseEffectiveAccessReport, ArchbaseEffectiveCapability } from '@archbase/security';
+import { ArchbaseAccessDecision, ArchbaseAccessOverview, ArchbaseEffectiveAccessReport, ArchbaseEffectiveCapability, ArchbaseGroupMember, ArchbaseGroupReport, ArchbaseOverviewMetric, ArchbaseReachEntry } from '@archbase/security';
 /**
  * Um atributo de negócio exibido no painel de identidade — rótulo e valor.
  *
@@ -22,6 +22,14 @@ export interface ArchbaseDiagnosticCard {
     of?: string;
     label: string;
     description?: string;
+    /**
+     * A métrica cujos itens este cartão representa.
+     *
+     * Presente, o cartão fica clicável e abre a lista do que forma o número — que é o que permite
+     * agir: "29 ações inativas" não diz quais. Ausente (caso dos cartões de negócio injetados por
+     * slot, que o framework não sabe detalhar), o cartão continua só de leitura.
+     */
+    metric?: ArchbaseOverviewMetric;
 }
 /** Indicador de proteção ligada/desligada, na faixa do topo do Panorama. */
 export interface ArchbaseDiagnosticFlag {
@@ -58,10 +66,15 @@ export interface ArchbaseSecurityDiagnosticsSlots {
     /** Região livre no fim do Panorama — painel próprio, gráfico, link para relatório. */
     afterOverview?: (overview: ArchbaseAccessOverview) => ReactNode;
     /**
-     * Substitui o seletor de usuário inteiro.
+     * Uma segunda porta de entrada para chegar a uma pessoa, acima da árvore.
+     *
+     * <p>É por aqui que entra "buscar pessoa por departamento": o framework identifica alguém por id
+     * ou e-mail e não tem como saber o que é departamento.
      *
-     * <p>É por aqui que entra "buscar pessoa por departamento": o framework identifica alguém
-     * por id ou e-mail e não tem como saber o que é departamento.
+     * <p><b>Mudou de lugar, não de propósito.</b> Quando a tela era um formulário, este slot
+     * substituía a caixa de busca. Agora a árvore é a navegação, e o que a aplicação oferece aparece
+     * ao lado dela — as duas convivem, porque quem sabe o e-mail usa a árvore e quem sabe só o
+     * departamento usa isto.
      */
     renderUserSearch?: (onSelect: (userIdOrEmail: string) => void) => ReactNode;
     /** Selos ao lado do nome — "terceirizado", "afastado", "contrato vencido". */
@@ -75,6 +88,25 @@ export interface ArchbaseSecurityDiagnosticsSlots {
         header: string;
         render: (capability: ArchbaseEffectiveCapability, report: ArchbaseEffectiveAccessReport) => ReactNode;
     }>;
+    /**
+     * Colunas extras na tabela de membros — o lugar do departamento, do centro de custo.
+     *
+     * <p>Mesma convenção da tabela de capacidades: a aplicação entrega cabeçalho e conteúdo por
+     * linha, e o framework desenha.
+     */
+    additionalMemberColumns?: Array<{
+        header: string;
+        render: (member: ArchbaseGroupMember, report: ArchbaseGroupReport) => ReactNode;
+    }>;
+    /** Região livre no fim do painel de grupo ou perfil. */
+    afterGroupMembers?: (report: ArchbaseGroupReport) => ReactNode;
+    /**
+     * Região livre depois da lista de quem alcança uma capacidade.
+     *
+     * <p>O lugar de um "exportar para auditoria" ou de um aviso próprio da aplicação sobre aquela
+     * capacidade.
+     */
+    afterReachList?: (actionId: string, entries: ArchbaseReachEntry[]) => ReactNode;
     /**
      * Campos de negócio no formulário de simulação.
      *
@@ -89,14 +121,17 @@ export interface ArchbaseSecurityDiagnosticsSlots {
     /** Depois do veredito — a tradução do motivo técnico para a linguagem do negócio. */
     afterDecision?: (decision: ArchbaseAccessDecision) => ReactNode;
 }
-/** Props da view de diagnóstico. */
+/**
+ * Props da view de diagnóstico.
+ *
+ * <p>Não há mais {@code defaultTab} nem {@code tabs}: a tela deixou de ser um conjunto de abas
+ * paralelas e virou um explorador de árvore. Panorama e Simular continuam existindo, como nós — e
+ * restringir quais nós aparecem seria esconder objetos de segurança de quem está auditando, que é o
+ * oposto do que a tela existe para fazer.
+ */
 export interface ArchbaseSecurityDiagnosticsViewProps {
     height?: string | number;
     width?: string | number;
-    /** Aba inicial. */
-    defaultTab?: 'overview' | 'effective' | 'simulate';
-    /** Abas a exibir. Omitido = todas. */
-    tabs?: Array<'overview' | 'effective' | 'simulate'>;
     slots?: ArchbaseSecurityDiagnosticsSlots;
     onError?: (message: string) => void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archbase/security-ui",
-  "version": "4.1.1",
+  "version": "4.2.0",
   "description": "Security UI components for Archbase React - Forms, Modals, and Views",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -40,11 +40,11 @@
     "inversify-react": "^1.1.0",
     "rxjs": "^7.8.2",
     "uuid": "^9.0.1",
-    "@archbase/layout": "4.1.1",
-    "@archbase/core": "4.1.1",
-    "@archbase/components": "4.1.1",
-    "@archbase/data": "4.1.1",
-    "@archbase/security": "4.1.1"
+    "@archbase/core": "4.2.0",
+    "@archbase/data": "4.2.0",
+    "@archbase/components": "4.2.0",
+    "@archbase/layout": "4.2.0",
+    "@archbase/security": "4.2.0"
   },
   "devDependencies": {
     "@types/react": "^19.0.6",