@quantabit/retention-sdk 1.0.0

package/dist/index.esm.js

@@ -0,0 +1,1142 @@
+import { BaseApiClient } from '@quantabit/sdk-config';
+import React, { useState, useCallback, useEffect, useMemo } from 'react';
+
+/**
+ * Retention SDK - API 客户端
+ * 用户留存分析系统后端接口封装
+ * 
+ * 使用 BaseApiClient 基类简化代码
+ */
+
+
+/**
+ * 留存 API 客户端
+ */
+class RetentionApiClient extends BaseApiClient {
+  constructor(config = {}) {
+    super('/retention', config);
+  }
+
+  // ============ 留存分析 ============
+
+  /**
+   * 获取留存概览
+   * @param {Object} params - 查询参数
+   */
+  async getOverview(params = {}) {
+    return this.get('/overview', params);
+  }
+
+  /**
+   * 获取留存率
+   * @param {Object} params - 分析参数
+   */
+  async getRetentionRate(params = {}) {
+    return this.post('/rate', params);
+  }
+
+  /**
+   * 获取留存趋势
+   * @param {Object} params - 查询参数
+   */
+  async getRetentionTrend(params = {}) {
+    return this.get('/trend', params);
+  }
+
+  /**
+   * 获取日留存
+   * @param {Object} params - 查询参数
+   */
+  async getDailyRetention(params = {}) {
+    return this.get('/daily', params);
+  }
+
+  /**
+   * 获取周留存
+   * @param {Object} params - 查询参数
+   */
+  async getWeeklyRetention(params = {}) {
+    return this.get('/weekly', params);
+  }
+
+  /**
+   * 获取月留存
+   * @param {Object} params - 查询参数
+   */
+  async getMonthlyRetention(params = {}) {
+    return this.get('/monthly', params);
+  }
+
+  // ============ Cohort 分析 ============
+
+  /**
+   * 获取 Cohort 分析
+   * @param {Object} params - 分析参数
+   */
+  async getCohortAnalysis(params = {}) {
+    return this.post('/cohort', params);
+  }
+
+  /**
+   * 获取 Cohort 列表
+   * @param {Object} params - 查询参数
+   */
+  async getCohorts(params = {}) {
+    return this.get('/cohorts', params);
+  }
+
+  /**
+   * 创建 Cohort
+   * @param {Object} cohort - Cohort 定义
+   */
+  async createCohort(cohort) {
+    return this.post('/cohorts', cohort);
+  }
+
+  /**
+   * 对比 Cohort
+   * @param {string[]} cohortIds - Cohort ID 列表
+   * @param {Object} params - 对比参数
+   */
+  async compareCohorts(cohortIds, params = {}) {
+    return this.post('/cohorts/compare', {
+      cohort_ids: cohortIds,
+      ...params
+    });
+  }
+
+  // ============ 流失分析 ============
+
+  /**
+   * 获取流失用户
+   * @param {Object} params - 查询参数
+   */
+  async getChurnedUsers(params = {}) {
+    return this.get('/churned', params);
+  }
+
+  /**
+   * 获取流失原因分析
+   * @param {Object} params - 分析参数
+   */
+  async getChurnReasons(params = {}) {
+    return this.get('/churned/reasons', params);
+  }
+
+  /**
+   * 获取流失预警
+   * @param {Object} params - 查询参数
+   */
+  async getChurnRiskUsers(params = {}) {
+    return this.get('/churn-risk', params);
+  }
+
+  /**
+   * 获取流失趋势
+   * @param {Object} params - 查询参数
+   */
+  async getChurnTrend(params = {}) {
+    return this.get('/churned/trend', params);
+  }
+
+  // ============ LTV 分析 ============
+
+  /**
+   * 获取 LTV 概览
+   * @param {Object} params - 查询参数
+   */
+  async getLTVOverview(params = {}) {
+    return this.get('/ltv/overview', params);
+  }
+
+  /**
+   * 获取用户 LTV
+   * @param {string} userId - 用户 ID
+   */
+  async getUserLTV(userId) {
+    return this.get(`/ltv/users/${userId}`);
+  }
+
+  /**
+   * 获取 LTV 分布
+   * @param {Object} params - 查询参数
+   */
+  async getLTVDistribution(params = {}) {
+    return this.get('/ltv/distribution', params);
+  }
+
+  /**
+   * 预测 LTV
+   * @param {Object} params - 预测参数
+   */
+  async predictLTV(params = {}) {
+    return this.post('/ltv/predict', params);
+  }
+
+  // ============ 分组分析 ============
+
+  /**
+   * 按属性分组分析
+   * @param {string} property - 分组属性
+   * @param {Object} params - 分析参数
+   */
+  async analyzeByProperty(property, params = {}) {
+    return this.post('/analyze/group', {
+      property,
+      ...params
+    });
+  }
+
+  /**
+   * 按人群分析
+   * @param {string} segmentId - 人群 ID
+   * @param {Object} params - 分析参数
+   */
+  async analyzeBySegment(segmentId, params = {}) {
+    return this.post('/analyze/segment', {
+      segment_id: segmentId,
+      ...params
+    });
+  }
+
+  // ============ 报表导出 ============
+
+  /**
+   * 导出留存报告
+   * @param {Object} options - 导出选项
+   */
+  async exportReport(options) {
+    return this.post('/export', options);
+  }
+}
+
+// 创建默认实例
+const retentionApi = new RetentionApiClient();
+
+/**
+ * Retention SDK - 类型定义
+ */
+
+// 留存周期类型
+const RetentionPeriod = {
+  DAY_1: 'day_1',
+  DAY_3: 'day_3',
+  DAY_7: 'day_7',
+  DAY_14: 'day_14',
+  DAY_30: 'day_30',
+  DAY_60: 'day_60',
+  DAY_90: 'day_90'
+};
+const CohortType = {};
+const ChurnRisk = {};
+
+/**
+ * Retention SDK - 国际化
+ * Cohort留存分析多语言支持
+ */
+
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+const messages = {
+  zh: {
+    // 留存
+    retention: '留存',
+    retentionRate: '留存率',
+    retentionAnalysis: '留存分析',
+    cohortAnalysis: 'Cohort分析',
+    // 时间
+    day1: '次日',
+    day3: '3日',
+    day7: '7日',
+    day14: '14日',
+    day30: '30日',
+    day60: '60日',
+    day90: '90日',
+    // 用户群
+    cohort: 'Cohort',
+    cohorts: '用户群',
+    newUsers: '新用户',
+    activeUsers: '活跃用户',
+    paidUsers: '付费用户',
+    // 指标
+    users: '用户数',
+    retention: '留存',
+    churn: '流失',
+    churnRate: '流失率',
+    lifetime: '生命周期',
+    ltv: 'LTV',
+    averageLtv: '平均LTV',
+    // 分析维度
+    byDate: '按日期',
+    byChannel: '按渠道',
+    byPlatform: '按平台',
+    byRegion: '按地区',
+    byVersion: '按版本',
+    // 图表
+    heatmap: '热力图',
+    curve: '曲线图',
+    table: '表格',
+    // 时间范围
+    timeRange: '时间范围',
+    last7Days: '近7天',
+    last14Days: '近14天',
+    last30Days: '近30天',
+    last90Days: '近90天',
+    lastYear: '近一年',
+    custom: '自定义',
+    // 对比
+    comparison: '对比分析',
+    benchmark: '基准',
+    vsLastPeriod: '环比',
+    vsLastYear: '同比',
+    // 洞察
+    insights: '洞察',
+    trend: '趋势',
+    improving: '改善中',
+    declining: '下降中',
+    stable: '稳定',
+    // 状态
+    loading: '加载中...',
+    noData: '暂无数据',
+    error: '加载失败',
+    // 操作
+    export: '导出',
+    refresh: '刷新',
+    filter: '筛选',
+    // 预测
+    forecast: '预测',
+    predictedRetention: '预测留存',
+    confidence: '置信度'
+  },
+  en: {
+    retention: 'Retention',
+    retentionRate: 'Retention Rate',
+    retentionAnalysis: 'Retention Analysis',
+    cohortAnalysis: 'Cohort Analysis',
+    day1: 'Day 1',
+    day3: 'Day 3',
+    day7: 'Day 7',
+    day14: 'Day 14',
+    day30: 'Day 30',
+    day60: 'Day 60',
+    day90: 'Day 90',
+    cohort: 'Cohort',
+    cohorts: 'Cohorts',
+    newUsers: 'New Users',
+    activeUsers: 'Active Users',
+    paidUsers: 'Paid Users',
+    users: 'Users',
+    churn: 'Churn',
+    churnRate: 'Churn Rate',
+    lifetime: 'Lifetime',
+    ltv: 'LTV',
+    averageLtv: 'Average LTV',
+    byDate: 'By Date',
+    byChannel: 'By Channel',
+    byPlatform: 'By Platform',
+    byRegion: 'By Region',
+    byVersion: 'By Version',
+    heatmap: 'Heatmap',
+    curve: 'Curve',
+    table: 'Table',
+    timeRange: 'Time Range',
+    last7Days: 'Last 7 Days',
+    last14Days: 'Last 14 Days',
+    last30Days: 'Last 30 Days',
+    last90Days: 'Last 90 Days',
+    lastYear: 'Last Year',
+    custom: 'Custom',
+    comparison: 'Comparison',
+    benchmark: 'Benchmark',
+    vsLastPeriod: 'vs Last Period',
+    vsLastYear: 'vs Last Year',
+    insights: 'Insights',
+    trend: 'Trend',
+    improving: 'Improving',
+    declining: 'Declining',
+    stable: 'Stable',
+    loading: 'Loading...',
+    noData: 'No Data',
+    error: 'Error',
+    export: 'Export',
+    refresh: 'Refresh',
+    filter: 'Filter',
+    forecast: 'Forecast',
+    predictedRetention: 'Predicted Retention',
+    confidence: 'Confidence'
+  },
+  ja: {
+    retention: 'リテンション',
+    retentionRate: 'リテンション率',
+    retentionAnalysis: 'リテンション分析',
+    cohortAnalysis: 'コホート分析',
+    day1: '翌日',
+    day3: '3日後',
+    day7: '7日後',
+    day14: '14日後',
+    day30: '30日後',
+    day60: '60日後',
+    day90: '90日後',
+    cohort: 'コホート',
+    cohorts: 'コホート',
+    newUsers: '新規ユーザー',
+    activeUsers: 'アクティブユーザー',
+    paidUsers: '課金ユーザー',
+    users: 'ユーザー数',
+    churn: '離脱',
+    churnRate: '離脱率',
+    lifetime: 'ライフタイム',
+    ltv: 'LTV',
+    averageLtv: '平均LTV',
+    byDate: '日付別',
+    byChannel: 'チャネル別',
+    byPlatform: 'プラットフォーム別',
+    byRegion: '地域別',
+    byVersion: 'バージョン別',
+    heatmap: 'ヒートマップ',
+    curve: '曲線',
+    table: 'テーブル',
+    timeRange: '期間',
+    last7Days: '過去7日間',
+    last14Days: '過去14日間',
+    last30Days: '過去30日間',
+    last90Days: '過去90日間',
+    lastYear: '過去1年間',
+    custom: 'カスタム',
+    comparison: '比較',
+    benchmark: 'ベンチマーク',
+    vsLastPeriod: '前期比',
+    vsLastYear: '前年比',
+    insights: 'インサイト',
+    trend: 'トレンド',
+    improving: '改善中',
+    declining: '低下中',
+    stable: '安定',
+    loading: '読み込み中...',
+    noData: 'データなし',
+    error: 'エラー',
+    export: 'エクスポート',
+    refresh: '更新',
+    filter: 'フィルター',
+    forecast: '予測',
+    predictedRetention: '予測リテンション',
+    confidence: '信頼度'
+  },
+  ko: {
+    retention: '리텐션',
+    retentionRate: '리텐션율',
+    retentionAnalysis: '리텐션 분석',
+    cohortAnalysis: '코호트 분석',
+    day1: 'D+1',
+    day3: 'D+3',
+    day7: 'D+7',
+    day14: 'D+14',
+    day30: 'D+30',
+    day60: 'D+60',
+    day90: 'D+90',
+    cohort: '코호트',
+    cohorts: '코호트',
+    newUsers: '신규 사용자',
+    activeUsers: '활성 사용자',
+    paidUsers: '결제 사용자',
+    users: '사용자 수',
+    churn: '이탈',
+    churnRate: '이탈률',
+    lifetime: '생애 주기',
+    ltv: 'LTV',
+    averageLtv: '평균 LTV',
+    byDate: '날짜별',
+    byChannel: '채널별',
+    byPlatform: '플랫폼별',
+    byRegion: '지역별',
+    byVersion: '버전별',
+    heatmap: '히트맵',
+    curve: '곡선',
+    table: '테이블',
+    timeRange: '기간',
+    last7Days: '최근 7일',
+    last14Days: '최근 14일',
+    last30Days: '최근 30일',
+    last90Days: '최근 90일',
+    lastYear: '최근 1년',
+    custom: '사용자 지정',
+    comparison: '비교',
+    benchmark: '벤치마크',
+    vsLastPeriod: '전기 대비',
+    vsLastYear: '전년 대비',
+    insights: '인사이트',
+    trend: '트렌드',
+    improving: '개선 중',
+    declining: '하락 중',
+    stable: '안정',
+    loading: '로딩 중...',
+    noData: '데이터 없음',
+    error: '오류',
+    export: '내보내기',
+    refresh: '새로고침',
+    filter: '필터',
+    forecast: '예측',
+    predictedRetention: '예측 리텐션',
+    confidence: '신뢰도'
+  }
+};
+let currentLanguage = 'zh';
+function setLanguage(lang) {
+  if (SUPPORTED_LANGUAGES.includes(lang)) currentLanguage = lang;
+}
+function getLanguage() {
+  return currentLanguage;
+}
+function t(key) {
+  return (messages[currentLanguage] || messages.en)[key] || key;
+}
+
+/**
+ * Retention SDK - React Hooks
+ * 留存分析相关的状态管理
+ */
+
+
+/**
+ * 获取留存数据
+ */
+function useRetention(options = {}) {
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const {
+    timeRange = '30d',
+    cohortType = 'new',
+    dimension = null
+  } = options;
+  const fetchRetention = useCallback(async () => {
+    try {
+      setLoading(true);
+      const response = await retentionApi.getRetention({
+        timeRange,
+        cohortType,
+        dimension
+      });
+      setData(response);
+      setError(null);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [timeRange, cohortType, dimension]);
+  useEffect(() => {
+    fetchRetention();
+  }, [fetchRetention]);
+
+  // 计算关键指标
+  const metrics = useMemo(() => {
+    if (!data || !data.cohorts) return null;
+    const cohorts = data.cohorts;
+    const avgDay1 = cohorts.reduce((sum, c) => sum + (c.day1 || 0), 0) / cohorts.length;
+    const avgDay7 = cohorts.reduce((sum, c) => sum + (c.day7 || 0), 0) / cohorts.length;
+    const avgDay30 = cohorts.reduce((sum, c) => sum + (c.day30 || 0), 0) / cohorts.length;
+    return {
+      averageDay1: avgDay1,
+      averageDay7: avgDay7,
+      averageDay30: avgDay30,
+      totalCohorts: cohorts.length,
+      totalUsers: cohorts.reduce((sum, c) => sum + (c.users || 0), 0)
+    };
+  }, [data]);
+  return {
+    data,
+    metrics,
+    loading,
+    error,
+    refresh: fetchRetention
+  };
+}
+
+/**
+ * Cohort分析
+ */
+function useCohortAnalysis(options = {}) {
+  const [cohorts, setCohorts] = useState([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const {
+    startDate,
+    endDate,
+    granularity = 'day'
+  } = options;
+  const analyze = useCallback(async () => {
+    try {
+      setLoading(true);
+      const response = await retentionApi.getCohortAnalysis({
+        startDate,
+        endDate,
+        granularity
+      });
+      setCohorts(response.cohorts || []);
+      setError(null);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [startDate, endDate, granularity]);
+  useEffect(() => {
+    if (startDate && endDate) {
+      analyze();
+    }
+  }, [analyze, startDate, endDate]);
+  return {
+    cohorts,
+    loading,
+    error,
+    refresh: analyze
+  };
+}
+
+/**
+ * 留存曲线
+ */
+function useRetentionCurve(cohortId, options = {}) {
+  const [curve, setCurve] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const {
+    days = 30
+  } = options;
+  const fetchCurve = useCallback(async () => {
+    if (!cohortId) return;
+    try {
+      setLoading(true);
+      const response = await retentionApi.getRetentionCurve(cohortId, {
+        days
+      });
+      setCurve(response);
+      setError(null);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [cohortId, days]);
+  useEffect(() => {
+    fetchCurve();
+  }, [fetchCurve]);
+  return {
+    curve,
+    loading,
+    error,
+    refresh: fetchCurve
+  };
+}
+
+/**
+ * 留存对比
+ */
+function useRetentionComparison(options = {}) {
+  const [comparison, setComparison] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const {
+    segments = [],
+    periods = []
+  } = options;
+  const compare = useCallback(async () => {
+    try {
+      setLoading(true);
+      const response = await retentionApi.compare({
+        segments,
+        periods
+      });
+      setComparison(response);
+      setError(null);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [segments, periods]);
+  useEffect(() => {
+    if (segments.length > 0 || periods.length > 0) {
+      compare();
+    }
+  }, [compare, segments, periods]);
+  return {
+    comparison,
+    loading,
+    error,
+    refresh: compare
+  };
+}
+
+/**
+ * 流失分析
+ */
+function useChurnAnalysis(options = {}) {
+  const [churnData, setChurnData] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const {
+    timeRange = '30d',
+    riskThreshold = 0.7
+  } = options;
+  const analyze = useCallback(async () => {
+    try {
+      setLoading(true);
+      const response = await retentionApi.getChurnAnalysis({
+        timeRange,
+        riskThreshold
+      });
+      setChurnData(response);
+      setError(null);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [timeRange, riskThreshold]);
+  useEffect(() => {
+    analyze();
+  }, [analyze]);
+
+  // 高风险用户
+  const atRiskUsers = useMemo(() => {
+    return churnData?.users?.filter(u => u.churnRisk >= riskThreshold) || [];
+  }, [churnData, riskThreshold]);
+  return {
+    churnData,
+    atRiskUsers,
+    loading,
+    error,
+    refresh: analyze
+  };
+}
+
+/**
+ * LTV分析
+ */
+function useLtvAnalysis(options = {}) {
+  const [ltvData, setLtvData] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const {
+    cohortType = 'all',
+    timeRange = '90d'
+  } = options;
+  const analyze = useCallback(async () => {
+    try {
+      setLoading(true);
+      const response = await retentionApi.getLtvAnalysis({
+        cohortType,
+        timeRange
+      });
+      setLtvData(response);
+      setError(null);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [cohortType, timeRange]);
+  useEffect(() => {
+    analyze();
+  }, [analyze]);
+  return {
+    ltvData,
+    loading,
+    error,
+    refresh: analyze
+  };
+}
+
+/**
+ * 留存预测
+ */
+function useRetentionForecast(cohortId, options = {}) {
+  const [forecast, setForecast] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const {
+    forecastDays = 30
+  } = options;
+  const predict = useCallback(async () => {
+    if (!cohortId) return;
+    try {
+      setLoading(true);
+      const response = await retentionApi.forecast(cohortId, {
+        forecastDays
+      });
+      setForecast(response);
+      setError(null);
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [cohortId, forecastDays]);
+  useEffect(() => {
+    predict();
+  }, [predict]);
+  return {
+    forecast,
+    loading,
+    error,
+    refresh: predict
+  };
+}
+
+/**
+ * Retention SDK - React 组件
+ * 留存分析可视化组件
+ */
+
+
+/**
+ * Cohort热力图
+ */
+function CohortHeatmap({
+  data,
+  showLabels = true,
+  colorScheme = 'blue'
+}) {
+  if (!data || !data.cohorts || data.cohorts.length === 0) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-retention-empty"
+    }, t('noData'));
+  }
+  const {
+    cohorts,
+    days
+  } = data;
+
+  // 获取颜色
+  const getColor = value => {
+    if (value === null || value === undefined) return 'transparent';
+    const intensity = Math.min(1, Math.max(0, value));
+    if (colorScheme === 'green') {
+      return `rgba(16, 185, 129, ${0.1 + intensity * 0.9})`;
+    }
+    return `rgba(99, 102, 241, ${0.1 + intensity * 0.9})`;
+  };
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-heatmap"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-heatmap-header"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-heatmap-label"
+  }, t('cohort')), days.map((day, i) => /*#__PURE__*/React.createElement("div", {
+    key: i,
+    className: "eco-retention-heatmap-day"
+  }, t(`day${day}`) || `D+${day}`))), /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-heatmap-body"
+  }, cohorts.map((cohort, rowIndex) => /*#__PURE__*/React.createElement("div", {
+    key: cohort.date || rowIndex,
+    className: "eco-retention-heatmap-row"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-heatmap-cohort"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-retention-cohort-date"
+  }, cohort.date), /*#__PURE__*/React.createElement("span", {
+    className: "eco-retention-cohort-users"
+  }, cohort.users.toLocaleString())), days.map((day, colIndex) => {
+    const value = cohort[`day${day}`];
+    return /*#__PURE__*/React.createElement("div", {
+      key: colIndex,
+      className: "eco-retention-heatmap-cell",
+      style: {
+        backgroundColor: getColor(value)
+      },
+      title: value !== null ? `${(value * 100).toFixed(1)}%` : ''
+    }, showLabels && value !== null && /*#__PURE__*/React.createElement("span", {
+      className: "eco-retention-cell-value"
+    }, (value * 100).toFixed(0), "%"));
+  })))), /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-heatmap-legend"
+  }, /*#__PURE__*/React.createElement("span", null, "0%"), /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-legend-gradient"
+  }), /*#__PURE__*/React.createElement("span", null, "100%")));
+}
+
+/**
+ * 留存曲线图
+ */
+function RetentionCurve({
+  data,
+  showBenchmark = false,
+  benchmarkData = null
+}) {
+  if (!data || !data.points || data.points.length === 0) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-retention-empty"
+    }, t('noData'));
+  }
+  const {
+    points
+  } = data;
+  const pathPoints = points.map((p, i) => {
+    const x = i / (points.length - 1) * 100;
+    const y = 100 - p.value * 100;
+    return `${x},${y}`;
+  }).join(' ');
+  const benchmarkPoints = benchmarkData?.points?.map((p, i) => {
+    const x = i / (benchmarkData.points.length - 1) * 100;
+    const y = 100 - p.value * 100;
+    return `${x},${y}`;
+  }).join(' ');
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-curve"
+  }, /*#__PURE__*/React.createElement("svg", {
+    className: "eco-retention-curve-svg",
+    viewBox: "0 0 100 100",
+    preserveAspectRatio: "none"
+  }, /*#__PURE__*/React.createElement("defs", null, /*#__PURE__*/React.createElement("linearGradient", {
+    id: "retentionGradient",
+    x1: "0%",
+    y1: "0%",
+    x2: "0%",
+    y2: "100%"
+  }, /*#__PURE__*/React.createElement("stop", {
+    offset: "0%",
+    stopColor: "#6366f1",
+    stopOpacity: "0.3"
+  }), /*#__PURE__*/React.createElement("stop", {
+    offset: "100%",
+    stopColor: "#6366f1",
+    stopOpacity: "0"
+  }))), [25, 50, 75].map(y => /*#__PURE__*/React.createElement("line", {
+    key: y,
+    x1: "0",
+    y1: y,
+    x2: "100",
+    y2: y,
+    stroke: "#e2e8f0",
+    strokeWidth: "0.5",
+    vectorEffect: "non-scaling-stroke"
+  })), showBenchmark && benchmarkPoints && /*#__PURE__*/React.createElement("polyline", {
+    points: benchmarkPoints,
+    fill: "none",
+    stroke: "#94a3b8",
+    strokeWidth: "2",
+    strokeDasharray: "4,4",
+    vectorEffect: "non-scaling-stroke"
+  }), /*#__PURE__*/React.createElement("polygon", {
+    points: `0,100 ${pathPoints} 100,100`,
+    fill: "url(#retentionGradient)"
+  }), /*#__PURE__*/React.createElement("polyline", {
+    points: pathPoints,
+    fill: "none",
+    stroke: "#6366f1",
+    strokeWidth: "2",
+    vectorEffect: "non-scaling-stroke"
+  }), points.map((p, i) => {
+    const x = i / (points.length - 1) * 100;
+    const y = 100 - p.value * 100;
+    return /*#__PURE__*/React.createElement("circle", {
+      key: i,
+      cx: x,
+      cy: y,
+      r: "3",
+      fill: "#6366f1",
+      vectorEffect: "non-scaling-stroke"
+    });
+  })), /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-curve-labels"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-curve-y-labels"
+  }, /*#__PURE__*/React.createElement("span", null, "100%"), /*#__PURE__*/React.createElement("span", null, "75%"), /*#__PURE__*/React.createElement("span", null, "50%"), /*#__PURE__*/React.createElement("span", null, "25%"), /*#__PURE__*/React.createElement("span", null, "0%")), /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-curve-x-labels"
+  }, points.filter((_, i) => i % 7 === 0 || i === points.length - 1).map((p, i) => /*#__PURE__*/React.createElement("span", {
+    key: i
+  }, "D+", p.day)))));
+}
+
+/**
+ * 留存指标卡片
+ */
+function RetentionMetricCard({
+  title,
+  value,
+  trend,
+  benchmark
+}) {
+  const trendClass = trend > 0 ? 'up' : trend < 0 ? 'down' : 'stable';
+  const vsBenchmark = benchmark ? value - benchmark : null;
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-metric-card"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-metric-title"
+  }, title), /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-metric-value"
+  }, typeof value === 'number' ? `${(value * 100).toFixed(1)}%` : value), /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-metric-footer"
+  }, trend !== undefined && /*#__PURE__*/React.createElement("span", {
+    className: `eco-retention-metric-trend ${trendClass}`
+  }, trend > 0 ? '↑' : trend < 0 ? '↓' : '–', Math.abs(trend * 100).toFixed(1), "%"), vsBenchmark !== null && /*#__PURE__*/React.createElement("span", {
+    className: `eco-retention-metric-benchmark ${vsBenchmark >= 0 ? 'positive' : 'negative'}`
+  }, "vs ", t('benchmark'), ": ", vsBenchmark >= 0 ? '+' : '', (vsBenchmark * 100).toFixed(1), "%")));
+}
+
+/**
+ * 留存概览面板
+ */
+function RetentionOverview({
+  timeRange = '30d'
+}) {
+  const {
+    data,
+    metrics,
+    loading,
+    error
+  } = useRetention({
+    timeRange
+  });
+  if (loading) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-retention-loading"
+    }, /*#__PURE__*/React.createElement("div", {
+      className: "eco-retention-spinner"
+    }), /*#__PURE__*/React.createElement("span", null, t('loading')));
+  }
+  if (error) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-retention-error"
+    }, error);
+  }
+  if (!metrics) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-retention-empty"
+    }, t('noData'));
+  }
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-overview"
+  }, /*#__PURE__*/React.createElement("h3", {
+    className: "eco-retention-overview-title"
+  }, t('retentionAnalysis')), /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-metrics-grid"
+  }, /*#__PURE__*/React.createElement(RetentionMetricCard, {
+    title: t('day1'),
+    value: metrics.averageDay1
+  }), /*#__PURE__*/React.createElement(RetentionMetricCard, {
+    title: t('day7'),
+    value: metrics.averageDay7
+  }), /*#__PURE__*/React.createElement(RetentionMetricCard, {
+    title: t('day30'),
+    value: metrics.averageDay30
+  }), /*#__PURE__*/React.createElement(RetentionMetricCard, {
+    title: t('users'),
+    value: metrics.totalUsers.toLocaleString()
+  })));
+}
+
+/**
+ * 时间范围选择器
+ */
+function TimeRangeSelector({
+  value,
+  onChange
+}) {
+  const options = [{
+    id: 'last7Days',
+    label: t('last7Days')
+  }, {
+    id: 'last14Days',
+    label: t('last14Days')
+  }, {
+    id: 'last30Days',
+    label: t('last30Days')
+  }, {
+    id: 'last90Days',
+    label: t('last90Days')
+  }, {
+    id: 'lastYear',
+    label: t('lastYear')
+  }];
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-timerange"
+  }, options.map(opt => /*#__PURE__*/React.createElement("button", {
+    key: opt.id,
+    className: `eco-retention-timerange-btn ${value === opt.id ? 'active' : ''}`,
+    onClick: () => onChange(opt.id)
+  }, opt.label)));
+}
+
+/**
+ * 视图切换器
+ */
+function ViewToggle({
+  value,
+  onChange
+}) {
+  const views = [{
+    id: 'heatmap',
+    label: t('heatmap'),
+    icon: '▦'
+  }, {
+    id: 'curve',
+    label: t('curve'),
+    icon: '📈'
+  }, {
+    id: 'table',
+    label: t('table'),
+    icon: '☷'
+  }];
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-view-toggle"
+  }, views.map(view => /*#__PURE__*/React.createElement("button", {
+    key: view.id,
+    className: `eco-retention-view-btn ${value === view.id ? 'active' : ''}`,
+    onClick: () => onChange(view.id),
+    title: view.label
+  }, /*#__PURE__*/React.createElement("span", null, view.icon))));
+}
+
+/**
+ * 留存表格
+ */
+function RetentionTable({
+  data
+}) {
+  if (!data || !data.cohorts) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-retention-empty"
+    }, t('noData'));
+  }
+  const {
+    cohorts,
+    days
+  } = data;
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-retention-table-wrapper"
+  }, /*#__PURE__*/React.createElement("table", {
+    className: "eco-retention-table"
+  }, /*#__PURE__*/React.createElement("thead", null, /*#__PURE__*/React.createElement("tr", null, /*#__PURE__*/React.createElement("th", null, t('cohort')), /*#__PURE__*/React.createElement("th", null, t('users')), days.map(day => /*#__PURE__*/React.createElement("th", {
+    key: day
+  }, t(`day${day}`) || `D+${day}`)))), /*#__PURE__*/React.createElement("tbody", null, cohorts.map((cohort, index) => /*#__PURE__*/React.createElement("tr", {
+    key: cohort.date || index
+  }, /*#__PURE__*/React.createElement("td", {
+    className: "eco-retention-table-cohort"
+  }, cohort.date), /*#__PURE__*/React.createElement("td", {
+    className: "eco-retention-table-users"
+  }, cohort.users.toLocaleString()), days.map(day => {
+    const value = cohort[`day${day}`];
+    return /*#__PURE__*/React.createElement("td", {
+      key: day,
+      className: "eco-retention-table-value"
+    }, value !== null ? `${(value * 100).toFixed(1)}%` : '-');
+  }))))));
+}
+
+/**
+ * @quantabit/retention-sdk
+ * Retention Analytics SDK - Full Version
+ */
+
+const getRetention = (...args) => retentionApi.getRetention(...args);
+const getCohortAnalysis = (...args) => retentionApi.getCohortAnalysis(...args);
+const getRetentionCurve = (...args) => retentionApi.getRetentionCurve(...args);
+const compare = (...args) => retentionApi.compare(...args);
+const getChurnAnalysis = (...args) => retentionApi.getChurnAnalysis(...args);
+const getLtvAnalysis = (...args) => retentionApi.getLtvAnalysis(...args);
+const forecast = (...args) => retentionApi.forecast(...args);
+
+export { ChurnRisk, CohortHeatmap, CohortType, RetentionApiClient, RetentionCurve, RetentionMetricCard, RetentionOverview, RetentionPeriod, RetentionTable, SUPPORTED_LANGUAGES, TimeRangeSelector, ViewToggle, compare, forecast, getChurnAnalysis, getCohortAnalysis, getLanguage, getLtvAnalysis, getRetention, getRetentionCurve, messages, retentionApi, setLanguage, t, useChurnAnalysis, useCohortAnalysis, useLtvAnalysis, useRetention, useRetentionComparison, useRetentionCurve, useRetentionForecast };
+//# sourceMappingURL=index.esm.js.map