/**
 * Config types for the `xMarketing` app.config.ts namespace.
 *
 * Exported so consumers and sibling layers can reference the shape
 * (config-typing convention, plan 21 §3). This is the *input* contract —
 * every field is optional so site overrides can set any subset.
 */

export interface XMarketingNavLink {
  label: string;
  to?: string;
  target?: string;
  children?: XMarketingNavLink[];
}

export interface XMarketingTrackingScript {
  /** Stable ID — used to dedupe re-injection. */
  id: string;
  /** External script URL (e.g. "https://www.googletagmanager.com/gtag/js?id=G-XXX"). */
  src?: string;
  /** Inline script body (no `src` required). */
  inline?: string;
  /** Consent category gate. "necessary" fires immediately; "analytics" / "marketing" gated. */
  category?: "necessary" | "analytics" | "marketing";
  /** Extra attributes applied to the injected <script>. */
  attrs?: Record<string, string>;
}

/**
 * Tracking entry — use the convenience IDs for the common tools
 * (GTM, GA4, Clarity) or `scripts[]` for everything else. Scripts
 * are injected only after the visitor grants consent for the
 * matching `category` (default: "analytics").
 */
export interface XMarketingTracking {
  /** Google Tag Manager container ID, e.g. "GTM-XXXXXXX". */
  gtmId?: string;
  /** Google Analytics 4 measurement ID, e.g. "G-XXXXXXXX". */
  ga4Id?: string;
  /** Microsoft Clarity project ID, e.g. "abc123def4". */
  clarityId?: string;
  /**
   * Arbitrary scripts (Meta Pixel, Hotjar, Segment, LinkedIn Insight,
   * Pinterest, TikTok, etc.). Each fires once the matching consent
   * category is granted. Use `inline` for hand-written snippets like
   * `gtag('js', new Date())`.
   */
  scripts?: XMarketingTrackingScript[];
  /** Auto-inject configured scripts on consent. Default: true. */
  autoInject?: boolean;
}

export interface XMarketingConfig {
  /** Project name */
  name?: string;
  /** Project URL */
  url?: string;
  config?: {
    markerProjectId?: string;
    emailMarketingNewsletters?: {
      organizationId?: string;
    };
  };
  header?: {
    /** Set false to opt out of the default navbar in the shipped shell. */
    active?: boolean;
    logo?: {
      src?: string;
      srcDark?: string;
      alt?: string;
    };
    nav?: {
      buttons?: {
        label: string;
        to: string;
        icon?: string;
        target?: string;
        variant?: string;
        square?: boolean;
        color?: string;
      }[];
      links?: XMarketingNavLink[];
    };
  };
  footer?: {
    /** Set false to opt out of the default footer in the shipped shell. */
    active?: boolean;
    body?: string;
    bg?: {
      color?: string;
      img?: {
        src?: string;
        alt?: string;
      };
    };
    logo?: {
      src?: string;
      alt?: string;
    };
    socials?: {
      name: string;
      url: string;
      icon: string;
    }[];
    columns?: {
      headerLabel: string;
      links: {
        label: string;
        to: string;
        target?: string;
      }[];
    }[];
  };
  /** Cookie-consent banner in the shipped shell; gates tracking injection. */
  consent?: {
    active?: boolean;
  };
  /** Blog defaults; `active: false` disables the shipped /blog pages (404). */
  blog?: {
    active?: boolean;
    title?: string;
    description?: string;
    meta?: {
      title?: string;
      description?: string;
    };
  };
  /**
   * Tracking + analytics config. Read by
   * `<XMarkPrivacyCookieConsent>` and `useConsentTracking()`.
   * Only fires after the matching consent category is granted.
   */
  tracking?: XMarketingTracking;
}