@actionexec/dashboards 0.7.0 → 0.9.0

package/dist/widgets/CompositionWidget.d.ts

@@ -0,0 +1,7 @@
+interface Props {
+    data: Record<string, unknown>;
+    palette: string[];
+    label?: string;
+}
+export declare function CompositionWidget({ data, palette, label: propLabel }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/widgets/WidgetFrame.d.ts

@@ -0,0 +1,29 @@
+import type { ReactNode } from 'react';
+/** Estados em que o widget mostra uma mensagem no lugar do conteudo. */
+export type WidgetStateKind = 'empty' | 'error' | 'loading' | 'unconfigured';
+interface WidgetStateProps {
+    kind: WidgetStateKind;
+    /** Sobrescreve a mensagem padrao do estado. */
+    message?: string;
+}
+/** Mensagem centralizada exibida no lugar do conteudo do widget. */
+export declare function WidgetState({ kind, message }: WidgetStateProps): import("react/jsx-runtime").JSX.Element;
+interface WidgetFrameProps {
+    /** Sufixo da classe do widget (`kpi` -> `.widget-kpi`). */
+    name: string;
+    title?: string;
+    /** Quando definido, substitui o conteudo pela mensagem de estado. */
+    state?: WidgetStateKind;
+    stateMessage?: string;
+    /** Renderizado entre o titulo e o conteudo (ex: barra de abas da tabela). */
+    toolbar?: ReactNode;
+    children?: ReactNode;
+}
+/**
+ * Casca padrao de um widget: mesma hierarquia visual em todos os tipos.
+ *
+ * O titulo sai do payload computado ou da config; widgets sem titulo apenas o
+ * omitem — o conteudo ocupa a altura toda, sem espacador vazio.
+ */
+export declare function WidgetFrame({ name, title, state, stateMessage, toolbar, children }: WidgetFrameProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/widgets/comparison.d.ts

@@ -0,0 +1,26 @@
+export interface ComputedComparison {
+    id?: string;
+    label?: string | null;
+    /** `unavailable` = configurada, mas sem como resolver (ex: desvio sem filtro de data). */
+    status?: string;
+    display?: string;
+    baseline?: number | null;
+    baseline_formatted?: string | null;
+    delta?: number | null;
+    delta_formatted?: string | null;
+    variance_pct?: number | null;
+    ratio?: number | null;
+    /** Numero em destaque, ja formatado pelo backend conforme `display`. */
+    formatted?: string | null;
+    trend?: string | null;
+    sentiment?: string | null;
+}
+export declare const TREND_ARROWS: Record<string, string>;
+/**
+ * Comparacoes que o dashboard publicado mostra.
+ *
+ * As indisponiveis somem em vez de virar "-": quem ve o dashboard nao configurou
+ * nada e nao tem o que fazer com o aviso. Quem configurou ve a pendencia no
+ * builder, que le o mesmo `status`.
+ */
+export declare function visibleComparisons(raw: unknown): ComputedComparison[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actionexec/dashboards",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Biblioteca de renderizacao de dashboards da plataforma Action — componente <Dashboard> unico, consumindo /external/dashboards.",
   "type": "module",
   "repository": {