@garagem-ai/site-sdk 0.4.0 → 0.4.1

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.
@@ -3,7 +3,7 @@
3
3
  import type { ReactElement } from "react";
4
4
 
5
5
  import { searchSortOptions } from "../search-engine";
6
- import { cn } from "./cn";
6
+ import { SearchChromeStyles } from "./styles";
7
7
 
8
8
  export type SearchSortSelectProps = {
9
9
  value: string;
@@ -20,13 +20,13 @@ export function SearchSortSelect({
20
20
  }: SearchSortSelectProps): ReactElement {
21
21
  const options = searchSortOptions(sorts);
22
22
  return (
23
- <label className={cn("text-sm", className)}>
24
- <span className="mb-1 block text-muted-foreground">Ordenar</span>
23
+ <label data-slot="search-sort" className={className}>
24
+ <span data-slot="search-label">Ordenar</span>
25
25
  <select
26
26
  id="garagem-search-sort"
27
+ data-slot="search-sort-trigger"
27
28
  value={value}
28
29
  onChange={(event) => onChange(event.target.value || null)}
29
- className="min-h-10 cursor-pointer rounded-lg border border-border bg-background px-3"
30
30
  >
31
31
  {options.map((sort) => (
32
32
  <option key={sort.id || "relevance"} value={sort.id}>
@@ -44,29 +44,30 @@ export function ResultsSkeleton({
44
44
  className?: string;
45
45
  }): ReactElement {
46
46
  return (
47
- <div
48
- data-slot="search-skeleton"
49
- className={cn(
50
- "grid grid-cols-1 gap-[var(--garagem-listing-card-gap,1.5rem)] sm:grid-cols-2 lg:grid-cols-3",
51
- className
52
- )}
53
- >
47
+ <div data-slot="search-skeleton" className={className}>
54
48
  {Array.from({ length: 6 }, (_, i) => (
55
- <div
56
- key={i}
57
- className="overflow-hidden rounded-[var(--garagem-listing-card-radius,0.75rem)] border border-border"
58
- >
59
- <div
60
- className="animate-pulse bg-muted"
61
- style={{ aspectRatio: "4 / 3" }}
62
- />
63
- <div className="space-y-2 p-4">
64
- <div className="h-5 w-1/2 animate-pulse rounded bg-muted" />
65
- <div className="h-4 w-3/4 animate-pulse rounded bg-muted" />
66
- <div className="h-3 w-2/3 animate-pulse rounded bg-muted" />
49
+ <div key={i} data-slot="search-skeleton-card">
50
+ <div data-slot="search-skeleton-block" data-kind="media" />
51
+ <div data-slot="search-skeleton-body">
52
+ <div data-slot="search-skeleton-block" data-kind="line-lg" />
53
+ <div data-slot="search-skeleton-block" data-kind="line-md" />
54
+ <div data-slot="search-skeleton-block" data-kind="line-sm" />
67
55
  </div>
68
56
  </div>
69
57
  ))}
70
58
  </div>
71
59
  );
72
60
  }
61
+
62
+ export function SearchPageFallback({
63
+ className,
64
+ }: {
65
+ className?: string;
66
+ }): ReactElement {
67
+ return (
68
+ <main data-slot="search-page">
69
+ <SearchChromeStyles />
70
+ <ResultsSkeleton className={className} />
71
+ </main>
72
+ );
73
+ }
@@ -1,6 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import {
4
+ useCallback,
4
5
  useEffect,
5
6
  useRef,
6
7
  useState,
@@ -10,6 +11,7 @@ import {
10
11
 
11
12
  import {
12
13
  clearStagedPathFilters,
14
+ searchResultsHeading,
13
15
  toolbarFilterIds,
14
16
  visibleSearchFilters,
15
17
  } from "../search-engine";
@@ -22,9 +24,11 @@ import { SearchPagination } from "./search-pagination";
22
24
  import { SearchQueryForm } from "./search-query-form";
23
25
  import type {
24
26
  SearchPageClassNames,
27
+ SearchPageIcons,
25
28
  SearchPageVariant,
26
29
  SiteIdInput,
27
30
  } from "./types";
31
+ import { SearchChromeStyles } from "./styles";
28
32
  import { usePublicSearch } from "./use-public-search";
29
33
 
30
34
  export type SearchPageProps = {
@@ -34,28 +38,64 @@ export type SearchPageProps = {
34
38
  className?: string;
35
39
  classNames?: SearchPageClassNames;
36
40
  heading?: ReactNode;
41
+ icons?: SearchPageIcons;
37
42
  listingCard?: typeof ListingCard;
38
43
  };
39
44
 
40
45
  function ToolbarPopover({
46
+ id,
41
47
  label,
48
+ open,
49
+ onOpenChange,
50
+ triggerClassName,
51
+ popoverClassName,
42
52
  children,
43
53
  }: {
54
+ id: string;
44
55
  label: string;
56
+ open: boolean;
57
+ onOpenChange: (id: string | null) => void;
58
+ triggerClassName?: string;
59
+ popoverClassName?: string;
45
60
  children: ReactNode;
46
61
  }): ReactElement {
47
- const [open, setOpen] = useState(false);
62
+ const rootRef = useRef<HTMLDivElement>(null);
63
+
64
+ useEffect(() => {
65
+ if (!open) return;
66
+ function onPointer(event: MouseEvent) {
67
+ if (!rootRef.current?.contains(event.target as Node)) {
68
+ onOpenChange(null);
69
+ }
70
+ }
71
+ function onKey(event: KeyboardEvent) {
72
+ if (event.key === "Escape") onOpenChange(null);
73
+ }
74
+ document.addEventListener("mousedown", onPointer);
75
+ document.addEventListener("keydown", onKey);
76
+ return () => {
77
+ document.removeEventListener("mousedown", onPointer);
78
+ document.removeEventListener("keydown", onKey);
79
+ };
80
+ }, [open, onOpenChange]);
81
+
48
82
  return (
49
- <div className="relative">
83
+ <div data-slot="search-toolbar-item" ref={rootRef}>
50
84
  <button
51
85
  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"
86
+ data-slot="search-toolbar-trigger"
87
+ className={triggerClassName}
88
+ aria-expanded={open}
89
+ onClick={() => onOpenChange(open ? null : id)}
54
90
  >
55
91
  {label}
56
92
  </button>
57
93
  {open ? (
58
- <div className="absolute z-20 mt-2 w-72 rounded-xl border border-border bg-background p-4 shadow-lg">
94
+ <div
95
+ data-slot="search-popover"
96
+ className={popoverClassName}
97
+ role="dialog"
98
+ >
59
99
  {children}
60
100
  </div>
61
101
  ) : null}
@@ -74,11 +114,9 @@ function FiltersTrigger({
74
114
  <button
75
115
  type="button"
76
116
  title="Filtros"
117
+ data-slot="search-filters-trigger"
77
118
  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
- )}
119
+ className={className}
82
120
  >
83
121
  Filtros
84
122
  </button>
@@ -95,21 +133,100 @@ function ApplyBar({
95
133
  className?: string;
96
134
  }): ReactElement {
97
135
  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
- >
136
+ <div data-slot="search-apply-bar" className={className}>
137
+ <button type="button" data-kind="clear" onClick={onClear}>
104
138
  Limpar
105
139
  </button>
140
+ <button type="button" data-kind="apply" onClick={onApply}>
141
+ Ver resultados
142
+ </button>
143
+ </div>
144
+ );
145
+ }
146
+
147
+ function FilterSheet({
148
+ open,
149
+ title,
150
+ onClose,
151
+ overlayClassName,
152
+ panelClassName,
153
+ children,
154
+ footer,
155
+ }: {
156
+ open: boolean;
157
+ title: string;
158
+ onClose: () => void;
159
+ overlayClassName?: string;
160
+ panelClassName?: string;
161
+ children: ReactNode;
162
+ footer: ReactNode;
163
+ }): ReactElement | null {
164
+ const onCloseRef = useRef(onClose);
165
+ onCloseRef.current = onClose;
166
+
167
+ useEffect(() => {
168
+ if (!open) return;
169
+ function onKey(event: KeyboardEvent) {
170
+ if (event.key === "Escape") onCloseRef.current();
171
+ }
172
+ document.addEventListener("keydown", onKey);
173
+ const previous = document.body.style.overflow;
174
+ document.body.style.overflow = "hidden";
175
+ return () => {
176
+ document.removeEventListener("keydown", onKey);
177
+ document.body.style.overflow = previous;
178
+ };
179
+ }, [open]);
180
+
181
+ if (!open) return null;
182
+ return (
183
+ <div data-slot="search-sheet">
106
184
  <button
107
185
  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"
186
+ aria-label="Fechar filtros"
187
+ data-slot="search-sheet-overlay"
188
+ className={overlayClassName}
189
+ onClick={onClose}
190
+ />
191
+ <div
192
+ data-slot="search-sheet-panel"
193
+ className={panelClassName}
194
+ role="dialog"
195
+ aria-modal="true"
196
+ aria-label={title}
110
197
  >
111
- Ver resultados
112
- </button>
198
+ <p data-slot="search-sheet-title">{title}</p>
199
+ <div data-slot="search-sheet-body">{children}</div>
200
+ <div data-slot="search-sheet-footer">{footer}</div>
201
+ </div>
202
+ </div>
203
+ );
204
+ }
205
+
206
+ function SearchHeading({
207
+ total,
208
+ title,
209
+ classNames,
210
+ loading,
211
+ }: {
212
+ total: number;
213
+ title: string;
214
+ classNames?: SearchPageClassNames;
215
+ loading?: boolean;
216
+ }): ReactElement {
217
+ return (
218
+ <div data-slot="search-heading" className={classNames?.heading}>
219
+ {!loading ? (
220
+ <span
221
+ data-slot="search-heading-count"
222
+ className={classNames?.headingCount}
223
+ >
224
+ {total.toLocaleString("pt-BR")}
225
+ </span>
226
+ ) : null}
227
+ <h1 data-slot="search-heading-title" className={classNames?.headingTitle}>
228
+ {title}
229
+ </h1>
113
230
  </div>
114
231
  );
115
232
  }
@@ -121,11 +238,12 @@ export function SearchPage({
121
238
  className,
122
239
  classNames,
123
240
  heading,
241
+ icons,
124
242
  listingCard: Card = ListingCard,
125
243
  }: SearchPageProps): ReactElement {
126
244
  const search = usePublicSearch({ siteId, baseUrl });
127
- const dialogRef = useRef<HTMLDialogElement>(null);
128
- const [mobileFiltersOpen, setMobileFiltersOpen] = useState(false);
245
+ const [sheetOpen, setSheetOpen] = useState(false);
246
+ const [openToolbar, setOpenToolbar] = useState<string | null>(null);
129
247
  const [rangeDraft, setRangeDraft] = useState(() =>
130
248
  rangeDraftFromPath(search.pathFilters)
131
249
  );
@@ -138,6 +256,11 @@ export function SearchPage({
138
256
  const toolbarIds = new Set(toolbarFilterIds(search.schema));
139
257
  const toolbarFilters = filters.filter((filter) => toolbarIds.has(filter.id));
140
258
  const extraFilters = filters.filter((filter) => !toolbarIds.has(filter.id));
259
+ const headingTitle = searchResultsHeading(
260
+ search.pathFilters,
261
+ search.schema?.dictionary,
262
+ search.locationNames
263
+ );
141
264
 
142
265
  function patchRange(filterId: string, side: "min" | "max", value: string) {
143
266
  setRangeDraft((prev) => ({
@@ -159,10 +282,14 @@ export function SearchPage({
159
282
  function openStagedFilters() {
160
283
  search.resetStagedFromUrl();
161
284
  setRangeDraft(rangeDraftFromPath(search.pathFilters));
162
- if (variant === "sidebar") setMobileFiltersOpen(true);
163
- else dialogRef.current?.showModal();
285
+ setOpenToolbar(null);
286
+ setSheetOpen(true);
164
287
  }
165
288
 
289
+ const closeSheet = useCallback(() => {
290
+ setSheetOpen(false);
291
+ }, []);
292
+
166
293
  function clearStagedFilters() {
167
294
  const keepIds = variant === "toolbar" ? [...toolbarIds] : [];
168
295
  const source = variant === "toolbar" ? search.pathFilters : search.staged;
@@ -181,25 +308,14 @@ export function SearchPage({
181
308
 
182
309
  function applyStagedAndClose() {
183
310
  search.applyStaged();
184
- dialogRef.current?.close();
185
- setMobileFiltersOpen(false);
311
+ closeSheet();
186
312
  }
187
313
 
188
314
  const results: ReactNode = search.loading ? (
189
- <ResultsSkeleton className={classNames?.grid} />
315
+ <ResultsSkeleton className={classNames?.skeleton ?? classNames?.grid} />
190
316
  ) : (
191
317
  <>
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
- >
318
+ <div data-slot="search-grid" className={classNames?.grid}>
203
319
  {search.listings.map((listing) => (
204
320
  <Card
205
321
  key={listing.id}
@@ -212,37 +328,40 @@ export function SearchPage({
212
328
  page={search.page}
213
329
  totalPages={search.totalPages}
214
330
  hrefForPage={search.hrefForPage}
331
+ onNavigate={search.go}
215
332
  className={classNames?.pagination}
216
333
  />
217
334
  </>
218
335
  );
219
336
 
220
337
  const queryAndSort = (
221
- <div className="flex flex-col gap-4 lg:flex-row lg:items-end">
338
+ <div data-slot="search-query-sort">
222
339
  <SearchQueryForm
223
340
  value={search.qDraft}
224
341
  onChange={search.setQDraft}
225
342
  onSubmit={search.submitQuery}
226
343
  onClear={search.clearQuery}
227
- className={cn("flex-1", classNames?.query)}
344
+ className={classNames?.query}
345
+ iconClassName={classNames?.icon}
346
+ searchIcon={icons?.search}
347
+ clearIcon={icons?.clear}
228
348
  />
229
349
  <SearchSortSelect
230
350
  value={search.applied.sort || ""}
231
351
  onChange={search.setSort}
232
352
  sorts={search.schema?.sorts}
353
+ className={classNames?.sort}
233
354
  />
234
355
  </div>
235
356
  );
236
357
 
237
358
  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
- </>
359
+ <SearchHeading
360
+ total={search.total}
361
+ title={headingTitle}
362
+ classNames={classNames}
363
+ loading={search.loading}
364
+ />
246
365
  );
247
366
 
248
367
  const stagedPanel = (items: SearchUiFilter[]) => (
@@ -256,36 +375,60 @@ export function SearchPage({
256
375
  />
257
376
  );
258
377
 
378
+ const sheet = (
379
+ <FilterSheet
380
+ open={sheetOpen}
381
+ title="Filtros"
382
+ onClose={closeSheet}
383
+ overlayClassName={classNames?.dialogOverlay}
384
+ panelClassName={cn(classNames?.dialog, classNames?.dialogPanel)}
385
+ footer={
386
+ <ApplyBar
387
+ onClear={clearStagedFilters}
388
+ onApply={applyStagedAndClose}
389
+ className={classNames?.applyBar}
390
+ />
391
+ }
392
+ >
393
+ {stagedPanel(variant === "toolbar" ? extraFilters : filters)}
394
+ </FilterSheet>
395
+ );
396
+
259
397
  return (
260
398
  <main
261
399
  data-slot="search-page"
262
400
  data-variant={variant}
263
- className={cn(
264
- "mx-auto max-w-7xl px-6 py-12",
265
- className,
266
- classNames?.root
267
- )}
401
+ className={cn(className, classNames?.root)}
268
402
  >
403
+ <SearchChromeStyles />
269
404
  <div className={classNames?.header}>{header}</div>
270
- <div className="mt-8 space-y-6">
405
+ <div data-slot="search-body">
271
406
  {queryAndSort}
272
407
  {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
- >
408
+ <div data-slot="search-toolbar" className={classNames?.toolbar}>
280
409
  {toolbarFilters.map((filter) => (
281
- <ToolbarPopover key={filter.id} label={filter.label}>
410
+ <ToolbarPopover
411
+ key={filter.id}
412
+ id={filter.id}
413
+ label={filter.label}
414
+ open={openToolbar === filter.id}
415
+ onOpenChange={setOpenToolbar}
416
+ triggerClassName={classNames?.toolbarTrigger}
417
+ popoverClassName={classNames?.popover}
418
+ >
282
419
  <FilterPanel
283
420
  filters={[filter]}
284
421
  pathFilters={search.pathFilters}
285
- onChange={search.applyFilter}
422
+ onChange={(id, value) => {
423
+ search.applyFilter(id, value);
424
+ if (filter.type !== "range") setOpenToolbar(null);
425
+ }}
286
426
  rangeDraft={rangeDraft}
287
427
  onRangePatch={patchRange}
288
- onRangeCommit={(id) => commitRange(id, true)}
428
+ onRangeCommit={(id, source) => {
429
+ commitRange(id, true);
430
+ if (source === "apply") setOpenToolbar(null);
431
+ }}
289
432
  />
290
433
  </ToolbarPopover>
291
434
  ))}
@@ -298,14 +441,8 @@ export function SearchPage({
298
441
  <FiltersTrigger onClick={openStagedFilters} />
299
442
  ) : null}
300
443
  {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
- >
444
+ <div data-slot="search-layout">
445
+ <aside data-slot="search-sidebar" className={classNames?.sidebar}>
309
446
  {stagedPanel(filters)}
310
447
  <ApplyBar
311
448
  onClear={clearStagedFilters}
@@ -314,10 +451,7 @@ export function SearchPage({
314
451
  />
315
452
  </aside>
316
453
  <div>
317
- <FiltersTrigger
318
- onClick={openStagedFilters}
319
- className="mb-4 lg:hidden"
320
- />
454
+ <FiltersTrigger onClick={openStagedFilters} />
321
455
  {results}
322
456
  </div>
323
457
  </div>
@@ -325,42 +459,7 @@ export function SearchPage({
325
459
  results
326
460
  )}
327
461
  </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}
462
+ {sheet}
364
463
  </main>
365
464
  );
366
465
  }