@salesmind-ai/design-system 0.6.0 → 1.0.0

package/dist/chart-types-BGVVO-zl.d.ts

@@ -1,208 +0,0 @@
-/**
- * Insight types define the semantic category of an insight.
- * Each type constrains which charts can be used as evidence.
- */
-type InsightType = 'performance-delta' | 'behavioral-correlation' | 'funnel-leakage' | 'audience-mismatch' | 'message-fatigue' | 'psychological-resonance' | 'timing-pattern' | 'segment-outperformance' | 'anomaly-detection' | 'competitive-benchmark';
-/**
- * Analytical states represent the data quality status of a component.
- */
-type AnalyticalState = 'VALID' | 'INSUFFICIENT_SAMPLE' | 'LOW_CONFIDENCE' | 'PARTIAL_TIME_WINDOW' | 'DATA_SKEW_DETECTED' | 'CONFLICTING_SIGNALS' | 'INFERRED_NOT_OBSERVED' | 'STALE_DATA' | 'FIELD_MISSING' | 'CALCULATION_ERROR';
-/**
- * Report mode determines the level of detail shown.
- */
-type ReportMode = 'executive' | 'analyst';
-/**
- * Configuration for report mode features.
- */
-interface ReportModeConfig {
-    mode: ReportMode;
-    features: {
-        showMethodology: boolean;
-        showConfidenceScores: boolean;
-        showRawData: boolean;
-        showStatisticalTests: boolean;
-        chartDetailLevel: 'summary' | 'detailed';
-        maxInsightsShown: number;
-        allowDrilldown: boolean;
-    };
-}
-/**
- * Confidence level thresholds and labels.
- */
-type ConfidenceLevel = 'high' | 'moderate' | 'low' | 'insufficient';
-interface ConfidenceThreshold {
-    level: ConfidenceLevel;
-    min: number;
-    max: number;
-    label: string;
-    color: string;
-}
-/**
- * Data contract for analytical components.
- */
-interface DataContract {
-    requiredFields: string[];
-    optionalFields: string[];
-    minimums: {
-        sampleSize: number;
-        completeness: number;
-        timeSpan?: number;
-    };
-    fallbackBehavior: FallbackBehavior;
-}
-type FallbackBehavior = {
-    type: 'hide';
-} | {
-    type: 'disable';
-    message: string;
-} | {
-    type: 'warn';
-    severity: 'low' | 'medium' | 'high';
-} | {
-    type: 'substitute';
-    component: string;
-};
-/**
- * Insight type contract defining allowed charts and requirements.
- */
-interface InsightTypeContract {
-    type: InsightType;
-    allowedCharts: string[];
-    requiredFields: string[];
-    minSampleSize: number;
-    headlinePattern: string;
-    recommendationFormats: string[];
-}
-/**
- * Trend direction for metrics.
- */
-type TrendDirection = 'up' | 'down' | 'neutral';
-/**
- * State details for DataStateIndicator.
- */
-interface DataStateDetails {
-    sampleSize?: number;
-    requiredSize?: number;
-    confidence?: number;
-    missingFields?: string[];
-    staleDays?: number;
-    message?: string;
-}
-/**
- * Chart types supported by the report engine.
- */
-type ChartType = 'LineChart' | 'BarChart' | 'PieChart' | 'AreaChart' | 'FunnelChart' | 'HeatmapChart' | 'MBTIRadar' | 'MBTITypeGrid' | 'KeyMetric';
-/**
- * MBTI personality types.
- */
-type MBTIType = 'INTJ' | 'INTP' | 'ENTJ' | 'ENTP' | 'INFJ' | 'INFP' | 'ENFJ' | 'ENFP' | 'ISTJ' | 'ISFJ' | 'ESTJ' | 'ESFJ' | 'ISTP' | 'ISFP' | 'ESTP' | 'ESFP';
-
-/**
- * Chart intent defines the semantic purpose of visualization.
- * This is the primary classifier that governs switching rules.
- */
-type ChartIntent = 'trend' | 'comparison' | 'composition' | 'distribution' | 'relationship' | 'geo';
-/**
- * All supported chart types organized by intent.
- */
-type TrendChartType = 'line' | 'smooth_line' | 'area' | 'stacked_area' | 'area_100pct';
-type ComparisonChartType = 'bar' | 'column' | 'stacked_bar' | 'stacked_column' | 'column_100pct' | 'combo';
-type CompositionChartType = 'pie' | 'donut' | 'treemap';
-type DistributionChartType = 'histogram' | 'radar';
-type RelationshipChartType = 'scatter' | 'bubble' | 'heatmap';
-type GeoChartType = 'geo' | 'choropleth';
-/**
- * Union of all chart types
- */
-type ChartTypeId = TrendChartType | ComparisonChartType | CompositionChartType | DistributionChartType | RelationshipChartType | GeoChartType | 'funnel' | 'waterfall' | 'timeline';
-/**
- * Chart phase classification
- */
-type ChartPhase = 'mvp' | 'phase2' | 'phase3';
-interface ChartTypeMetadata {
-    id: ChartTypeId;
-    name: string;
-    description: string;
-    intent: ChartIntent;
-    phase: ChartPhase;
-    contract: ChartDataContract;
-    switchableTo: ChartTypeId[];
-    supportsStacking: boolean;
-    supportsMultipleSeries: boolean;
-    requiresTimeAxis: boolean;
-    maxCategories?: number;
-    maxSlices?: number;
-}
-interface ChartDataContract {
-    requiredDimensions: number;
-    requiredMeasures: number;
-    minDataPoints: number;
-    idealDataPoints: number;
-    maxDataPoints?: number;
-    allowNegativeValues: boolean;
-    requireNonZeroTotal: boolean;
-    warningThresholds: {
-        tooManyCategories?: number;
-        imbalancedRatio?: number;
-        sparseData?: number;
-    };
-    fallback: ChartFallbackBehavior;
-}
-type ChartFallbackBehavior = {
-    type: 'hide';
-} | {
-    type: 'show_kpi';
-    message: string;
-} | {
-    type: 'aggregate';
-    strategy: 'other_bucket' | 'top_n';
-} | {
-    type: 'warn';
-    message: string;
-};
-declare const CHART_REGISTRY: Record<ChartTypeId, ChartTypeMetadata>;
-/**
- * Maps intent to allowed chart types for switching.
- * Users can ONLY switch within the same intent family.
- */
-declare const INTENT_CHART_FAMILIES: Record<ChartIntent, ChartTypeId[]>;
-/**
- * Get allowed chart types for switching from a given type.
- */
-declare function getAllowedSwitchTargets(currentType: ChartTypeId): ChartTypeId[];
-/**
- * Check if switching from one chart type to another is allowed.
- */
-declare function canSwitchChart(from: ChartTypeId, to: ChartTypeId): boolean;
-interface ChartValidationResult {
-    isValid: boolean;
-    warnings: string[];
-    errors: string[];
-    suggestedType?: ChartTypeId;
-    fallbackAction?: ChartFallbackBehavior;
-}
-/**
- * Validate data against a chart's contract.
- */
-declare function validateChartData(chartType: ChartTypeId, data: unknown[], dimensions: string[], measures: string[]): ChartValidationResult;
-/**
- * Get MVP charts for a given intent.
- */
-declare function getMVPChartsForIntent(intent: ChartIntent): ChartTypeMetadata[];
-/**
- * Get the default chart type for an intent.
- */
-declare function getDefaultChartForIntent(intent: ChartIntent): ChartTypeId;
-/**
- * Suggest the best chart type for given data characteristics.
- */
-declare function suggestChartType(params: {
-    hasTimeAxis: boolean;
-    dimensionCount: number;
-    measureCount: number;
-    dataPointCount: number;
-    hasNegativeValues: boolean;
-    isSequential: boolean;
-}): ChartTypeId;
-
-export { type AnalyticalState as A, type ConfidenceThreshold as C, type DataStateDetails as D, type FallbackBehavior as F, type GeoChartType as G, type InsightType as I, type MBTIType as M, type ReportModeConfig as R, type TrendChartType as T, type InsightTypeContract as a, type ConfidenceLevel as b, type ReportMode as c, CHART_REGISTRY as d, type ChartDataContract as e, type ChartFallbackBehavior as f, type ChartIntent as g, type ChartPhase as h, type ChartType as i, type ChartTypeId as j, type ChartTypeMetadata as k, type ChartValidationResult as l, type ComparisonChartType as m, type CompositionChartType as n, type DataContract as o, type DistributionChartType as p, INTENT_CHART_FAMILIES as q, type RelationshipChartType as r, type TrendDirection as s, canSwitchChart as t, getAllowedSwitchTargets as u, getDefaultChartForIntent as v, getMVPChartsForIntent as w, suggestChartType as x, validateChartData as y };