teqo-backup/src/components/campaign/municipality/MunicipalitySortableHead.tsx
Francisco Ignácio Fontoura Solla 4806c417c8 Engineering Pass 3: consolidate patterns and lock them with guards.
Fold duplicated campanha access, loaders, list/filter/form shells, and scripts into shared modules; reorganize utilities by domain; stabilize e2e; and document prevention-first audit workflow so the same smells cannot creep back in.
2026-07-29 06:11:29 -03:00

91 lines
2.8 KiB
TypeScript

'use client'
import type { ReactNode } from 'react'
import { MunicipalityHeaderFilter } from '@/components/campaign/municipality/MunicipalityHeaderFilter'
import { CampaignHoverTooltip } from '@/components/campaign/shared/CampaignHoverTooltip'
import { CampaignSortableHead } from '@/components/campaign/shared/CampaignSortableHead'
import {
campaignHoverExplanationClassName,
campaignHoverTooltipAlign,
} from '@/lib/campaignHoverTooltip'
import type {
MunicipalityFilterOption,
MunicipalityFilterParam,
} from '@/utilities/municipality/municipalityListFilters'
import {
buildMunicipalitySortHref,
defaultMunicipalityListSortDir,
municipalityListSortLabels,
resolveMunicipalityListSort,
type MunicipalityListSortKey,
type MunicipalityListState,
} from '@/utilities/municipality/municipalityListUrl'
type MunicipalitySortableHeadProps = {
state: MunicipalityListState
sortKey: MunicipalityListSortKey
children?: ReactNode
/** Hover/focus/tap explanation for the column (B22) — names the content, not the mechanism. */
description?: ReactNode
className?: string
align?: 'left' | 'center' | 'right'
filterParam?: MunicipalityFilterParam
/** Pairs, or bare catalog slugs labeled on the client (B16+ payload trim). */
filterOptions?: MunicipalityFilterOption[] | readonly string[]
showPriorityFilter?: boolean
}
export const MunicipalitySortableHead = ({
state,
sortKey,
children,
description,
className,
align = 'left',
filterParam,
filterOptions,
showPriorityFilter,
}: MunicipalitySortableHeadProps) => {
const href = buildMunicipalitySortHref(state, sortKey)
const { sort: activeSort, dir } = resolveMunicipalityListSort(state)
const active = activeSort === sortKey
const label = children ?? municipalityListSortLabels[sortKey]
const nextDir = active
? dir === 'asc'
? 'desc'
: 'asc'
: defaultMunicipalityListSortDir(sortKey)
return (
<CampaignSortableHead
active={active}
align={align}
className={className}
dir={dir}
href={href}
nextDir={nextDir}
sortLabel={municipalityListSortLabels[sortKey]}
filter={
filterParam ? (
<MunicipalityHeaderFilter
state={state}
filterParam={filterParam}
options={filterOptions}
showPriorityFilter={showPriorityFilter}
/>
) : null
}
wrapSortControl={
description
? (control) => (
<CampaignHoverTooltip content={description} align={campaignHoverTooltipAlign(align)}>
{control}
</CampaignHoverTooltip>
)
: undefined
}
>
{description ? <span className={campaignHoverExplanationClassName}>{label}</span> : label}
</CampaignSortableHead>
)
}