+
{searchSlot}
) : null}
diff --git a/src/components/campaign/dashboard/CampaignHomeSearch.tsx b/src/components/campaign/dashboard/CampaignHomeSearch.tsx
new file mode 100644
index 00000000..e2bf24b4
--- /dev/null
+++ b/src/components/campaign/dashboard/CampaignHomeSearch.tsx
@@ -0,0 +1,45 @@
+'use client'
+
+import type { ReactNode } from 'react'
+
+import { useHomeSearch } from '@/components/campaign/dashboard/HomeSearchContext'
+import { CampaignSearchInput } from '@/components/campaign/shared/CampaignSearchInput'
+
+const HOME_SEARCH_INPUT_ID = 'homeSearchQuery'
+const HOME_SEARCH_LABEL = 'Buscar na campanha'
+
+export const CampaignHomeSearch = ({ children }: { children?: ReactNode }) => {
+ const { query, setRaw, clear, isDebouncing } = useHomeSearch()
+ const ariaBusy = isDebouncing || undefined
+
+ return (
+
+
setRaw(event.target.value)}
+ onKeyDown={(event) => {
+ if (event.key === 'Escape') {
+ event.preventDefault()
+ clear()
+ }
+ }}
+ autoComplete="off"
+ enterKeyHint="search"
+ aria-busy={ariaBusy}
+ />
+
+ {children}
+
+
+ )
+}
diff --git a/src/components/campaign/dashboard/CampaignHomeStaffChrome.tsx b/src/components/campaign/dashboard/CampaignHomeStaffChrome.tsx
new file mode 100644
index 00000000..bf30b273
--- /dev/null
+++ b/src/components/campaign/dashboard/CampaignHomeStaffChrome.tsx
@@ -0,0 +1,36 @@
+'use client'
+
+import type { ReactNode } from 'react'
+
+import { CampaignHomeLayout } from '@/components/campaign/dashboard/CampaignHomeLayout'
+import { CampaignHomeSearch } from '@/components/campaign/dashboard/CampaignHomeSearch'
+import { HomeSearchProvider } from '@/components/campaign/dashboard/HomeSearchContext'
+import { useHomeSearchQuery } from '@/components/campaign/dashboard/useHomeSearchQuery'
+import { cn } from '@/lib/utils'
+
+export const CampaignHomeStaffChrome = ({
+ actions,
+ searchResults,
+}: {
+ actions: ReactNode
+ /** Result groups plug in here from B48+. */
+ searchResults?: ReactNode
+}) => {
+ const searchState = useHomeSearchQuery()
+ const focused = searchState.query.isActive
+
+ return (
+
+
+ {searchResults}}
+ />
+
+
+ )
+}
diff --git a/src/components/campaign/dashboard/HomeSearchContext.tsx b/src/components/campaign/dashboard/HomeSearchContext.tsx
new file mode 100644
index 00000000..a2a542f2
--- /dev/null
+++ b/src/components/campaign/dashboard/HomeSearchContext.tsx
@@ -0,0 +1,25 @@
+'use client'
+
+import { createContext, useContext, type ReactNode } from 'react'
+
+import type { HomeSearchController } from '@/components/campaign/dashboard/useHomeSearchQuery'
+
+export type HomeSearchContextValue = HomeSearchController
+
+const HomeSearchContext = createContext
(null)
+
+export const HomeSearchProvider = ({
+ value,
+ children,
+}: {
+ value: HomeSearchContextValue
+ children: ReactNode
+}) => {children}
+
+export const useHomeSearch = (): HomeSearchContextValue => {
+ const ctx = useContext(HomeSearchContext)
+ if (!ctx) {
+ throw new Error('useHomeSearch must be used within HomeSearchProvider')
+ }
+ return ctx
+}
diff --git a/src/components/campaign/dashboard/useHomeSearchQuery.ts b/src/components/campaign/dashboard/useHomeSearchQuery.ts
new file mode 100644
index 00000000..a131ad33
--- /dev/null
+++ b/src/components/campaign/dashboard/useHomeSearchQuery.ts
@@ -0,0 +1,61 @@
+'use client'
+
+import { useCallback, useEffect, useMemo, useState } from 'react'
+
+import {
+ HOME_SEARCH_DEBOUNCE_MS,
+ homeSearchQueryIsActive,
+ normalizeHomeSearchRaw,
+ type HomeSearchQuery,
+} from '@/lib/campaignHomeSearchContract'
+
+export type HomeSearchController = {
+ query: HomeSearchQuery
+ setRaw: (next: string) => void
+ clear: () => void
+ isDebouncing: boolean
+}
+
+export const useHomeSearchQuery = (): HomeSearchController => {
+ const [raw, setRaw] = useState('')
+ const [debounced, setDebounced] = useState('')
+
+ useEffect(() => {
+ if (raw === debounced) {
+ return
+ }
+ const handle = window.setTimeout(() => {
+ setDebounced(raw)
+ }, HOME_SEARCH_DEBOUNCE_MS)
+ return () => {
+ window.clearTimeout(handle)
+ }
+ }, [raw, debounced])
+
+ const trimmedDebounced = normalizeHomeSearchRaw(debounced)
+ const isDebouncing = raw !== debounced
+
+ const query = useMemo(
+ (): HomeSearchQuery => ({
+ raw,
+ debounced: trimmedDebounced,
+ isActive: homeSearchQueryIsActive(trimmedDebounced),
+ }),
+ [raw, trimmedDebounced],
+ )
+
+ const clear = useCallback(() => {
+ setRaw('')
+ setDebounced('')
+ }, [])
+
+ return useMemo(
+ () => ({
+ query,
+ setRaw,
+ clear,
+ isDebouncing,
+ }),
+ [query, clear, isDebouncing],
+ )
+}
diff --git a/src/lib/campaignHomeSearchContract.ts b/src/lib/campaignHomeSearchContract.ts
new file mode 100644
index 00000000..eb76702c
--- /dev/null
+++ b/src/lib/campaignHomeSearchContract.ts
@@ -0,0 +1,16 @@
+/** Debounce for Início omnibox — shorter than list search (1000 ms RSC round-trips). */
+export const HOME_SEARCH_DEBOUNCE_MS = 250
+
+/** Minimum trimmed length before focused mode and result providers run. */
+const HOME_SEARCH_MIN_QUERY_LENGTH = 2
+
+export type HomeSearchQuery = {
+ raw: string
+ debounced: string
+ isActive: boolean
+}
+
+export const homeSearchQueryIsActive = (trimmedDebounced: string): boolean =>
+ trimmedDebounced.length >= HOME_SEARCH_MIN_QUERY_LENGTH
+
+export const normalizeHomeSearchRaw = (raw: string): string => raw.trim()
diff --git a/tests/e2e/campaignHomeActions.e2e.spec.ts b/tests/e2e/campaignHomeActions.e2e.spec.ts
index 7abdf310..77d0caca 100644
--- a/tests/e2e/campaignHomeActions.e2e.spec.ts
+++ b/tests/e2e/campaignHomeActions.e2e.spec.ts
@@ -9,6 +9,45 @@ const staffActionLabels = [
'Ver quem ainda não está coberto',
] as const
+test.describe('Início — busca global (B47)', () => {
+ test('staff sees campaign search on home', async ({ campaign, page }) => {
+ const { fixtures } = campaign
+ const coordinator = await fixtures.createCampaignUser('coordinator', {
+ name: fixtures.value('Coordenadora Geral'),
+ })
+
+ await campaign.login(page, coordinator.email!, coordinator.password)
+ await expect(page.getByLabel('Buscar na campanha')).toBeVisible()
+ })
+
+ test('leader does not see campaign search on home', async ({ campaign, page }) => {
+ const { fixtures } = campaign
+ const leader = await fixtures.createCampaignUser('leader', {
+ name: fixtures.value('Liderança'),
+ })
+
+ await campaign.login(page, leader.email!, leader.password)
+ await expect(page.getByLabel('Buscar na campanha')).toHaveCount(0)
+ })
+
+ test('staff focused search hides action strip after debounce', async ({ campaign, page }) => {
+ const { fixtures } = campaign
+ const coordinator = await fixtures.createCampaignUser('coordinator', {
+ name: fixtures.value('Coordenadora Geral'),
+ })
+
+ await campaign.login(page, coordinator.email!, coordinator.password)
+ const heading = page.getByRole('heading', { name: 'O que você quer fazer?', exact: true })
+ await expect(heading).toBeVisible()
+
+ await page.getByLabel('Buscar na campanha').fill('ca')
+ await expect(heading).toBeHidden({ timeout: 5000 })
+
+ await page.getByLabel('Buscar na campanha').fill('')
+ await expect(heading).toBeVisible({ timeout: 5000 })
+ })
+})
+
test.describe('Início — catálogo de ações (B45)', () => {
test('staff sees six home actions and can open municipalities without coverage', async ({
campaign,
diff --git a/tests/unit/campaignHomeSearch.unit.spec.tsx b/tests/unit/campaignHomeSearch.unit.spec.tsx
new file mode 100644
index 00000000..a9f1f126
--- /dev/null
+++ b/tests/unit/campaignHomeSearch.unit.spec.tsx
@@ -0,0 +1,40 @@
+import { render, screen } from '@testing-library/react'
+import { describe, expect, it, vi } from 'vitest'
+
+import { CampaignHomeLayout } from '@/components/campaign/dashboard/CampaignHomeLayout'
+import { CampaignHomeSearch } from '@/components/campaign/dashboard/CampaignHomeSearch'
+import { HomeSearchProvider } from '@/components/campaign/dashboard/HomeSearchContext'
+
+const providerValue = {
+ query: { raw: 'ca', debounced: 'ca', isActive: true },
+ setRaw: vi.fn(),
+ clear: vi.fn(),
+ isDebouncing: false,
+}
+
+describe('CampaignHomeLayout focused mode', () => {
+ it('hides actions and thumb spacer when focused', () => {
+ const { container } = render(
+ Actions block} searchSlot={Search
} />,
+ )
+
+ expect(container.querySelector('[data-slot="home-thumb-spacer"]')).toBeNull()
+ expect(container.querySelector('[data-slot="home-actions"]')?.className).toContain('hidden')
+ })
+})
+
+describe('CampaignHomeSearch', () => {
+ it('renders search input and results region', () => {
+ render(
+
+
+ Group stub
+
+ ,
+ )
+
+ expect(screen.getByLabelText('Buscar na campanha')).toBeTruthy()
+ expect(screen.getByRole('region', { name: 'Resultados da busca' })).toBeTruthy()
+ expect(screen.getByText('Group stub')).toBeTruthy()
+ })
+})
diff --git a/tests/unit/campaignHomeSearchQuery.unit.spec.ts b/tests/unit/campaignHomeSearchQuery.unit.spec.ts
new file mode 100644
index 00000000..25458ddb
--- /dev/null
+++ b/tests/unit/campaignHomeSearchQuery.unit.spec.ts
@@ -0,0 +1,101 @@
+import { act, renderHook } from '@testing-library/react'
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+
+import { useHomeSearchQuery } from '@/components/campaign/dashboard/useHomeSearchQuery'
+import { HOME_SEARCH_DEBOUNCE_MS } from '@/lib/campaignHomeSearchContract'
+
+describe('useHomeSearchQuery', () => {
+ beforeEach(() => {
+ vi.useFakeTimers()
+ })
+
+ afterEach(() => {
+ vi.useRealTimers()
+ })
+
+ it('debounces raw input before updating debounced and isActive', () => {
+ const { result } = renderHook(() => useHomeSearchQuery())
+
+ act(() => {
+ result.current.setRaw('ca')
+ })
+
+ expect(result.current.query.debounced).toBe('')
+ expect(result.current.query.isActive).toBe(false)
+
+ act(() => {
+ vi.advanceTimersByTime(HOME_SEARCH_DEBOUNCE_MS)
+ })
+
+ expect(result.current.query.debounced).toBe('ca')
+ expect(result.current.query.isActive).toBe(true)
+ })
+
+ it('does not activate until trimmed debounced length meets minimum', () => {
+ const { result } = renderHook(() => useHomeSearchQuery())
+
+ act(() => {
+ result.current.setRaw('a')
+ })
+ act(() => {
+ vi.advanceTimersByTime(HOME_SEARCH_DEBOUNCE_MS)
+ })
+
+ expect(result.current.query.isActive).toBe(false)
+
+ act(() => {
+ result.current.setRaw('ab')
+ })
+ act(() => {
+ vi.advanceTimersByTime(HOME_SEARCH_DEBOUNCE_MS)
+ })
+
+ expect(result.current.query.isActive).toBe(true)
+ })
+
+ it('trims debounced value and treats whitespace-only as inactive', () => {
+ const { result } = renderHook(() => useHomeSearchQuery())
+
+ act(() => {
+ result.current.setRaw(' ca ')
+ })
+ act(() => {
+ vi.advanceTimersByTime(HOME_SEARCH_DEBOUNCE_MS)
+ })
+
+ expect(result.current.query.debounced).toBe('ca')
+ expect(result.current.query.isActive).toBe(true)
+
+ act(() => {
+ result.current.setRaw(' ')
+ })
+ act(() => {
+ vi.advanceTimersByTime(HOME_SEARCH_DEBOUNCE_MS)
+ })
+
+ expect(result.current.query.debounced).toBe('')
+ expect(result.current.query.isActive).toBe(false)
+ })
+
+ it('clear resets raw, debounced, and debouncing state', () => {
+ const { result } = renderHook(() => useHomeSearchQuery())
+
+ act(() => {
+ result.current.setRaw('cairu')
+ })
+ act(() => {
+ vi.advanceTimersByTime(HOME_SEARCH_DEBOUNCE_MS)
+ })
+
+ expect(result.current.query.isActive).toBe(true)
+
+ act(() => {
+ result.current.clear()
+ })
+
+ expect(result.current.query.raw).toBe('')
+ expect(result.current.query.debounced).toBe('')
+ expect(result.current.query.isActive).toBe(false)
+ expect(result.current.isDebouncing).toBe(false)
+ })
+})