@salesmind-ai/design-system 0.2.1 → 0.3.0

package/dist/ExportMenu-C8qck5AT.d.ts

@@ -0,0 +1,311 @@
+import React__default from 'react';
+import { c as ReportMode, I as InsightType, A as AnalyticalState, D as DataStateDetails, s as TrendDirection } from './chart-types-BGVVO-zl.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface ReportShellProps {
+    /** Report title */
+    title?: string;
+    /** Report subtitle or date range */
+    subtitle?: string;
+    /** Report mode (executive = minimal detail, analyst = full detail) */
+    mode?: ReportMode;
+    /** Brand variant for theming */
+    brand?: string;
+    /** Callback when mode changes */
+    onModeChange?: (mode: ReportMode) => void;
+    /** Report content */
+    children: React__default.ReactNode;
+    /** Header actions (export, share, etc.) */
+    actions?: React__default.ReactNode;
+    /** Additional CSS class */
+    className?: string;
+}
+/**
+ * ReportShell is the root container for all reports.
+ * It provides mode context and establishes the report structure.
+ */
+declare const ReportShell: React__default.ForwardRefExoticComponent<ReportShellProps & React__default.RefAttributes<HTMLDivElement>>;
+
+interface ExecutiveThesisProps {
+    /** The main thesis statement - the single most important finding */
+    thesis: string;
+    /** Supporting context for the thesis */
+    context?: string;
+    /** Key metric supporting the thesis */
+    metric?: {
+        label: string;
+        value: string | number;
+        trend?: 'up' | 'down' | 'neutral';
+    };
+    /** AI-generated indicator */
+    aiGenerated?: boolean;
+    /** Additional CSS class */
+    className?: string;
+}
+/**
+ * ExecutiveThesis displays the single most important finding of a report.
+ * There should be exactly ONE of these per report, at the top.
+ *
+ * Composition Rule: R1 - ExecutiveThesis MUST appear exactly once, at the top.
+ */
+declare const ExecutiveThesis: React__default.ForwardRefExoticComponent<ExecutiveThesisProps & React__default.RefAttributes<HTMLElement>>;
+
+interface InsightBlockProps {
+    /** The type of insight - constrains allowed child charts */
+    type: InsightType;
+    /** The insight headline */
+    headline: string;
+    /** Supporting description */
+    description?: string;
+    /** Confidence score (0-100) */
+    confidence?: number;
+    /** Methodology notes (shown in analyst mode) */
+    methodology?: string;
+    /** Evidence charts (max 3 per composition rules) */
+    children: React__default.ReactNode;
+    /** Additional CSS class */
+    className?: string;
+}
+/**
+ * InsightBlock groups an insight with its supporting evidence.
+ *
+ * Composition Rules:
+ * - R2: InsightBlock MUST precede any chart it references
+ * - R3: Charts CANNOT appear without a parent InsightBlock
+ * - R6: Max 3 charts per InsightBlock
+ */
+declare const InsightBlock: React__default.ForwardRefExoticComponent<InsightBlockProps & React__default.RefAttributes<HTMLElement>>;
+
+interface EvidenceGroupProps {
+    /** Group title */
+    title?: string;
+    /** Layout direction */
+    layout?: 'row' | 'column' | 'grid';
+    /** Number of columns for grid layout */
+    columns?: 1 | 2 | 3;
+    /** Evidence charts (max 3 per composition rules) */
+    children: React__default.ReactNode;
+    /** Additional CSS class */
+    className?: string;
+}
+/**
+ * EvidenceGroup contains related charts under an InsightBlock.
+ *
+ * Composition Rule: R6 - Max 3 charts per InsightBlock (enforced via EvidenceGroup)
+ */
+declare const EvidenceGroup: React__default.ForwardRefExoticComponent<EvidenceGroupProps & React__default.RefAttributes<HTMLDivElement>>;
+
+interface ConfidenceIndicatorProps {
+    /** Confidence score (0-100) */
+    score: number;
+    /** Show the numeric score */
+    showScore?: boolean;
+    /** Show the label */
+    showLabel?: boolean;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS class */
+    className?: string;
+}
+/**
+ * ConfidenceIndicator displays the reliability score of an insight or data point.
+ * This is a guardrail component that helps users understand data quality.
+ */
+declare const ConfidenceIndicator: React__default.ForwardRefExoticComponent<ConfidenceIndicatorProps & React__default.RefAttributes<HTMLDivElement>>;
+
+interface DataCoverageBadgeProps {
+    /** Current sample size */
+    sampleSize: number;
+    /** Required minimum sample size */
+    requiredSize?: number;
+    /** Date range covered */
+    dateRange?: {
+        start: string;
+        end: string;
+    };
+    /** Show date range */
+    showDateRange?: boolean;
+    /** Size variant */
+    size?: 'sm' | 'md';
+    /** Additional CSS class */
+    className?: string;
+}
+/**
+ * DataCoverageBadge shows the sample size and optionally the date range of the data.
+ * This is a guardrail component that helps users understand data coverage.
+ */
+declare const DataCoverageBadge: React__default.ForwardRefExoticComponent<DataCoverageBadgeProps & React__default.RefAttributes<HTMLDivElement>>;
+
+interface DataStateIndicatorProps {
+    /** Current analytical state */
+    state: AnalyticalState;
+    /** Additional details about the state */
+    details?: DataStateDetails;
+    /** Show full details or compact */
+    variant?: 'compact' | 'full';
+    /** Action button handler */
+    onAction?: () => void;
+    /** Additional CSS class */
+    className?: string;
+}
+/**
+ * DataStateIndicator shows the analytical state of data (valid, insufficient, etc.).
+ * This is a guardrail component that prevents misleading outputs.
+ */
+declare const DataStateIndicator: React__default.ForwardRefExoticComponent<DataStateIndicatorProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Translatable labels for the MethodologyNote component. */
+interface MethodologyNoteLabels {
+    /** Title text and aria-label. @default "Methodology" */
+    title?: string;
+    /** Label for the sample size row. @default "Sample Size" */
+    sampleSize?: string;
+    /** Label for the data sources row. @default "Data Sources" */
+    dataSources?: string;
+    /** Label for the calculation row. @default "Calculation" */
+    calculation?: string;
+}
+interface MethodologyNoteProps {
+    /** Methodology description */
+    children: React__default.ReactNode;
+    /** Sample size (triggers automatic display if < 100) */
+    sampleSize?: number;
+    /** Data sources used */
+    sources?: string[];
+    /** Calculation method */
+    calculation?: string;
+    /** Always show regardless of mode */
+    forceShow?: boolean;
+    /** Additional CSS class */
+    className?: string;
+    /** Override default English labels for i18n. */
+    labels?: MethodologyNoteLabels;
+}
+/**
+ * MethodologyNote documents how data was collected and calculated.
+ *
+ * Composition Rule: R4 - MethodologyNote MUST appear if sample size < 100
+ */
+declare const MethodologyNote: React__default.ForwardRefExoticComponent<MethodologyNoteProps & React__default.RefAttributes<HTMLElement>>;
+
+interface CaveatBlockProps {
+    /** Caveat title/summary */
+    title?: string;
+    /** Caveat details */
+    children: React__default.ReactNode;
+    /** Severity level */
+    severity?: 'info' | 'warning' | 'critical';
+    /** Confidence score that triggered this caveat */
+    confidence?: number;
+    /** Always show regardless of mode */
+    forceShow?: boolean;
+    /** Additional CSS class */
+    className?: string;
+}
+/**
+ * CaveatBlock displays limitations and warnings about the data or analysis.
+ *
+ * Composition Rule: Required if confidence < 70%
+ */
+declare const CaveatBlock: React__default.ForwardRefExoticComponent<CaveatBlockProps & React__default.RefAttributes<HTMLElement>>;
+
+interface KeyMetricProps {
+    /** Metric title/label */
+    title: string;
+    /** Primary value */
+    value: string | number;
+    /** Value prefix (e.g., '$', '#') */
+    prefix?: string;
+    /** Value suffix (e.g., '%', 'users') */
+    suffix?: string;
+    /** Trend indicator */
+    trend?: {
+        value: number;
+        direction: TrendDirection;
+        label?: string;
+    };
+    /** Secondary metric */
+    secondary?: {
+        label: string;
+        value: string | number;
+    };
+    /** Sample size for data state */
+    sampleSize?: number;
+    /** Confidence score */
+    confidence?: number;
+    /** Click handler for drill-down */
+    onClick?: () => void;
+    /** Loading state */
+    loading?: boolean;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS class */
+    className?: string;
+}
+/**
+ * KeyMetric displays a single KPI with trend indicator and optional drill-down.
+ * This is an analytical component with built-in data state awareness.
+ */
+declare const KeyMetric: React__default.ForwardRefExoticComponent<KeyMetricProps & React__default.RefAttributes<HTMLDivElement>>;
+
+interface TrendIndicatorProps {
+    /** Percentage change */
+    value: number;
+    /** Override direction (auto-detected from value) */
+    direction?: TrendDirection;
+    /** Positive is good (green) or bad (red) */
+    positiveIsGood?: boolean;
+    /** Show arrow icon */
+    showIcon?: boolean;
+    /** Show the percentage sign */
+    showPercent?: boolean;
+    /** Size */
+    size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS class */
+    className?: string;
+}
+/**
+ * TrendIndicator shows directional change with color coding.
+ * Requires at least 2 data points to be meaningful.
+ */
+declare const TrendIndicator: React__default.ForwardRefExoticComponent<TrendIndicatorProps & React__default.RefAttributes<HTMLSpanElement>>;
+
+type ExportFormat = 'pdf' | 'csv' | 'xlsx' | 'pptx' | 'png' | 'json';
+interface ExportOption {
+    /** Export format */
+    format: ExportFormat;
+    /** Display label */
+    label: string;
+    /** Optional description */
+    description?: string;
+    /** Whether this option is disabled */
+    disabled?: boolean;
+}
+interface ExportMenuProps {
+    /** Available export options */
+    options?: ExportOption[];
+    /** Callback when an export option is selected */
+    onExport: (format: ExportFormat) => void;
+    /** Whether export is currently in progress */
+    isExporting?: boolean;
+    /** Button label */
+    label?: string;
+    /** Button size */
+    size?: 'sm' | 'md' | 'lg';
+    /** Button variant */
+    variant?: 'primary' | 'secondary' | 'outline';
+    /** Additional CSS class */
+    className?: string;
+    /** Disabled state */
+    disabled?: boolean;
+}
+/**
+ * ExportMenu provides a dropdown for exporting reports in various formats.
+ * This is an interface-only component - actual export logic is implemented at the app layer.
+ */
+declare function ExportMenu({ options, onExport, isExporting, label, size, variant, className, disabled, }: ExportMenuProps): react_jsx_runtime.JSX.Element;
+declare namespace ExportMenu {
+    var displayName: string;
+}
+
+export { CaveatBlock as C, DataCoverageBadge as D, EvidenceGroup as E, InsightBlock as I, KeyMetric as K, MethodologyNote as M, ReportShell as R, TrendIndicator as T, type CaveatBlockProps as a, ConfidenceIndicator as b, type ConfidenceIndicatorProps as c, type DataCoverageBadgeProps as d, DataStateIndicator as e, type DataStateIndicatorProps as f, type EvidenceGroupProps as g, ExecutiveThesis as h, type ExecutiveThesisProps as i, type ExportFormat as j, ExportMenu as k, type ExportMenuProps as l, type ExportOption as m, type InsightBlockProps as n, type KeyMetricProps as o, type MethodologyNoteLabels as p, type MethodologyNoteProps as q, type ReportShellProps as r, type TrendIndicatorProps as s };

