/**
 * Canonical step keys for the WORDPRESS platform. Mirrors
 * ``PLATFORM_STEPS.WORDPRESS`` in dashboard-api.
 */
export const WORDPRESS_STEP_KEYS = {
  CUSTOMIZE_POPUP: 'customize_popup',
  RUN_AI_VISIBILITY: 'run_ai_visibility',
  KNOWLEDGE_BASE: 'knowledge_base',
} as const;

export type WordpressStepKey =
  (typeof WORDPRESS_STEP_KEYS)[keyof typeof WORDPRESS_STEP_KEYS];

export interface StepperStep {
  key: string;
  label: string;
  to: string;
  tooltip?: string;
}

/**
 * Ordered onboarding steps shown in the Dashboard stepper. The key order
 * mirrors ``PLATFORM_STEPS.WORDPRESS`` so the sequential gating stays in
 * lockstep with backend state.
 */
export const WORDPRESS_STEPS: ReadonlyArray<StepperStep> = [
  {
    key: WORDPRESS_STEP_KEYS.RUN_AI_VISIBILITY,
    label: 'Run AI Visibility',
    to: '/ai-visibility?settings=open',
  },
  {
    key: WORDPRESS_STEP_KEYS.CUSTOMIZE_POPUP,
    label: 'Customize Agent',
    to: '/customization',
  },
  {
    key: WORDPRESS_STEP_KEYS.KNOWLEDGE_BASE,
    label: 'Knowledge base',
    to: '/knowledge-base',
    tooltip:
      'Optional. This step marks itself complete the moment you open the Knowledge Base page - no documents required.',
  },
];

export const MINUTES_PER_STEP: number = 2;