import { AdoptionProvider } from '@tour-kit/adoption';

<AdoptionProvider
  features={features}
  storage={{ type: 'localStorage', key: 'adoption' }}
  nudge={{ enabled: true, cooldownMs: 86400000, maxPerSession: 3 }}
  userId="user-123"
  onAdoption={(feature) => console.log('Adopted:', feature.name)}
  onChurn={(feature) => console.log('Churned:', feature.name)}
>
  {children}
</AdoptionProvider>

import { useFeature } from '@tour-kit/adoption';

const {
  feature,
  usage,
  isAdopted,
  status,
  useCount,
  trackUsage,
} = useFeature('feature-id');

import { useAdoptionStats } from '@tour-kit/adoption';

const {
  totalFeatures,
  adoptedCount,
  adoptionRate,
  byCategory,
  byStatus,
} = useAdoptionStats();

import { useNudge } from '@tour-kit/adoption';

const {
  currentNudge,
  queue,
  show,
  dismiss,
  skip,
} = useNudge();

import { useAdoptionAnalytics } from '@tour-kit/adoption';

const analytics = useAdoptionAnalytics();

import { AdoptionNudge } from '@tour-kit/adoption';

<AdoptionNudge
  position="bottom-right"
  delay={2000}
  size="default"
  render={({ feature, dismiss }) => <CustomNudge />}
/>

import { FeatureButton } from '@tour-kit/adoption';

<FeatureButton
  featureId="feature-export"
  onClick={handleExport}
  variant="default"
>
  Export
</FeatureButton>

import { IfNotAdopted, IfAdopted } from '@tour-kit/adoption';

<IfNotAdopted featureId="feature-search">
  <NewFeatureBadge>New!</NewFeatureBadge>
</IfNotAdopted>

<IfAdopted featureId="feature-search">
  <span>Power user!</span>
</IfAdopted>

import { NewFeatureBadge } from '@tour-kit/adoption';

<NewFeatureBadge variant="default" size="sm">
  New
</NewFeatureBadge>

import { AdoptionDashboard } from '@tour-kit/adoption';

<AdoptionDashboard features={features} />

import { AdoptionStatsGrid } from '@tour-kit/adoption';

<AdoptionStatsGrid />

import { AdoptionTable } from '@tour-kit/adoption';

<AdoptionTable
  sortable
  filterable
  onRowClick={(feature) => {}}
/>

import { AdoptionCategoryChart } from '@tour-kit/adoption';

<AdoptionCategoryChart type="bar" />

interface Feature {
  id: string;
  name: string;
  trigger: string | { event: string } | (() => void);
  adoptionCriteria?: AdoptionCriteria;
  resources?: FeatureResources;
  priority?: number;
  category?: string;
  description?: string;
  premium?: boolean;
}

interface AdoptionCriteria {
  minUses?: number;
  recencyDays?: number;
  custom?: (usage: FeatureUsage) => boolean;
}

type AdoptionStatus = 'not_started' | 'exploring' | 'adopted' | 'churned';

interface FeatureUsage {
  featureId: string;
  useCount: number;
  firstUsedAt: Date | null;
  lastUsedAt: Date | null;
  adoptedAt: Date | null;
}