UI Widget — API Methods

const widget = new ConsentiSetup({
  core: {},
  rootEl: '#consent-mount',
  autoInit: false,
})

// Later, once #consent-mount is available in the DOM:
await widget.init()
widget.onReady(() => {
  console.log('Widget ready:', widget.hasConsent())
})

widget.destroy()

// Swap config or wait for a condition, then:
await widget.init()

widget.switchLocale('fr')   // switch to French
widget.switchLocale('de-AT') // switch to Austrian German

widget.onReady(() => {
  console.log('Widget ready. Has consent:', widget.hasConsent())
})

if (!widget.hasConsent()) {
  widget.showBanner()
}

const consent = widget.getConsent()
// { analytics: 'granted', marketing: 'denied', necessary: 'granted' }

if (consent?.analytics === 'granted') {
  initAnalytics()
}

const gtm = widget.getGTMConsent()
// {
//   analytics_storage: 'granted',
//   ad_storage: 'denied',
//   ad_user_data: 'denied',
//   ad_personalization: 'denied',
//   functionality_storage: 'granted',
// }

await widget.submitConsent({
  analytics: 'granted',
  marketing: 'denied',
  necessary: 'granted',
})

document.querySelector('#change-cookie-settings')?.addEventListener('click', () => {
  widget.reConsent()
})

// Boolean mode (default) — true if granted
if (widget.isCookieGranted('analytics_storage')) {
  initAnalytics()
}

// Value mode — returns the raw ConsentStatus string, or false if not in the consent map
const status = widget.isCookieGranted('marketing', true)
// 'granted' | 'denied' | 'objected' | false

// Boolean mode — true only when ALL cookies in the category are 'granted'
if (widget.isCategoryGranted('cat-analytics')) {
  loadHeatmaps()
}

// Value mode — one record per cookie in the category
const statuses = widget.isCategoryGranted('cat-marketing', true)
// [{ ad_storage: 'granted' }, { ad_personalization: 'denied' }]

// Accept everything
await widget.grantAll()

// Accept only mandatory cookies — deny the rest (useful for "Reject all" variants)
await widget.grantAll(true)

// Deny non-mandatory; mandatory cookies stay 'granted'
await widget.denyAll()

// Deny everything including mandatory — use with caution
await widget.denyAll(true)

import type { ConsentEvent } from '@consenti/ui'

const handler = (data: ConsentEvent) => {
  console.log('Consent saved:', data.consent)
  console.log('Action:', data.consentAction) // 'accept_all' | 'reject_all' | 'custom' | 'update'
}

// Subscribe — both are equivalent
widget.on('consentSubmitted', handler)
widget.on('consenti:consentSubmitted', handler)

// Unsubscribe — must pass the same function reference
widget.off('consentSubmitted', handler)

// All supported event names:
// 'bannerInitialized'       — widget initialised; hasExistingConsent is in the detail
// 'bannerVisibility'        — banner showed or hid; show / action flags in detail
// 'modalVisibility'         — modal opened or closed
// 'consentBeingSubmitted'   — user clicked a button (before API call)
// 'consentSubmitted'        — consent saved (cookie written + API call if configured)

widget.setDarkMode()       // toggle current state
widget.setDarkMode(true)  // force dark
widget.setDarkMode(false) // force light

// Typical use: follow the OS preference and update live
const mq = window.matchMedia('(prefers-color-scheme: dark)')
widget.setDarkMode(mq.matches)
mq.addEventListener('change', (e) => widget.setDarkMode(e.matches))

// Switch primary colour on the fly (e.g. white-label tenant switch)
widget.setTheme({ primaryColor: '#d32f2f', primaryTextColor: '#ffffff' })

// Only the provided keys are updated — other theme values are preserved
widget.setTheme({ borderRadius: '0px' })

// Update theme and dark mode together
widget.setConfig({
  darkMode: true,
  core: { theme: { primaryColor: '#1a73e8' } },
})

// Disable powered-by branding at runtime
widget.setConfig({ hidePoweredBy: true })

// Change the banner heading live
widget.setProfile({
  mainBanner: { heading: 'We care about your privacy' },
})

// Swap the modal position
widget.setProfile({
  preferenceModal: { position: 'left' },
})

const info = widget.version()
// {
//   package: '0.1.1',       — npm package version
//   profileVersion: 3,      — profile.version from the API or local profile
//   consentVersion: 1,      — consent schema version (increments on breaking cookie format changes)
// }
console.log(`Consenti ${info.package} | profile v${info.profileVersion}`)

// In a SPA router's cleanup callback:
widget.destroy()