package/dist/SectionShell-BfBw5q0Y.d.cts

@@ -0,0 +1,18 @@
+import React__default, { HTMLAttributes } from 'react';
+
+interface SectionHeaderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+    title?: React__default.ReactNode;
+    subtitle?: React__default.ReactNode;
+    eyebrow?: React__default.ReactNode;
+    align?: 'left' | 'center' | 'right';
+}
+declare const SectionHeader: React__default.ForwardRefExoticComponent<SectionHeaderProps & React__default.RefAttributes<HTMLDivElement>>;
+interface SectionShellProps extends HTMLAttributes<HTMLDivElement> {
+    background?: 'default' | 'muted' | 'brand' | 'transparent';
+    padding?: 'none' | 'sm' | 'md' | 'lg';
+    containerSize?: 'sm' | 'md' | 'lg' | 'xl' | 'fluid';
+    containerFluid?: boolean;
+}
+declare const SectionShell: React__default.ForwardRefExoticComponent<SectionShellProps & React__default.RefAttributes<HTMLDivElement>>;
+
+export { SectionHeader as S, type SectionHeaderProps as a, SectionShell as b, type SectionShellProps as c };

package/dist/SectionShell-BfBw5q0Y.d.ts

@@ -0,0 +1,18 @@
+import React__default, { HTMLAttributes } from 'react';
+
+interface SectionHeaderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+    title?: React__default.ReactNode;
+    subtitle?: React__default.ReactNode;
+    eyebrow?: React__default.ReactNode;
+    align?: 'left' | 'center' | 'right';
+}
+declare const SectionHeader: React__default.ForwardRefExoticComponent<SectionHeaderProps & React__default.RefAttributes<HTMLDivElement>>;
+interface SectionShellProps extends HTMLAttributes<HTMLDivElement> {
+    background?: 'default' | 'muted' | 'brand' | 'transparent';
+    padding?: 'none' | 'sm' | 'md' | 'lg';
+    containerSize?: 'sm' | 'md' | 'lg' | 'xl' | 'fluid';
+    containerFluid?: boolean;
+}
+declare const SectionShell: React__default.ForwardRefExoticComponent<SectionShellProps & React__default.RefAttributes<HTMLDivElement>>;
+
+export { SectionHeader as S, type SectionHeaderProps as a, SectionShell as b, type SectionShellProps as c };

