teqo/src/components/campaign/shared/CampaignListSheetHost.tsx
Francisco Ignácio Fontoura Solla 6a20e98047 fix(campanha): share one Drawer across municipalities mobile cards
Root cause of the prod-build React #130 on /campanha/municipios: the
md:hidden mobile-cards tree still hydrated ~25 rows x ~5 sheet controls
(~125 eager Drawer/DrawerCloseButton instances) even on wide viewports.
Filtered ?q=... routes failed more often only because they exercise the
list with filters active — the search param itself was not the bug.

CampaignListSheetProvider hosts a single bottom Drawer for the whole
mobile section; CampaignCellEditOverlay sheet cells portal their
body/footer into it while keeping per-cell open state and autosave
scaffolds. Footers with DrawerCloseButton are only created once a sheet
actually opens. Desktop popover path is unchanged; per-cell Drawer
remains the fallback for surfaces without the provider.

Also: DrawerCloseButton (function render prop, avoids base-ui element
render in prod bundles) replaces the DrawerClose render={<Button/>}
pattern across call sites; stale e2e selectors refreshed; e2e affected
script + playwright github/list reporters for CI; use-mobile reverted
(no consumers of the gate remain).

Guardrail filed as issue #52.
2026-07-30 17:37:20 -03:00

163 lines
5 KiB
TypeScript

'use client'
import {
createContext,
useCallback,
useContext,
useMemo,
useRef,
useState,
type ReactNode,
type RefObject,
} from 'react'
import {
Drawer,
DrawerCloseButton,
DrawerContent,
DrawerDescription,
DrawerFooter,
DrawerHeader,
DrawerTitle,
} from '@/components/ui/Drawer'
import { cn } from '@/lib/utils'
export type CampaignListSheetChrome = {
title: string
description?: string
hasCustomFooter: boolean
sheetBodyClassName?: string
onOpenChange: (open: boolean) => void
}
type CampaignListSheetContextValue = {
bodyPortalRef: RefObject<HTMLDivElement | null>
footerPortalRef: RefObject<HTMLDivElement | null>
/** Bumps when the drawer body/footer mount targets attach — portals read this. */
portalRevision: number
openSheet: (chrome: CampaignListSheetChrome) => void
dismissSheet: (onOpenChange: (open: boolean) => void) => void
isActiveSheet: (onOpenChange: (open: boolean) => void) => boolean
}
const CampaignListSheetContext = createContext<CampaignListSheetContextValue | null>(null)
export const useCampaignListSheet = () => useContext(CampaignListSheetContext)
/**
* One bottom Drawer for an entire list surface (B42 mobile cards). Cell bodies
* portal into it so we never mount hundreds of Drawer roots and never sync form
* trees through provider state (which tripped React #185 in prod).
*/
export const CampaignListSheetProvider = ({ children }: { children: ReactNode }) => {
const titleRef = useRef<HTMLHeadingElement | null>(null)
const bodyPortalRef = useRef<HTMLDivElement | null>(null)
const footerPortalRef = useRef<HTMLDivElement | null>(null)
const [open, setOpen] = useState(false)
const [chrome, setChrome] = useState<CampaignListSheetChrome | null>(null)
const [portalRevision, setPortalRevision] = useState(0)
const activeOnOpenChangeRef = useRef<((open: boolean) => void) | null>(null)
const attachBodyPortal = useCallback((node: HTMLDivElement | null) => {
bodyPortalRef.current = node
if (node) setPortalRevision((value) => value + 1)
}, [])
const attachFooterPortal = useCallback((node: HTMLDivElement | null) => {
footerPortalRef.current = node
if (node) setPortalRevision((value) => value + 1)
}, [])
const dismissSheet = useCallback((onOpenChange: (open: boolean) => void) => {
if (activeOnOpenChangeRef.current !== onOpenChange) return
setOpen(false)
activeOnOpenChangeRef.current = null
setChrome(null)
onOpenChange(false)
}, [])
const openSheet = useCallback((next: CampaignListSheetChrome) => {
const previousOnOpenChange = activeOnOpenChangeRef.current
if (previousOnOpenChange && previousOnOpenChange !== next.onOpenChange) {
previousOnOpenChange(false)
}
activeOnOpenChangeRef.current = next.onOpenChange
setChrome((current) => {
if (
current &&
current.onOpenChange === next.onOpenChange &&
current.title === next.title &&
current.description === next.description &&
current.sheetBodyClassName === next.sheetBodyClassName &&
current.hasCustomFooter === next.hasCustomFooter
) {
return current
}
return next
})
setOpen(true)
}, [])
const isActiveSheet = useCallback(
(onOpenChange: (open: boolean) => void) =>
open && activeOnOpenChangeRef.current === onOpenChange,
[open],
)
const handleOpenChange = useCallback(
(nextOpen: boolean) => {
if (nextOpen) return
const onOpenChange = activeOnOpenChangeRef.current
if (!onOpenChange) {
setOpen(false)
setChrome(null)
return
}
dismissSheet(onOpenChange)
},
[dismissSheet],
)
const contextValue = useMemo(
() => ({
bodyPortalRef,
footerPortalRef,
portalRevision,
openSheet,
dismissSheet,
isActiveSheet,
}),
[portalRevision, openSheet, dismissSheet, isActiveSheet],
)
return (
<CampaignListSheetContext.Provider value={contextValue}>
{children}
<Drawer open={open} onOpenChange={handleOpenChange}>
{chrome && open ? (
<DrawerContent initialFocus={titleRef}>
<DrawerHeader>
<DrawerTitle ref={titleRef} tabIndex={-1} className="outline-none">
{chrome.title}
</DrawerTitle>
{chrome.description ? (
<DrawerDescription>{chrome.description}</DrawerDescription>
) : null}
</DrawerHeader>
<div
ref={attachBodyPortal}
className={cn(
'flex min-h-0 flex-1 flex-col overflow-y-auto px-4 pt-3 pb-2',
chrome.sheetBodyClassName,
)}
/>
<DrawerFooter>
<div ref={attachFooterPortal} className="flex w-full flex-col gap-2" />
{!chrome.hasCustomFooter ? <DrawerCloseButton>Fechar</DrawerCloseButton> : null}
</DrawerFooter>
</DrawerContent>
) : null}
</Drawer>
</CampaignListSheetContext.Provider>
)
}