/** Client-safe entry paths for UX-1 action wizards under `/campanha/acoes`. */ import type { WizardVoteEditScenario } from '@/lib/wizardVoteEstimate' import { isWizardVoteEditScenario } from '@/lib/wizardVoteEstimate' export const CAMPAIGN_ACTIONS_HOME = '/campanha/acoes' as const export type CampaignWizardActionId = | 'update-votes' | 'register-signal' | 'change-trend' | 'update-leadership' | 'register-demand' export const CAMPAIGN_WIZARD_ACTION_SLUGS: Record = { 'update-votes': 'atualizar-votos', 'register-signal': 'registrar-sinal', 'change-trend': 'mudar-tendencia', 'update-leadership': 'atualizar-lideranca', 'register-demand': 'registrar-pedido', } const wizardActionSlugs = new Set(Object.values(CAMPAIGN_WIZARD_ACTION_SLUGS)) export const isCampaignWizardActionSlug = (slug: string): boolean => wizardActionSlugs.has(slug) export const isCampaignWizardActionId = (id: string): id is CampaignWizardActionId => id in CAMPAIGN_WIZARD_ACTION_SLUGS export const campaignActionEntryHref = (id: CampaignWizardActionId): string => `${CAMPAIGN_ACTIONS_HOME}/${CAMPAIGN_WIZARD_ACTION_SLUGS[id]}` export const WIZARD_MUNICIPIO_QUERY_KEY = 'municipio' as const export const WIZARD_SCENARIO_QUERY_KEY = 'cenario' as const export const wizardActionHref = ( actionSlug: string, municipalitySlug?: string, scenario?: WizardVoteEditScenario, ): string => { const base = `${CAMPAIGN_ACTIONS_HOME}/${actionSlug}` if (!municipalitySlug) { return base } const params = new URLSearchParams({ [WIZARD_MUNICIPIO_QUERY_KEY]: municipalitySlug }) if (scenario) { params.set(WIZARD_SCENARIO_QUERY_KEY, scenario) } return `${base}?${params.toString()}` } export const parseWizardMunicipioParam = ( value: string | string[] | undefined, ): string | undefined => { const raw = Array.isArray(value) ? value[0] : value const trimmed = raw?.trim() return trimmed ? trimmed : undefined } export const resolveWizardScenarioParam = ( value: string | string[] | undefined, ): { scenario: WizardVoteEditScenario; invalid: boolean } => { const raw = Array.isArray(value) ? value[0] : value const trimmed = raw?.trim() if (!trimmed) { return { scenario: 'central', invalid: false } } if (isWizardVoteEditScenario(trimmed)) { return { scenario: trimmed, invalid: false } } return { scenario: 'central', invalid: true } }