package/dist/Select-BdZmK0Lt.d.cts

@@ -0,0 +1,66 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React__default from 'react';
+
+interface SelectProps {
+    /** Current selected value */
+    value?: string;
+    /** Default value for uncontrolled mode */
+    defaultValue?: string;
+    /** Callback when value changes */
+    onValueChange?: (value: string | null) => void;
+    /** Whether the select is disabled */
+    disabled?: boolean;
+    /** Whether the select is required */
+    required?: boolean;
+    /** Name for form submission */
+    name?: string;
+    /**
+     * Item label map for Value display resolution.
+     * When provided, Select.Value renders the label instead of the raw value.
+     * Accepts a record (e.g. `{ en: "English", fr: "French" }`) or an array
+     * of `{ value, label }` objects.
+     */
+    items?: Record<string, React__default.ReactNode> | ReadonlyArray<{
+        label: React__default.ReactNode;
+        value: string;
+    }>;
+    /** Children (SelectTrigger, SelectContent, etc.) */
+    children: React__default.ReactNode;
+}
+declare function Select({ value, defaultValue, onValueChange, disabled, required, name, items, children, }: SelectProps): react_jsx_runtime.JSX.Element;
+declare namespace Select {
+    var displayName: string;
+}
+interface SelectTriggerProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Placeholder text when no value selected */
+    placeholder?: string;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+}
+declare const SelectTrigger: React__default.ForwardRefExoticComponent<SelectTriggerProps & React__default.RefAttributes<HTMLButtonElement>>;
+interface SelectContentProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Positioning side */
+    side?: 'top' | 'bottom';
+    /** Side offset in pixels */
+    sideOffset?: number;
+    /** Alignment */
+    align?: 'start' | 'center' | 'end';
+}
+declare const SelectContent: React__default.ForwardRefExoticComponent<SelectContentProps & React__default.RefAttributes<HTMLDivElement>>;
+interface SelectItemProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Value for this option */
+    value: string;
+    /** Display text */
+    children: React__default.ReactNode;
+    /** Whether the item is disabled */
+    disabled?: boolean;
+}
+declare const SelectItem: React__default.ForwardRefExoticComponent<SelectItemProps & React__default.RefAttributes<HTMLDivElement>>;
+interface SelectGroupProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Group label */
+    label?: string;
+}
+declare const SelectGroup: React__default.ForwardRefExoticComponent<SelectGroupProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const SelectSeparator: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+export { Select as S, SelectContent as a, type SelectContentProps as b, SelectGroup as c, type SelectGroupProps as d, SelectItem as e, type SelectItemProps as f, type SelectProps as g, SelectSeparator as h, SelectTrigger as i, type SelectTriggerProps as j };

