@selectwin/kit 0.1.117 → 0.1.118

package/dist/SelectInsight.d.ts

@@ -0,0 +1,119 @@
+import { ReactNode } from 'react';
+/** Um valor do achado: `display` para ler, `raw` para gráfico/ordenação (percentual em fração, dinheiro em centavos). */
+export interface SelectInsightValue {
+    type: string;
+    raw: number | string | readonly string[];
+    display: string;
+    currency: string | null;
+}
+export interface SelectInsightItem {
+    /** `product`, `ad`, `campaign`, `coupon`, `channel`, `network`, `field`, `segment`… */
+    kind: string;
+    /** O id do recurso quando existe tela para ele (`prd_…`). */
+    id: string | null;
+    label: string;
+    value: SelectInsightValue | null;
+}
+export type SelectInsightBlock = {
+    type: 'metric';
+    label: string;
+    value: SelectInsightValue;
+    hint: string | null;
+} | {
+    type: 'comparison';
+    label: string;
+    value: SelectInsightValue;
+    baseline: SelectInsightValue;
+    baselineLabel: string;
+    hint: string | null;
+} | {
+    type: 'table';
+    title: string;
+    columns: ReadonlyArray<{
+        key: string;
+        label: string;
+    }>;
+    rows: ReadonlyArray<Record<string, SelectInsightValue>>;
+} | {
+    type: 'items';
+    title: string;
+    items: ReadonlyArray<SelectInsightItem>;
+} | {
+    type: 'text';
+    text: string;
+};
+export interface SelectInsightAction {
+    label: string;
+    /** Destino estável (`guide:utm`, `product:prd_…`) ou `null` — conselho sem tela. */
+    target: string | null;
+}
+/** O achado como o node o entrega. Campos a mais (id, status, score…) passam sem atrapalhar. */
+export interface SelectInsightData {
+    title: string;
+    summary: string;
+    severity: string;
+    confidence?: string | null;
+    sampleSize?: number | null;
+    kind?: string | null;
+    domain?: string | null;
+    impact?: {
+        currency: string;
+        minCents: number;
+        maxCents: number;
+    } | null;
+    period?: {
+        start: string;
+        end: string;
+    } | null;
+    methodology?: string | null;
+    /** Aceita tipos que esta versão não conhece — são ignorados na renderização. */
+    blocks?: ReadonlyArray<SelectInsightBlock | {
+        type: string;
+    }>;
+    actions?: ReadonlyArray<SelectInsightAction>;
+}
+export type SelectInsightLocale = 'pt-BR' | 'en' | 'es';
+export interface SelectInsightLabels {
+    severity: Record<string, string>;
+    kind: Record<string, string>;
+    domain: Record<string, string>;
+    confidence: Record<string, string>;
+    sample: (n: string) => string;
+    /** A faixa já formatada ("R$ 2.038 a R$ 3.962") → a frase do impacto. */
+    impact: (range: string) => string;
+    /** Impacto com mínimo = máximo — ainda é estimativa, então nunca um número seco. */
+    impactAbout: (value: string) => string;
+    rangeJoin: string;
+    methodology: string;
+    actions: string;
+    locked: string;
+}
+/** "R$ 2.038 a R$ 3.962" — em reais inteiros: é estimativa, centavo seria falsa precisão. */
+export declare function formatInsightImpact(impact: {
+    currency: string;
+    minCents: number;
+    maxCents: number;
+}, locale?: string, labels?: Pick<SelectInsightLabels, 'impact' | 'impactAbout' | 'rangeJoin'>): string;
+export interface SelectInsightProps {
+    insight: SelectInsightData;
+    /** Os rótulos do card. O TEXTO do achado já vem traduzido pelo node — passe a mesma língua que pediu a ele. */
+    locale?: string;
+    labels?: Partial<SelectInsightLabels>;
+    /** Fuso do período (o calendário do Lince é o de São Paulo). */
+    timeZone?: string;
+    /** A isca do plano: só título, resumo e impacto, esmaecidos, com o `lockedCta`. */
+    locked?: boolean;
+    lockedCta?: ReactNode;
+    /** Selos a mais no cabeçalho (no console: o estado do achado, o "o lojista vê travado"). */
+    badges?: ReactNode;
+    /** Linha a mais no pé do card (no console: o `subjectKey`). */
+    footer?: ReactNode;
+    /** O rótulo de um item virado link quando houver tela (`product` + `prd_…`). `undefined` = só o texto. */
+    renderItem?: (item: SelectInsightItem) => ReactNode | undefined;
+    /** Uma ação virada link/botão pelo `target`. `undefined` = só o texto. */
+    renderAction?: (action: SelectInsightAction) => ReactNode | undefined;
+    /** "Como calculamos" aberto de saída. */
+    methodologyOpen?: boolean;
+    className?: string;
+}
+export declare function SelectInsight({ insight, locale, labels: labelsOverride, timeZone, locked, lockedCta, badges, footer, renderItem, renderAction, methodologyOpen, className, }: SelectInsightProps): import("react").JSX.Element;

package/dist/index.d.ts

@@ -96,6 +96,7 @@ export { SelectMoney, SelectSensitiveValue, SelectMetricDelta, SelectHideMoneyTo
 export { SelectBalanceCard } from './SelectBalanceCard';
 export { SelectFeeBreakdown } from './SelectFeeBreakdown';
 export { SelectKpiCard } from './SelectKpiCard';
+export { SelectInsight, formatInsightImpact } from './SelectInsight';
 export { SelectChartCard } from './SelectChartCard';
 export { SelectSparkline } from './SelectSparkline';
 export { SelectBarChart } from './SelectBarChart';
@@ -224,6 +225,7 @@ export type { SelectRowAction } from './SelectRowActions';
 export type { SelectStatusMeta } from './SelectStatusBadge';
 export type { SelectTimelineItem, SelectTimelineTone } from './SelectTimeline';
 export type { SelectDataColumn } from './SelectDataTable';
+export type { SelectInsightProps, SelectInsightData, SelectInsightBlock, SelectInsightValue, SelectInsightItem, SelectInsightAction, SelectInsightLabels, SelectInsightLocale, } from './SelectInsight';
 export type { SelectRecordCardProps, SelectRecordCardTone, SelectLayoutThumbProps } from './SelectRecordCard';
 export type { SelectSplitChainProps, SelectSplitNode } from './SelectSplitChain';
 export type { SelectOfferPriceProps } from './SelectOfferPrice';