@garagem-ai/site-sdk 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,366 @@
1
+ "use client";
2
+
3
+ import {
4
+ useEffect,
5
+ useRef,
6
+ useState,
7
+ type ReactElement,
8
+ type ReactNode,
9
+ } from "react";
10
+
11
+ import {
12
+ clearStagedPathFilters,
13
+ toolbarFilterIds,
14
+ visibleSearchFilters,
15
+ } from "../search-engine";
16
+ import type { SearchUiFilter } from "../types";
17
+ import { cn } from "./cn";
18
+ import { FilterPanel, rangeDraftFromPath } from "./filter-panel";
19
+ import { ListingCard } from "./listing-card";
20
+ import { ResultsSkeleton, SearchSortSelect } from "./search-chrome";
21
+ import { SearchPagination } from "./search-pagination";
22
+ import { SearchQueryForm } from "./search-query-form";
23
+ import type {
24
+ SearchPageClassNames,
25
+ SearchPageVariant,
26
+ SiteIdInput,
27
+ } from "./types";
28
+ import { usePublicSearch } from "./use-public-search";
29
+
30
+ export type SearchPageProps = {
31
+ siteId: SiteIdInput;
32
+ baseUrl?: string;
33
+ variant?: SearchPageVariant;
34
+ className?: string;
35
+ classNames?: SearchPageClassNames;
36
+ heading?: ReactNode;
37
+ listingCard?: typeof ListingCard;
38
+ };
39
+
40
+ function ToolbarPopover({
41
+ label,
42
+ children,
43
+ }: {
44
+ label: string;
45
+ children: ReactNode;
46
+ }): ReactElement {
47
+ const [open, setOpen] = useState(false);
48
+ return (
49
+ <div className="relative">
50
+ <button
51
+ type="button"
52
+ onClick={() => setOpen((value) => !value)}
53
+ className="min-h-10 cursor-pointer rounded-lg border border-border px-3 text-sm hover:bg-muted"
54
+ >
55
+ {label}
56
+ </button>
57
+ {open ? (
58
+ <div className="absolute z-20 mt-2 w-72 rounded-xl border border-border bg-background p-4 shadow-lg">
59
+ {children}
60
+ </div>
61
+ ) : null}
62
+ </div>
63
+ );
64
+ }
65
+
66
+ function FiltersTrigger({
67
+ onClick,
68
+ className,
69
+ }: {
70
+ onClick: () => void;
71
+ className?: string;
72
+ }): ReactElement {
73
+ return (
74
+ <button
75
+ type="button"
76
+ title="Filtros"
77
+ onClick={onClick}
78
+ className={cn(
79
+ "min-h-10 cursor-pointer rounded-lg border border-border px-3 text-sm hover:bg-muted",
80
+ className
81
+ )}
82
+ >
83
+ Filtros
84
+ </button>
85
+ );
86
+ }
87
+
88
+ function ApplyBar({
89
+ onClear,
90
+ onApply,
91
+ className,
92
+ }: {
93
+ onClear: () => void;
94
+ onApply: () => void;
95
+ className?: string;
96
+ }): ReactElement {
97
+ return (
98
+ <div className={cn("mt-6 flex gap-2", className)}>
99
+ <button
100
+ type="button"
101
+ onClick={onClear}
102
+ className="min-h-10 flex-1 cursor-pointer rounded-lg border border-border px-4 hover:bg-muted"
103
+ >
104
+ Limpar
105
+ </button>
106
+ <button
107
+ type="button"
108
+ onClick={onApply}
109
+ className="min-h-10 flex-1 cursor-pointer rounded-lg bg-primary px-4 font-semibold text-primary-foreground hover:opacity-90"
110
+ >
111
+ Ver resultados
112
+ </button>
113
+ </div>
114
+ );
115
+ }
116
+
117
+ export function SearchPage({
118
+ siteId,
119
+ baseUrl,
120
+ variant = "toolbar",
121
+ className,
122
+ classNames,
123
+ heading,
124
+ listingCard: Card = ListingCard,
125
+ }: SearchPageProps): ReactElement {
126
+ const search = usePublicSearch({ siteId, baseUrl });
127
+ const dialogRef = useRef<HTMLDialogElement>(null);
128
+ const [mobileFiltersOpen, setMobileFiltersOpen] = useState(false);
129
+ const [rangeDraft, setRangeDraft] = useState(() =>
130
+ rangeDraftFromPath(search.pathFilters)
131
+ );
132
+
133
+ useEffect(() => {
134
+ setRangeDraft(rangeDraftFromPath(search.pathFilters));
135
+ }, [search.pathFilters]);
136
+
137
+ const filters = visibleSearchFilters(search.schema);
138
+ const toolbarIds = new Set(toolbarFilterIds(search.schema));
139
+ const toolbarFilters = filters.filter((filter) => toolbarIds.has(filter.id));
140
+ const extraFilters = filters.filter((filter) => !toolbarIds.has(filter.id));
141
+
142
+ function patchRange(filterId: string, side: "min" | "max", value: string) {
143
+ setRangeDraft((prev) => ({
144
+ ...prev,
145
+ [filterId]: {
146
+ min: prev[filterId]?.min ?? "",
147
+ max: prev[filterId]?.max ?? "",
148
+ [side]: value,
149
+ },
150
+ }));
151
+ }
152
+
153
+ function commitRange(filterId: string, immediate: boolean) {
154
+ const draft = rangeDraft[filterId] || { min: "", max: "" };
155
+ if (immediate) search.applyFilter(filterId, draft);
156
+ else search.stageFilter(filterId, draft);
157
+ }
158
+
159
+ function openStagedFilters() {
160
+ search.resetStagedFromUrl();
161
+ setRangeDraft(rangeDraftFromPath(search.pathFilters));
162
+ if (variant === "sidebar") setMobileFiltersOpen(true);
163
+ else dialogRef.current?.showModal();
164
+ }
165
+
166
+ function clearStagedFilters() {
167
+ const keepIds = variant === "toolbar" ? [...toolbarIds] : [];
168
+ const source = variant === "toolbar" ? search.pathFilters : search.staged;
169
+ const next = clearStagedPathFilters(source, keepIds);
170
+ search.setStaged(next);
171
+ setRangeDraft((prev) => {
172
+ const cleared = rangeDraftFromPath(next);
173
+ if (variant !== "toolbar") return cleared;
174
+ const kept = { ...cleared };
175
+ for (const id of keepIds) {
176
+ if (prev[id]) kept[id] = prev[id];
177
+ }
178
+ return kept;
179
+ });
180
+ }
181
+
182
+ function applyStagedAndClose() {
183
+ search.applyStaged();
184
+ dialogRef.current?.close();
185
+ setMobileFiltersOpen(false);
186
+ }
187
+
188
+ const results: ReactNode = search.loading ? (
189
+ <ResultsSkeleton className={classNames?.grid} />
190
+ ) : (
191
+ <>
192
+ <p className="mb-4 text-sm text-muted-foreground">
193
+ {search.total}{" "}
194
+ {search.total === 1 ? "imóvel encontrado" : "imóveis encontrados"}
195
+ </p>
196
+ <div
197
+ data-slot="search-grid"
198
+ className={cn(
199
+ "grid grid-cols-1 gap-[var(--garagem-listing-card-gap,1.5rem)] sm:grid-cols-2 lg:grid-cols-3",
200
+ classNames?.grid
201
+ )}
202
+ >
203
+ {search.listings.map((listing) => (
204
+ <Card
205
+ key={listing.id}
206
+ listing={listing}
207
+ className={classNames?.card}
208
+ />
209
+ ))}
210
+ </div>
211
+ <SearchPagination
212
+ page={search.page}
213
+ totalPages={search.totalPages}
214
+ hrefForPage={search.hrefForPage}
215
+ className={classNames?.pagination}
216
+ />
217
+ </>
218
+ );
219
+
220
+ const queryAndSort = (
221
+ <div className="flex flex-col gap-4 lg:flex-row lg:items-end">
222
+ <SearchQueryForm
223
+ value={search.qDraft}
224
+ onChange={search.setQDraft}
225
+ onSubmit={search.submitQuery}
226
+ onClear={search.clearQuery}
227
+ className={cn("flex-1", classNames?.query)}
228
+ />
229
+ <SearchSortSelect
230
+ value={search.applied.sort || ""}
231
+ onChange={search.setSort}
232
+ sorts={search.schema?.sorts}
233
+ />
234
+ </div>
235
+ );
236
+
237
+ const header = heading ?? (
238
+ <>
239
+ <p className="text-xs uppercase tracking-widest text-primary">
240
+ Busca de imóveis
241
+ </p>
242
+ <h1 className="mt-3 text-4xl font-semibold tracking-tight">
243
+ Encontre seu próximo imóvel
244
+ </h1>
245
+ </>
246
+ );
247
+
248
+ const stagedPanel = (items: SearchUiFilter[]) => (
249
+ <FilterPanel
250
+ filters={items}
251
+ pathFilters={search.staged}
252
+ onChange={search.stageFilter}
253
+ rangeDraft={rangeDraft}
254
+ onRangePatch={patchRange}
255
+ onRangeCommit={(id) => commitRange(id, false)}
256
+ />
257
+ );
258
+
259
+ return (
260
+ <main
261
+ data-slot="search-page"
262
+ data-variant={variant}
263
+ className={cn(
264
+ "mx-auto max-w-7xl px-6 py-12",
265
+ className,
266
+ classNames?.root
267
+ )}
268
+ >
269
+ <div className={classNames?.header}>{header}</div>
270
+ <div className="mt-8 space-y-6">
271
+ {queryAndSort}
272
+ {variant === "toolbar" ? (
273
+ <div
274
+ data-slot="search-toolbar"
275
+ className={cn(
276
+ "flex flex-wrap items-end gap-2",
277
+ classNames?.toolbar
278
+ )}
279
+ >
280
+ {toolbarFilters.map((filter) => (
281
+ <ToolbarPopover key={filter.id} label={filter.label}>
282
+ <FilterPanel
283
+ filters={[filter]}
284
+ pathFilters={search.pathFilters}
285
+ onChange={search.applyFilter}
286
+ rangeDraft={rangeDraft}
287
+ onRangePatch={patchRange}
288
+ onRangeCommit={(id) => commitRange(id, true)}
289
+ />
290
+ </ToolbarPopover>
291
+ ))}
292
+ {extraFilters.length > 0 ? (
293
+ <FiltersTrigger onClick={openStagedFilters} />
294
+ ) : null}
295
+ </div>
296
+ ) : null}
297
+ {variant === "dialog" ? (
298
+ <FiltersTrigger onClick={openStagedFilters} />
299
+ ) : null}
300
+ {variant === "sidebar" ? (
301
+ <div className="grid gap-8 lg:grid-cols-[280px_minmax(0,1fr)]">
302
+ <aside
303
+ data-slot="search-sidebar"
304
+ className={cn(
305
+ "hidden lg:sticky lg:top-6 lg:block lg:self-start",
306
+ classNames?.sidebar
307
+ )}
308
+ >
309
+ {stagedPanel(filters)}
310
+ <ApplyBar
311
+ onClear={clearStagedFilters}
312
+ onApply={search.applyStaged}
313
+ className={classNames?.applyBar}
314
+ />
315
+ </aside>
316
+ <div>
317
+ <FiltersTrigger
318
+ onClick={openStagedFilters}
319
+ className="mb-4 lg:hidden"
320
+ />
321
+ {results}
322
+ </div>
323
+ </div>
324
+ ) : (
325
+ results
326
+ )}
327
+ </div>
328
+ {variant !== "sidebar" ? (
329
+ <dialog
330
+ ref={dialogRef}
331
+ className={cn(
332
+ "w-[min(32rem,calc(100%-2rem))] rounded-2xl border border-border bg-background p-6 shadow-xl",
333
+ classNames?.dialog
334
+ )}
335
+ >
336
+ <p className="mb-4 text-lg font-semibold">Filtros</p>
337
+ {stagedPanel(variant === "toolbar" ? extraFilters : filters)}
338
+ <ApplyBar
339
+ onClear={clearStagedFilters}
340
+ onApply={applyStagedAndClose}
341
+ className={classNames?.applyBar}
342
+ />
343
+ </dialog>
344
+ ) : null}
345
+ {variant === "sidebar" && mobileFiltersOpen ? (
346
+ <div className="fixed inset-0 z-40 lg:hidden">
347
+ <button
348
+ type="button"
349
+ aria-label="Fechar filtros"
350
+ className="absolute inset-0 bg-black/40"
351
+ onClick={() => setMobileFiltersOpen(false)}
352
+ />
353
+ <div className="absolute inset-y-0 right-0 w-[min(22rem,100%)] overflow-y-auto bg-background p-6">
354
+ <p className="mb-4 text-lg font-semibold">Filtros</p>
355
+ {stagedPanel(filters)}
356
+ <ApplyBar
357
+ onClear={clearStagedFilters}
358
+ onApply={applyStagedAndClose}
359
+ className={classNames?.applyBar}
360
+ />
361
+ </div>
362
+ </div>
363
+ ) : null}
364
+ </main>
365
+ );
366
+ }
@@ -0,0 +1,110 @@
1
+ "use client";
2
+
3
+ import type { ReactElement } from "react";
4
+ import Link from "next/link";
5
+
6
+ import { paginationPages } from "../search-engine";
7
+ import { cn } from "./cn";
8
+
9
+ export type SearchPaginationProps = {
10
+ page: number;
11
+ totalPages: number;
12
+ hrefForPage: (page: number) => string;
13
+ className?: string;
14
+ };
15
+
16
+ function NavItem({
17
+ href,
18
+ label,
19
+ disabled,
20
+ current,
21
+ className,
22
+ }: {
23
+ href?: string;
24
+ label: string;
25
+ disabled?: boolean;
26
+ current?: boolean;
27
+ className?: string;
28
+ }): ReactElement {
29
+ const itemClass = cn(
30
+ "inline-flex size-8 cursor-pointer items-center justify-center rounded-md border text-xs font-medium md:size-9",
31
+ current && "bg-primary text-primary-foreground",
32
+ disabled && "cursor-not-allowed text-muted-foreground",
33
+ className
34
+ );
35
+ if (disabled || !href || current) {
36
+ return (
37
+ <li className={itemClass}>
38
+ <span className="flex size-full items-center justify-center">
39
+ {label}
40
+ </span>
41
+ </li>
42
+ );
43
+ }
44
+ return (
45
+ <li className={itemClass}>
46
+ <Link
47
+ href={href}
48
+ className="flex size-full items-center justify-center"
49
+ aria-label={label}
50
+ >
51
+ {label}
52
+ </Link>
53
+ </li>
54
+ );
55
+ }
56
+
57
+ export function SearchPagination({
58
+ page,
59
+ totalPages,
60
+ hrefForPage,
61
+ className,
62
+ }: SearchPaginationProps): ReactElement | null {
63
+ if (totalPages <= 1) return null;
64
+ const mobile = paginationPages(page, totalPages, 1);
65
+ const desktop = paginationPages(page, totalPages, 2);
66
+ return (
67
+ <nav
68
+ data-slot="search-pagination"
69
+ className={cn("mt-10 flex justify-center", className)}
70
+ aria-label="Paginação"
71
+ >
72
+ <ul className="flex gap-0.5 md:gap-1">
73
+ <NavItem href={hrefForPage(1)} label="‹‹" disabled={page <= 1} />
74
+ <NavItem
75
+ href={hrefForPage(Math.max(1, page - 1))}
76
+ label="‹"
77
+ disabled={page <= 1}
78
+ />
79
+ {mobile.map((n) => (
80
+ <NavItem
81
+ key={`m-${n}`}
82
+ href={hrefForPage(n)}
83
+ label={String(n)}
84
+ current={n === page}
85
+ className="md:hidden"
86
+ />
87
+ ))}
88
+ {desktop.map((n) => (
89
+ <NavItem
90
+ key={`d-${n}`}
91
+ href={hrefForPage(n)}
92
+ label={String(n)}
93
+ current={n === page}
94
+ className="hidden md:inline-flex"
95
+ />
96
+ ))}
97
+ <NavItem
98
+ href={hrefForPage(Math.min(totalPages, page + 1))}
99
+ label="›"
100
+ disabled={page >= totalPages}
101
+ />
102
+ <NavItem
103
+ href={hrefForPage(totalPages)}
104
+ label="››"
105
+ disabled={page >= totalPages}
106
+ />
107
+ </ul>
108
+ </nav>
109
+ );
110
+ }
@@ -0,0 +1,76 @@
1
+ "use client";
2
+
3
+ import type { FormEvent, ReactElement } from "react";
4
+
5
+ import { cn } from "./cn";
6
+
7
+ export type SearchQueryFormProps = {
8
+ value: string;
9
+ onChange: (value: string) => void;
10
+ onSubmit: () => void;
11
+ onClear: () => void;
12
+ className?: string;
13
+ };
14
+
15
+ export function SearchQueryForm({
16
+ value,
17
+ onChange,
18
+ onSubmit,
19
+ onClear,
20
+ className,
21
+ }: SearchQueryFormProps): ReactElement {
22
+ function handleSubmit(event: FormEvent) {
23
+ event.preventDefault();
24
+ onSubmit();
25
+ }
26
+
27
+ return (
28
+ <form
29
+ role="search"
30
+ data-slot="search-query"
31
+ onSubmit={handleSubmit}
32
+ className={cn("flex items-end gap-2", className)}
33
+ >
34
+ <div className="min-w-0 flex-1">
35
+ <label
36
+ htmlFor="garagem-search-q"
37
+ className="mb-1 block text-sm text-muted-foreground"
38
+ >
39
+ Busca
40
+ </label>
41
+ <div className="relative">
42
+ <input
43
+ id="garagem-search-q"
44
+ name="q"
45
+ type="search"
46
+ autoComplete="off"
47
+ enterKeyHint="search"
48
+ value={value}
49
+ onChange={(event) => onChange(event.target.value)}
50
+ placeholder="Busque por bairro, rua ou código"
51
+ className="min-h-12 w-full rounded-xl border border-border bg-background px-4 pr-20 outline-none focus:border-primary"
52
+ />
53
+ {value ? (
54
+ <button
55
+ type="button"
56
+ title="Limpar busca"
57
+ aria-label="Limpar busca"
58
+ onClick={onClear}
59
+ className="absolute right-10 top-1/2 -translate-y-1/2 cursor-pointer rounded-md px-2 py-1 text-sm text-muted-foreground hover:text-foreground"
60
+ >
61
+ ×
62
+ </button>
63
+ ) : null}
64
+ <button
65
+ type="submit"
66
+ title="Buscar"
67
+ aria-label="Buscar"
68
+ className="absolute right-2 top-1/2 -translate-y-1/2 cursor-pointer rounded-md px-2 py-1 text-sm font-medium hover:bg-muted"
69
+ >
70
+ ⌕
71
+ </button>
72
+ </div>
73
+ </div>
74
+ </form>
75
+ );
76
+ }
@@ -0,0 +1,88 @@
1
+ import type { CSSProperties, ReactNode } from "react";
2
+
3
+ import type {
4
+ AppliedSearchQuery,
5
+ Listing,
6
+ SearchPathFilters,
7
+ SearchUi,
8
+ } from "../types";
9
+ import type { ListingCardModel } from "../listing-card-model";
10
+
11
+ export type SearchPageVariant = "toolbar" | "dialog" | "sidebar";
12
+
13
+ export type SearchPageClassNames = {
14
+ root?: string;
15
+ header?: string;
16
+ toolbar?: string;
17
+ query?: string;
18
+ sidebar?: string;
19
+ dialog?: string;
20
+ grid?: string;
21
+ card?: string;
22
+ pagination?: string;
23
+ applyBar?: string;
24
+ };
25
+
26
+ export type ListingCardClassNames = {
27
+ root?: string;
28
+ media?: string;
29
+ badge?: string;
30
+ body?: string;
31
+ price?: string;
32
+ title?: string;
33
+ location?: string;
34
+ features?: string;
35
+ cta?: string;
36
+ };
37
+
38
+ export type ListingCardSlots = {
39
+ media?: ReactNode;
40
+ badge?: ReactNode;
41
+ cta?: ReactNode;
42
+ };
43
+
44
+ export type ListingCardProps = {
45
+ listing: Listing | ListingCardModel;
46
+ href?: string;
47
+ className?: string;
48
+ classNames?: ListingCardClassNames;
49
+ slots?: ListingCardSlots;
50
+ style?: CSSProperties;
51
+ };
52
+
53
+ export type SiteIdInput =
54
+ | string
55
+ | Promise<string>
56
+ | (() => string | Promise<string>);
57
+
58
+ export type UsePublicSearchOptions = {
59
+ siteId: SiteIdInput;
60
+ baseUrl?: string;
61
+ };
62
+
63
+ export type PublicSearchState = {
64
+ schema: SearchUi | null;
65
+ listings: Listing[];
66
+ page: number;
67
+ total: number;
68
+ totalPages: number;
69
+ loading: boolean;
70
+ pathname: string;
71
+ search: string;
72
+ pathFilters: SearchPathFilters;
73
+ applied: AppliedSearchQuery;
74
+ qDraft: string;
75
+ setQDraft: (value: string) => void;
76
+ staged: SearchPathFilters;
77
+ setStaged: (next: SearchPathFilters) => void;
78
+ resetStagedFromUrl: () => void;
79
+ applyFilter: (filterId: string, value: unknown) => void;
80
+ stageFilter: (filterId: string, value: unknown) => void;
81
+ applyStaged: () => void;
82
+ clearStaged: () => void;
83
+ submitQuery: () => void;
84
+ clearQuery: () => void;
85
+ setSort: (sort: string | null) => void;
86
+ hrefForPage: (page: number) => string;
87
+ go: (href: string) => void;
88
+ };