package/dist/Select-BdZmK0Lt.d.ts

@@ -0,0 +1,66 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React__default from 'react';
+
+interface SelectProps {
+    /** Current selected value */
+    value?: string;
+    /** Default value for uncontrolled mode */
+    defaultValue?: string;
+    /** Callback when value changes */
+    onValueChange?: (value: string | null) => void;
+    /** Whether the select is disabled */
+    disabled?: boolean;
+    /** Whether the select is required */
+    required?: boolean;
+    /** Name for form submission */
+    name?: string;
+    /**
+     * Item label map for Value display resolution.
+     * When provided, Select.Value renders the label instead of the raw value.
+     * Accepts a record (e.g. `{ en: "English", fr: "French" }`) or an array
+     * of `{ value, label }` objects.
+     */
+    items?: Record<string, React__default.ReactNode> | ReadonlyArray<{
+        label: React__default.ReactNode;
+        value: string;
+    }>;
+    /** Children (SelectTrigger, SelectContent, etc.) */
+    children: React__default.ReactNode;
+}
+declare function Select({ value, defaultValue, onValueChange, disabled, required, name, items, children, }: SelectProps): react_jsx_runtime.JSX.Element;
+declare namespace Select {
+    var displayName: string;
+}
+interface SelectTriggerProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Placeholder text when no value selected */
+    placeholder?: string;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+}
+declare const SelectTrigger: React__default.ForwardRefExoticComponent<SelectTriggerProps & React__default.RefAttributes<HTMLButtonElement>>;
+interface SelectContentProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Positioning side */
+    side?: 'top' | 'bottom';
+    /** Side offset in pixels */
+    sideOffset?: number;
+    /** Alignment */
+    align?: 'start' | 'center' | 'end';
+}
+declare const SelectContent: React__default.ForwardRefExoticComponent<SelectContentProps & React__default.RefAttributes<HTMLDivElement>>;
+interface SelectItemProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Value for this option */
+    value: string;
+    /** Display text */
+    children: React__default.ReactNode;
+    /** Whether the item is disabled */
+    disabled?: boolean;
+}
+declare const SelectItem: React__default.ForwardRefExoticComponent<SelectItemProps & React__default.RefAttributes<HTMLDivElement>>;
+interface SelectGroupProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Group label */
+    label?: string;
+}
+declare const SelectGroup: React__default.ForwardRefExoticComponent<SelectGroupProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const SelectSeparator: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+export { Select as S, SelectContent as a, type SelectContentProps as b, SelectGroup as c, type SelectGroupProps as d, SelectItem as e, type SelectItemProps as f, type SelectProps as g, SelectSeparator as h, SelectTrigger as i, type SelectTriggerProps as j };