@selectwin/kit 0.1.117 → 0.1.119

package/dist/SelectBalanceCard.d.ts

@@ -4,11 +4,23 @@ export interface SelectBalanceBucket {
     cents: number | string | null | undefined;
     /** Optional icon embedded in the bucket's mini-card. */
     icon?: ReactNode;
+    /** One line of context under the amount (hero tiles only) — "Entra no disponível nos próximos dias". */
+    hint?: ReactNode;
+}
+/** One context number on the hero's strip ("Entra nos próximos 7 dias", "Último saque · 23/09"). */
+export interface SelectBalanceMeta {
+    label: ReactNode;
+    /** Amount in CENTS (through SelectMoney → honors hide-values)… */
+    cents?: number | string | null;
+    /** …or any other content when the value isn't money (or the amount is null — else "—"). */
+    value?: ReactNode;
+    /** Sign/prefix drawn before the amount, e.g. "+ ". */
+    prefix?: string;
 }
 export interface SelectBalanceCardProps {
     availableCents: number | string | null | undefined;
     availableLabel?: string;
-    /** Period-over-period variation of the available balance (percentage). */
+    /** Period-over-period variation of the available balance (percentage). `card` only. */
     delta?: number | null;
     buckets?: SelectBalanceBucket[];
     action?: {
@@ -16,6 +28,20 @@ export interface SelectBalanceCardProps {
         onAction: () => void;
         disabled?: boolean;
         loading?: boolean;
+        icon?: ReactNode;
+    };
+    /** `card` (default) or `hero` — see the file header. */
+    variant?: 'card' | 'hero';
+    /** hero: a quiet line under the amount — "Atualizado há 3 min". */
+    updatedLabel?: ReactNode;
+    /** hero: context numbers on a strip under the amount (2 read best; empty = no strip). */
+    meta?: SelectBalanceMeta[];
+    /** hero: state pill beside the action (e.g. the auto-cashout that is on). */
+    status?: {
+        label: ReactNode;
+        tone?: 'success' | 'warning' | 'neutral';
     };
+    /** hero: amounts become skeletons (the frame keeps its shape — swaps once when data lands). */
+    loading?: boolean;
 }
 export declare const SelectBalanceCard: import('react').ForwardRefExoticComponent<SelectBalanceCardProps & Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, keyof SelectBalanceCardProps> & import('react').RefAttributes<HTMLDivElement>>;

package/dist/SelectChartLegend.d.ts

@@ -0,0 +1,17 @@
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+export interface SelectChartLegendItem {
+    label: ReactNode;
+    value?: ReactNode;
+    /** Swatch color — the series' `color`. */
+    color?: string;
+    /** Match a `pattern: 'hatch'` series. */
+    pattern?: 'hatch';
+    /** Instead of a swatch (a total that isn't drawn, e.g. "Cancelados"). */
+    icon?: ReactNode;
+}
+type SelectChartLegendOwnProps = {
+    items: SelectChartLegendItem[];
+};
+export type SelectChartLegendProps = SelectChartLegendOwnProps & Omit<ComponentPropsWithoutRef<'div'>, keyof SelectChartLegendOwnProps>;
+export declare function SelectChartLegend({ items, className, ...rest }: SelectChartLegendProps): import("react").JSX.Element;
+export {};

package/dist/SelectColumnChart.d.ts

@@ -1,5 +1,14 @@
-import { ComponentPropsWithoutRef } from 'react';
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
 import { SelectChartSeries } from './chartUtils';
+/** What the hover card shows for one slot (see `tooltip`). */
+export interface SelectColumnTooltip {
+    title?: ReactNode;
+    rows: {
+        label: ReactNode;
+        value: ReactNode;
+        color?: string;
+    }[];
+}
 type SelectColumnChartOwnProps = {
     series: SelectChartSeries[];
     labels: string[];
@@ -7,7 +16,18 @@ type SelectColumnChartOwnProps = {
     format?: (n: number) => string;
     /** Stack the series into one bar per label instead of grouping side by side. */
     stacked?: boolean;
+    /** A dashed vertical line with a label ("Hoje") on slot `index` — through its centre, or on
+     *  its trailing edge with `edge: 'end'` (the seam between what happened and what's scheduled).
+     *  The thinned x labels anchor on this slot, so it always keeps its label. */
+    marker?: {
+        index: number;
+        label?: string;
+        edge?: 'center' | 'end';
+    };
+    /** Custom hover card for slot `index`; return null for no card there. Default: the slot's
+     *  label as title and one row per series. */
+    tooltip?: (index: number) => SelectColumnTooltip | null;
 };
 export type SelectColumnChartProps = SelectColumnChartOwnProps & Omit<ComponentPropsWithoutRef<'div'>, keyof SelectColumnChartOwnProps>;
-export declare function SelectColumnChart({ series, labels, height, format, stacked, className, ...rest }: SelectColumnChartProps): import("react").JSX.Element;
+export declare function SelectColumnChart({ series, labels, height, format, stacked, marker, tooltip, className, ...rest }: SelectColumnChartProps): import("react").JSX.Element;
 export {};

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/chartUtils.d.ts

@@ -58,6 +58,10 @@ export interface SelectChartSeries {
     name: string;
     data: number[];
     color?: string;
+    /** SelectColumnChart: paint the bars with diagonal stripes of `color` instead of the solid
+     *  gradient — the second encoding for "not happened yet" (scheduled, projected), so the
+     *  difference never rides on color alone. */
+    pattern?: 'hatch';
 }
 export interface SelectBarDatum {
     label: string;

package/dist/icons.d.ts

@@ -97,6 +97,12 @@ export declare function LockIcon(): import("react").JSX.Element;
 export declare function CalendarIcon(): import("react").JSX.Element;
 export declare function ChevronUpIcon(): import("react").JSX.Element;
 export declare function ExportIcon(): import("react").JSX.Element;
+/** Iconsax "Bank" — conta bancária / destino de saque (o prédio genérico é o BuildingIcon). */
+export declare function BankIcon(): import("react").JSX.Element;
+/** Iconsax "MoneySend" — dinheiro saindo (saque). O ExportIcon é o de exportação de arquivo. */
+export declare function MoneySendIcon(): import("react").JSX.Element;
+/** Iconsax "MoneyRecive" — dinheiro entrando (recebíveis, liberações). */
+export declare function MoneyReceiveIcon(): import("react").JSX.Element;
 export declare function ClipboardIcon(): import("react").JSX.Element;
 export declare function NoteIcon(): import("react").JSX.Element;
 export declare function DiscountIcon(): 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';
@@ -104,6 +105,7 @@ export { SelectStackedArea } from './SelectStackedArea';
 export { SelectComboChart } from './SelectComboChart';
 export { SelectDonut } from './SelectDonut';
 export { SelectColumnChart } from './SelectColumnChart';
+export { SelectChartLegend } from './SelectChartLegend';
 export { SelectFunnel } from './SelectFunnel';
 export { SelectGauge } from './SelectGauge';
 export { SelectHeatmap } from './SelectHeatmap';
@@ -204,7 +206,7 @@ export type { ComboboxOption } from './SelectCombobox';
 export type { SelectTheme } from './SelectThemeSwitcher';
 export type { SelectToastApi, SelectToastVariant } from './SelectToast';
 export type { SelectPreviewFrameProps } from './SelectPreviewFrame';
-export type { SelectBalanceCardProps, SelectBalanceBucket } from './SelectBalanceCard';
+export type { SelectBalanceCardProps, SelectBalanceBucket, SelectBalanceMeta } from './SelectBalanceCard';
 export type { SelectFeeBreakdownProps, SelectFeeLine } from './SelectFeeBreakdown';
 export type { SelectDatePickerProps, SelectDateRange, SelectDatePreset, SelectDateLocale } from './SelectDatePicker';
 export type { SelectDateRangeFieldProps, SelectDateRangeValue } from './SelectDateRangeField';
@@ -224,6 +226,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';
@@ -234,6 +237,8 @@ export type { SelectPaginationProps } from './SelectPagination';
 export type { SelectFilterDef } from './SelectFilterBar';
 export type { SelectTagOption } from './SelectTagSelect';
 export type { SelectChartSeries, SelectBarDatum, SelectDonutSegment, SelectFunnelStage } from './chartUtils';
+export type { SelectColumnChartProps, SelectColumnTooltip } from './SelectColumnChart';
+export type { SelectChartLegendProps, SelectChartLegendItem } from './SelectChartLegend';
 export type { SelectHeatmapRow } from './SelectHeatmap';
 export type { SelectProgressItem } from './SelectProgressList';
 export type { SelectRadialSeries } from './SelectRadialBar';