@garagem-ai/site-sdk 0.4.7 → 0.4.10

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.
@@ -88,7 +88,19 @@ interface Listing {
88
88
  * details and richer property info. Returned by `getListing`.
89
89
  */
90
90
  interface ListingDetail extends Listing {
91
+ /**
92
+ * Unit + building amenity ids (legacy merged list). Prefer
93
+ * `propertyFeatures` and `buildingAmenities` with `listingAmenityGroups`.
94
+ */
91
95
  amenities: string[];
96
+ /** Unit amenity ids only. Absent on older payloads — fall back to `amenities`. */
97
+ propertyFeatures?: string[];
98
+ /**
99
+ * Condo amenity ids. Present even when `building` is null (Typesense has
100
+ * `buildingAmenities` but no `buildingId`). Prefer this over reconstructing
101
+ * from the merged `amenities` list.
102
+ */
103
+ buildingAmenities?: string[];
92
104
  tags: string[];
93
105
  property: ListingPropertySummary & {
94
106
  id: string;
@@ -88,7 +88,19 @@ interface Listing {
88
88
  * details and richer property info. Returned by `getListing`.
89
89
  */
90
90
  interface ListingDetail extends Listing {
91
+ /**
92
+ * Unit + building amenity ids (legacy merged list). Prefer
93
+ * `propertyFeatures` and `buildingAmenities` with `listingAmenityGroups`.
94
+ */
91
95
  amenities: string[];
96
+ /** Unit amenity ids only. Absent on older payloads — fall back to `amenities`. */
97
+ propertyFeatures?: string[];
98
+ /**
99
+ * Condo amenity ids. Present even when `building` is null (Typesense has
100
+ * `buildingAmenities` but no `buildingId`). Prefer this over reconstructing
101
+ * from the merged `amenities` list.
102
+ */
103
+ buildingAmenities?: string[];
92
104
  tags: string[];
93
105
  property: ListingPropertySummary & {
94
106
  id: string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@garagem-ai/site-sdk",
3
- "version": "0.4.7",
3
+ "version": "0.4.10",
4
4
  "private": false,
5
5
  "description": "Typed, runtime-agnostic SDK for building custom real estate sites against the Garagem platform. Drop into any Next.js (or other JS) project to fetch listings, sites and CMS data.",
6
6
  "main": "./dist/index.js",
@@ -0,0 +1,400 @@
1
+ /**
2
+ * Portuguese labels for listing amenity ids. Tenant search-ui dictionary
3
+ * wins; this map is the default-catalog fallback so generated Studio pages
4
+ * never print camelCase keys.
5
+ */
6
+
7
+ export const LISTING_AMENITY_TITLES = {
8
+ unit: "Comodidades",
9
+ building: "Comodidades do condomínio",
10
+ } as const;
11
+
12
+ export type AmenityLabelOption = {
13
+ id: string;
14
+ label: string;
15
+ };
16
+
17
+ export type AmenityLabelDictionary = {
18
+ propertyFeatures?: AmenityLabelOption[];
19
+ buildingAmenities?: AmenityLabelOption[];
20
+ };
21
+
22
+ export type ListingAmenityGroupKey = keyof typeof LISTING_AMENITY_TITLES;
23
+
24
+ export type ListingAmenityGroup = {
25
+ key: ListingAmenityGroupKey;
26
+ title: string;
27
+ labels: string[];
28
+ };
29
+
30
+ export type ListingAmenitySource = {
31
+ amenities?: string[] | null;
32
+ propertyFeatures?: string[] | null;
33
+ /** Condo amenity ids, even when `building` is null (no buildingId). */
34
+ buildingAmenities?: string[] | null;
35
+ building?: { amenities?: string[] | null } | null;
36
+ };
37
+
38
+ /**
39
+ * Default tenant ids + canonical `has*` / `is*` keys seen on public listings.
40
+ * Aligned with DEFAULT_PROPERTY_FEATURES and DEFAULT_BUILDING_FEATURES from
41
+ * Foundation's field-definitions.ts so generated Studio pages never need a
42
+ * dictionary for standard amenities.
43
+ */
44
+ export const AMENITY_FALLBACK_LABELS: Record<string, string> = {
45
+ // ==================== PROPERTY FEATURES ====================
46
+ // Amenities
47
+ arCondicionado: "Ar condicionado",
48
+ banheira: "Banheira",
49
+ carregadorEletrico: "Carregador elétrico",
50
+ churrasqueira: "Churrasqueira",
51
+ chuveiroGas: "Chuveiro a gás",
52
+ chuveiroEletrico: "Chuveiro elétrico",
53
+ energiaSolar: "Energia solar",
54
+ fechaduraDigital: "Fechadura digital",
55
+ fechaduraEletronica: "Fechadura eletrônica",
56
+ geradorEletrico: "Gerador elétrico",
57
+ gesso: "Gesso",
58
+ hidromassagem: "Hidromassagem",
59
+ lareira: "Lareira",
60
+ ofuro: "Ofurô",
61
+ spa: "Spa",
62
+ painelSolar: "Painel solar",
63
+ portaoEletronico: "Portão eletrônico",
64
+ sistemaAlarme: "Sistema de alarme",
65
+ homeTheater: "Home theater",
66
+ adega: "Adega",
67
+ split: "Split",
68
+ arCentral: "Ar central",
69
+ esperaSplit: "Espera para split",
70
+ vistaMar: "Vista para o mar",
71
+ vistaPanoramica: "Vista panorâmica",
72
+ aguaQuente: "Água quente",
73
+ reformado: "Reformado",
74
+ tvCabo: "TV a cabo",
75
+ gradeado: "Gradeado",
76
+ antenaParabolica: "Antena parabólica",
77
+ aquecimento: "Aquecimento",
78
+ aquecimentoEletrico: "Aquecimento elétrico",
79
+ aquecimentoCentral: "Aquecimento central",
80
+ cercaEletrica: "Cerca elétrica",
81
+ monitoramento: "Monitoramento",
82
+ vigiaInterno: "Vigia interno",
83
+ vigiaExterno: "Vigia externo",
84
+ alarme: "Alarme",
85
+ agua: "Água",
86
+ redeEsgoto: "Rede de esgoto",
87
+ pavimentacao: "Pavimentação",
88
+ energiaEletrica: "Energia elétrica",
89
+ // Furniture
90
+ mobiliado: "Mobiliado",
91
+ armarioEmbutido: "Armário embutido",
92
+ armarioEmbutidoQuarto: "Armário embutido quarto",
93
+ armarioCozinha: "Armário cozinha",
94
+ armarioBanheiro: "Armário banheiro",
95
+ cozinhaPlanejada: "Cozinha planejada",
96
+ fogao: "Fogão",
97
+ fornoPizza: "Forno de pizza",
98
+ freezer: "Freezer",
99
+ dormitorioComArmario: "Dormitório com armário",
100
+ semiMobiliado: "Semi mobiliado",
101
+ salaArmarios: "Sala com armários",
102
+ // Structure
103
+ piscina: "Piscina",
104
+ piscinaAquecida: "Piscina aquecida",
105
+ piscinaCoberta: "Piscina coberta",
106
+ poco: "Poço",
107
+ pocoArtesiano: "Poço artesiano",
108
+ bar: "Bar",
109
+ jardim: "Jardim",
110
+ lago: "Lago",
111
+ lavabo: "Lavabo",
112
+ quintal: "Quintal",
113
+ solarium: "Solarium",
114
+ quartoServico: "Quarto de serviço",
115
+ varanda: "Varanda",
116
+ varandaFechadaVidro: "Varanda fechada com vidro",
117
+ varandaGourmet: "Varanda gourmet",
118
+ banheiroServico: "Banheiro de serviço",
119
+ areaServico: "Área de serviço",
120
+ cinema: "Cinema",
121
+ closet: "Closet",
122
+ cozinhaAmericana: "Cozinha americana",
123
+ cozinhaGourmet: "Cozinha gourmet",
124
+ despensa: "Despensa",
125
+ escritorio: "Escritório",
126
+ edicula: "Edícula",
127
+ horta: "Horta",
128
+ sacada: "Sacada",
129
+ salaJantar: "Sala de jantar",
130
+ cozinha: "Cozinha",
131
+ banheiroSocial: "Banheiro social",
132
+ terraco: "Terraço",
133
+ copa: "Copa",
134
+ suiteMaster: "Suíte master",
135
+ wcEmpregada: "WC empregada",
136
+ dependenciaEmpregada: "Dependência de empregada",
137
+ dependenciadeEmpregada: "Dependência empregada",
138
+ salaTv: "Sala de TV",
139
+ copaCozinha: "Copa cozinha",
140
+ sacadaComChurrasqueira: "Sacada com churrasqueira",
141
+ hallPrivativo: "Hall privativo",
142
+ estarIntimo: "Estar íntimo",
143
+ livingHall: "Living hall",
144
+ piscinaInterna: "Piscina interna",
145
+ deck: "Deck",
146
+ jardimInverno: "Jardim de inverno",
147
+ rouparia: "Rouparia",
148
+ living: "Living",
149
+ familyRoom: "Family room",
150
+ salafitness: "Sala fitness",
151
+ salaEstar: "Sala de estar",
152
+ mezanino: "Mezanino",
153
+ pisoElevado: "Piso elevado",
154
+ entradaServicoIndependente: "Entrada de serviço independente",
155
+ forro: "Forro",
156
+ vitrine: "Vitrine",
157
+ banheiroAuxiliar: "Banheiro auxiliar",
158
+ gabinete: "Gabinete",
159
+ quadraTenisPrivativa: "Quadra de tênis privativa",
160
+ porao: "Porão",
161
+ sotao: "Sótão",
162
+ patio: "Pátio",
163
+ canaletasNoRodape: "Canaletas no rodapé",
164
+ // Accessibility
165
+ barraApoioVaso: "Barra de apoio vaso",
166
+ barraApoioChuveiro: "Barra de apoio chuveiro",
167
+ entradaSemDegrau: "Entrada sem degrau",
168
+ rampasAcesso: "Rampas de acesso",
169
+ vagaDeficientes: "Vaga para deficientes",
170
+ // Flooring
171
+ cimentoQueimado: "Cimento queimado",
172
+ madeira: "Madeira",
173
+ pisoFrio: "Piso frio",
174
+ laminado: "Laminado",
175
+ vinilico: "Vinílico",
176
+ porcelanato: "Porcelanato",
177
+
178
+ // ==================== BUILDING FEATURES ====================
179
+ // Amenities
180
+ elevador: "Elevador",
181
+ bicicletario: "Bicicletário",
182
+ carregadorEletronico: "Carregador eletrônico",
183
+ concierge: "Concierge",
184
+ coworking: "Coworking",
185
+ deposito: "Depósito",
186
+ lavanderia: "Lavanderia",
187
+ petPlace: "Pet place",
188
+ recebimentoEncomendas: "Recebimento de encomendas",
189
+ salaReuniao: "Sala de reunião",
190
+ salaoFestas: "Salão de festas",
191
+ valet: "Valet",
192
+ garagemCoberta: "Garagem coberta",
193
+ elevadorServico: "Elevador de serviço",
194
+ // Leisure
195
+ academia: "Academia",
196
+ campoFutebol: "Campo de futebol",
197
+ espacoGourmet: "Espaço gourmet",
198
+ piscinaInfantil: "Piscina infantil",
199
+ pistaCaminhada: "Pista de caminhada",
200
+ playground: "Playground",
201
+ quadraPoliesportiva: "Quadra poliesportiva",
202
+ quadraTenis: "Quadra de tênis",
203
+ salaJogos: "Sala de jogos",
204
+ salaVapor: "Sala de vapor",
205
+ sauna: "Sauna",
206
+ // Security
207
+ circuitoTv: "Circuito fechado de TV",
208
+ controleAcessoEletronico: "Controle de acesso eletrônico",
209
+ interfone: "Interfone",
210
+ portaria24h: "Portaria 24h",
211
+ porteiroFisico: "Porteiro físico",
212
+ seguranca24h: "Segurança 24h",
213
+ segurancaPatrimonial: "Segurança patrimonial",
214
+ condominioFechado: "Condomínio fechado",
215
+ // Accessibility
216
+ banheiroAcessivel: "Banheiro acessível",
217
+ elevadorAcessivel: "Elevador acessível",
218
+ pisoTatil: "Piso tátil",
219
+
220
+ // ==================== CANONICAL HAS*/IS* KEYS ====================
221
+ has24hConcierge: "Portaria 24h",
222
+ has24hSecurity: "Segurança 24h",
223
+ hasAccessRamps: "Rampas de acesso",
224
+ hasAccessibleBathroom: "Banheiro acessível",
225
+ hasAccessibleElevator: "Elevador acessível",
226
+ hasAirConditioning: "Ar condicionado",
227
+ hasAlarmSystem: "Sistema de alarme",
228
+ hasBalcony: "Varanda",
229
+ hasBikeStorage: "Bicicletário",
230
+ hasBuiltInWardrobe: "Armário embutido",
231
+ hasCCTV: "CFTV",
232
+ hasCloset: "Closet",
233
+ hasConcierge: "Portaria",
234
+ hasControlledAccess: "Condomínio fechado",
235
+ hasCoworking: "Coworking",
236
+ hasDisabledParking: "Vaga para deficientes",
237
+ hasElectricCharger: "Carregador eletrônico",
238
+ hasElectronicGate: "Portão eletrônico",
239
+ hasElevator: "Elevador",
240
+ hasFireplace: "Lareira",
241
+ hasGarden: "Jardim",
242
+ hasGasShower: "Chuveiro a gás",
243
+ hasGenerator: "Gerador",
244
+ hasGourmetBalcony: "Varanda gourmet",
245
+ hasGourmetKitchen: "Cozinha gourmet",
246
+ hasGrill: "Churrasqueira",
247
+ hasGuestParking: "Estacionamento para visitantes",
248
+ hasGym: "Academia",
249
+ hasHeating: "Aquecimento",
250
+ hasHomeOffice: "Home office",
251
+ hasIntercom: "Interfone",
252
+ hasJacuzzi: "Hidromassagem",
253
+ hasKidsPool: "Piscina infantil",
254
+ hasLaundry: "Lavanderia",
255
+ hasMeetingRoom: "Sala de reunião",
256
+ hasOffice: "Escritório",
257
+ hasOpenKitchen: "Cozinha americana",
258
+ hasPackageReceival: "Recebimento de encomendas",
259
+ hasPantry: "Despensa",
260
+ hasParkingGarage: "Garagem coberta",
261
+ hasPartySaloon: "Salão de festas",
262
+ hasPetArea: "Pet place",
263
+ hasPipedGas: "Gás encanado",
264
+ hasPlayground: "Playground",
265
+ hasPowderRoom: "Lavabo",
266
+ hasPrivatePool: "Piscina privativa",
267
+ hasSauna: "Sauna",
268
+ hasSecurity: "Segurança",
269
+ hasServiceArea: "Área de serviço",
270
+ hasSolarPanel: "Painel solar",
271
+ hasSpa: "Spa",
272
+ hasSportsCourt: "Quadra de esportes",
273
+ hasStepFreeEntrance: "Entrada sem degrau",
274
+ hasStorage: "Depósito",
275
+ hasSwimmingPool: "Piscina",
276
+ hasTennisCourt: "Quadra de tênis",
277
+ hasValetParking: "Valet",
278
+ homeOffice: "Home office",
279
+ isPetFriendly: "Pet friendly",
280
+ isFurnished: "Mobiliado",
281
+ isPartiallyFurnished: "Semi-mobiliado",
282
+ petFriendly: "Pet friendly",
283
+ piscinaPrivativa: "Piscina privativa",
284
+ pisoLaminado: "Piso laminado",
285
+ pisoMadeira: "Piso de madeira",
286
+ pisoPorcelanato: "Piso porcelanato",
287
+ quadraEsportes: "Quadra de esportes",
288
+ rooftop: "Rooftop",
289
+ suite: "Suíte",
290
+ triplex: "Triplex",
291
+ duplex: "Duplex",
292
+ cobertura: "Cobertura",
293
+ forroGesso: "Forro de gesso",
294
+ gerador: "Gerador",
295
+ armariosCozinha: "Armários na cozinha",
296
+ armariosQuarto: "Armários nos quartos",
297
+ cftv: "CFTV",
298
+ };
299
+
300
+ function lookupLabel(
301
+ id: string,
302
+ options?: AmenityLabelOption[]
303
+ ): string | undefined {
304
+ const fromDictionary = options?.find((option) => option.id === id)?.label;
305
+ if (fromDictionary?.trim()) return fromDictionary.trim();
306
+ return AMENITY_FALLBACK_LABELS[id];
307
+ }
308
+
309
+ export function labelAmenities(
310
+ ids: readonly string[] | null | undefined,
311
+ dictionary?: AmenityLabelOption[]
312
+ ): string[] {
313
+ if (!ids?.length) return [];
314
+ const labels: string[] = [];
315
+ const seen = new Set<string>();
316
+ for (const id of ids) {
317
+ if (!id) continue;
318
+ const label = lookupLabel(id, dictionary);
319
+ if (!label || seen.has(label)) continue;
320
+ seen.add(label);
321
+ labels.push(label);
322
+ }
323
+ return labels.sort((a, b) => a.localeCompare(b, "pt-BR"));
324
+ }
325
+
326
+ function presentIds(ids: readonly string[] | null | undefined): string[] {
327
+ return (ids ?? []).filter((id): id is string => Boolean(id));
328
+ }
329
+
330
+ /**
331
+ * Older payloads merge unit + condo ids into `amenities` as
332
+ * `[...propertyFeatures, ...buildingAmenities]` (duplicates kept). Consume
333
+ * unit occurrences first so shared catalog ids stay in the building group.
334
+ */
335
+ function buildingIdsFromMergedAmenities(
336
+ listing: ListingAmenitySource,
337
+ unitIds: readonly string[]
338
+ ): string[] {
339
+ if (!listing.amenities || listing.propertyFeatures == null) return [];
340
+ const unitCounts = new Map<string, number>();
341
+ for (const id of unitIds) {
342
+ unitCounts.set(id, (unitCounts.get(id) ?? 0) + 1);
343
+ }
344
+ return listing.amenities.filter((id) => {
345
+ if (!id) return false;
346
+ const count = unitCounts.get(id);
347
+ if (count === undefined || count === 0) return true;
348
+ unitCounts.set(id, count - 1);
349
+ return false;
350
+ });
351
+ }
352
+
353
+ export function unitAmenityIds(listing: ListingAmenitySource): string[] {
354
+ if (listing.propertyFeatures != null) {
355
+ return presentIds(listing.propertyFeatures);
356
+ }
357
+ const building = new Set(
358
+ listing.building?.amenities ?? listing.buildingAmenities ?? []
359
+ );
360
+ return (listing.amenities ?? []).filter((id) => id && !building.has(id));
361
+ }
362
+
363
+ function buildingAmenityIds(listing: ListingAmenitySource): string[] {
364
+ if (listing.building != null && listing.building.amenities != null) {
365
+ return presentIds(listing.building.amenities);
366
+ }
367
+ if (listing.buildingAmenities != null) {
368
+ return presentIds(listing.buildingAmenities);
369
+ }
370
+ return buildingIdsFromMergedAmenities(listing, unitAmenityIds(listing));
371
+ }
372
+
373
+ export function listingAmenityGroups(
374
+ listing: ListingAmenitySource,
375
+ dictionary?: AmenityLabelDictionary
376
+ ): ListingAmenityGroup[] {
377
+ const groups: ListingAmenityGroup[] = [];
378
+ const unitIds = unitAmenityIds(listing);
379
+ const unitLabels = labelAmenities(unitIds, dictionary?.propertyFeatures);
380
+ if (unitLabels.length > 0) {
381
+ groups.push({
382
+ key: "unit",
383
+ title: LISTING_AMENITY_TITLES.unit,
384
+ labels: unitLabels,
385
+ });
386
+ }
387
+
388
+ const buildingLabels = labelAmenities(
389
+ buildingAmenityIds(listing),
390
+ dictionary?.buildingAmenities
391
+ );
392
+ if (buildingLabels.length > 0) {
393
+ groups.push({
394
+ key: "building",
395
+ title: LISTING_AMENITY_TITLES.building,
396
+ labels: buildingLabels,
397
+ });
398
+ }
399
+ return groups;
400
+ }
package/src/index.ts CHANGED
@@ -114,6 +114,18 @@ export {
114
114
  type VisitLeadInput,
115
115
  } from "./leads";
116
116
 
117
+ export {
118
+ AMENITY_FALLBACK_LABELS,
119
+ LISTING_AMENITY_TITLES,
120
+ labelAmenities,
121
+ listingAmenityGroups,
122
+ type AmenityLabelDictionary,
123
+ type AmenityLabelOption,
124
+ type ListingAmenityGroup,
125
+ type ListingAmenityGroupKey,
126
+ type ListingAmenitySource,
127
+ } from "./amenity-labels";
128
+
117
129
  export { listingLookupKey, listingPublicPath } from "./listing-path";
118
130
 
119
131
  export {
@@ -195,6 +207,7 @@ export {
195
207
  studioChromeInstruction,
196
208
  studioCodegenContractViolations,
197
209
  studioLayoutInstruction,
210
+ studioAmenityInstruction,
198
211
  studioLeadInstruction,
199
212
  studioSearchLandmarkInstruction,
200
213
  studioSdkPinInstruction,
@@ -1,5 +1,5 @@
1
1
  /* Generated by scripts/build-search-chrome-css.mjs — do not edit. */
2
2
  /* eslint-disable */
3
3
  /* prettier-ignore */
4
- export const SEARCH_CHROME_CSS_VERSION = "0.4.7";
4
+ export const SEARCH_CHROME_CSS_VERSION = "0.4.10";
5
5
  export const SEARCH_CHROME_CSS = ":root{--garagem-listing-card-radius:0.75rem;--garagem-listing-card-gap:1.5rem;--garagem-listing-price-size:1.125rem;--garagem-listing-media-ratio:4 / 3;--garagem-search-control-height:2.75rem;--garagem-search-icon-size:1.25rem;--garagem-search-radius:var(--radius,0.75rem);--garagem-skeleton:var(--muted,#e7e5e4)}[data-slot=\"search-heading\"]{display:flex;min-width:0;align-items:baseline;gap:0.375rem;font-size:1.25rem;font-weight:600}[data-slot=\"search-heading-count\"]{flex-shrink:0}[data-slot=\"search-heading-title\"]{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:inherit;font-weight:inherit}[data-slot=\"search-query-sort\"]{display:flex;flex-direction:column;gap:1rem}@media (min-width:1024px){[data-slot=\"search-query-sort\"]{flex-direction:row;align-items:flex-end}}[data-slot=\"search-query\"]{flex:1;min-width:0}[data-slot=\"search-query-input\"],[data-slot=\"search-sort-trigger\"],[data-slot=\"search-toolbar-trigger\"],[data-slot=\"search-filters-trigger\"]{min-height:var(--garagem-search-control-height)}[data-slot=\"search-query-field\"]{position:relative}[data-slot=\"search-query-input\"]{width:100%;border-radius:var(--garagem-search-radius);border:1px solid var(--border,#e4e4e7);background:var(--background,#fff);padding:0.5rem 5.5rem 0.5rem 1rem;outline:none}[data-slot=\"search-query-actions\"]{position:absolute;top:50%;right:0.35rem;display:flex;transform:translateY(-50%);align-items:center;gap:0.15rem}[data-slot=\"search-icon-button\"]{display:inline-flex;height:2.25rem;width:2.25rem;cursor:pointer;align-items:center;justify-content:center;border:0;border-radius:999px;background:var(--primary,#111);color:var(--primary-foreground,#fff)}[data-slot=\"search-icon-button\"][data-kind=\"clear\"]{background:transparent;color:var(--muted-foreground,#737373)}[data-slot=\"search-icon\"]{width:var(--garagem-search-icon-size);height:var(--garagem-search-icon-size);display:block}[data-slot=\"search-sort\"]{display:flex;flex-direction:column;gap:0.25rem}[data-slot=\"search-sort-trigger\"]{appearance:none;cursor:pointer;border-radius:var(--garagem-search-radius);border:1px solid var(--border,#e4e4e7);background:var(--background,#fff);padding:0.5rem 2.25rem 0.5rem 0.75rem;background-image:url(\"data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='16' height='16' fill='none' stroke='%23737373' stroke-width='2' viewBox='0 0 24 24'><path d='m6 9 6 6 6-6'/></svg>\");background-repeat:no-repeat;background-position:right 0.65rem center}[data-slot=\"search-toolbar\"]{display:flex;flex-wrap:wrap;align-items:flex-end;gap:0.5rem}[data-slot=\"search-toolbar-trigger\"],[data-slot=\"search-filters-trigger\"]{cursor:pointer;border-radius:var(--garagem-search-radius);border:1px solid var(--border,#e4e4e7);background:var(--background,#fff);padding:0.5rem 0.75rem;font-size:0.875rem}[data-slot=\"search-popover\"]{position:absolute;z-index:30;margin-top:0.5rem;width:18rem;border-radius:0.75rem;border:1px solid var(--border,#e4e4e7);background:var(--background,#fff);padding:1rem;box-shadow:0 10px 30px rgb(0 0 0 / 0.12);animation:garagem-search-in 140ms ease-out}[data-slot=\"search-grid\"],[data-slot=\"search-skeleton\"]{display:grid;grid-template-columns:1fr;gap:var(--garagem-listing-card-gap)}@media (min-width:640px){[data-slot=\"search-grid\"],[data-slot=\"search-skeleton\"]{grid-template-columns:repeat(2,minmax(0,1fr))}}@media (min-width:1024px){[data-slot=\"search-grid\"],[data-slot=\"search-skeleton\"]{grid-template-columns:repeat(3,minmax(0,1fr))}}[data-slot=\"listing-card\"]{overflow:hidden;border-radius:var(--garagem-listing-card-radius);border:1px solid var(--border,#e4e4e7);background:var(--card,var(--background,#fff))}[data-slot=\"listing-card-price-row\"]{display:inline-flex;align-items:baseline;gap:0.25rem}[data-slot=\"listing-card-price\"]{font-size:var(--garagem-listing-price-size);font-weight:600}[data-slot=\"listing-card-period\"]{font-size:0.75rem;color:var(--muted-foreground,#737373)}[data-slot=\"search-checkbox\"]{appearance:none;width:1.15rem;height:1.15rem;flex-shrink:0;cursor:pointer;border:1px solid var(--primary,#111);border-radius:0.25rem;background:var(--background,#fff)}[data-slot=\"search-checkbox\"]:checked{background-color:var(--primary,#111);background-image:url(\"data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='white' stroke-width='3'><path d='M5 12l5 5L20 7'/></svg>\");background-repeat:no-repeat;background-position:center;background-size:0.8rem}[data-slot=\"search-scroll\"]{max-height:12rem;overflow:auto;scrollbar-width:thin;scrollbar-color:var(--muted-foreground,#a1a1aa) transparent}[data-slot=\"search-range-apply\"]{display:inline-flex;min-height:2.5rem;cursor:pointer;align-items:center;justify-content:center;border:0;border-radius:var(--garagem-search-radius);background:var(--primary,#111);color:var(--primary-foreground,#fff);padding:0 0.75rem;font-size:0.75rem;font-weight:600}[data-slot=\"search-sheet\"]{position:fixed;inset:0;z-index:40}[data-slot=\"search-sheet-overlay\"]{position:absolute;inset:0;border:0;cursor:pointer;background:rgb(0 0 0 / 0.4);animation:garagem-search-fade 160ms ease-out}[data-slot=\"search-sheet-panel\"]{position:absolute;top:0;right:0;display:flex;height:100dvh;width:min(22rem,100%);flex-direction:column;background:var(--background,#fff);animation:garagem-search-sheet 180ms ease-out}[data-slot=\"search-sheet-body\"]{min-height:0;flex:1;overflow:auto;padding:1.5rem 1.5rem 0;scrollbar-width:thin}[data-slot=\"search-sheet-footer\"]{display:flex;gap:0.5rem;border-top:1px solid var(--border,#e4e4e7);padding:1rem 1.5rem}[data-slot=\"search-apply-bar\"]{display:flex;width:100%;gap:0.5rem}[data-slot=\"search-apply-bar\"] > button{min-height:2.5rem;flex:1;cursor:pointer;border-radius:var(--garagem-search-radius);padding:0 1rem}[data-slot=\"search-apply-bar\"] > button[data-kind=\"clear\"]{border:1px solid var(--border,#e4e4e7);background:transparent}[data-slot=\"search-apply-bar\"] > button[data-kind=\"apply\"]{border:0;background:var(--primary,#111);color:var(--primary-foreground,#fff);font-weight:600}[data-slot=\"search-pagination\"]{margin-top:2.5rem;display:flex;justify-content:center}[data-slot=\"search-pagination\"] ul{display:flex;flex-wrap:wrap;justify-content:center;gap:0.25rem;padding:0;margin:0;list-style:none}[data-slot=\"search-pagination-item\"]{display:inline-flex;width:2.25rem;height:2.25rem;align-items:center;justify-content:center;border:1px solid var(--border,#e4e4e7);border-radius:0.375rem;font-size:0.75rem;font-weight:500}@media (min-width:768px){[data-slot=\"search-pagination-item\"]{width:2.5rem;height:2.5rem}}[data-slot=\"search-pagination-item\"] a,[data-slot=\"search-pagination-item\"] span{display:flex;width:100%;height:100%;align-items:center;justify-content:center;color:inherit;text-decoration:none}[data-slot=\"search-pagination-item\"][data-current=\"true\"]{background:var(--primary,#111);color:var(--primary-foreground,#fff)}[data-slot=\"search-pagination-item\"][data-disabled=\"true\"]{cursor:not-allowed;color:var(--muted-foreground,#737373)}[data-slot=\"search-toolbar-item\"]{position:relative}[data-slot=\"search-body\"]{margin-top:2rem;display:flex;flex-direction:column;gap:1.5rem}[data-slot=\"search-label\"]{margin-bottom:0.25rem;display:block;font-size:0.875rem;color:var(--muted-foreground,#737373)}[data-slot=\"search-sheet-title\"]{padding:1.5rem 1.5rem 0;font-size:1.125rem;font-weight:600}[data-slot=\"search-layout\"]{display:grid;gap:2rem}[data-slot=\"search-sidebar\"]{display:none}[data-slot=\"search-layout\"] > div > [data-slot=\"search-filters-trigger\"]{margin-bottom:1rem}@media (min-width:1024px){[data-slot=\"search-layout\"]{grid-template-columns:280px minmax(0,1fr)}[data-slot=\"search-sidebar\"]{display:block;position:sticky;top:1.5rem;align-self:start}[data-slot=\"search-layout\"] > div > [data-slot=\"search-filters-trigger\"]{display:none}}[data-slot=\"listing-card-link\"]{display:block;color:inherit;text-decoration:none;cursor:pointer}[data-slot=\"listing-card-media\"]{position:relative;width:100%;overflow:hidden;background:var(--muted,#f5f5f4);aspect-ratio:var(--garagem-listing-media-ratio)}[data-slot=\"listing-card-media\"] img{height:100%;width:100%;object-fit:cover;transition:transform 0.3s}[data-slot=\"listing-card\"]:hover [data-slot=\"listing-card-media\"] img{transform:scale(1.05)}@media (prefers-reduced-motion:reduce){[data-slot=\"listing-card-media\"] img{transition:none}[data-slot=\"listing-card\"]:hover [data-slot=\"listing-card-media\"] img{transform:none}}[data-slot=\"listing-card-empty\"]{display:flex;height:100%;width:100%;align-items:center;justify-content:center;font-size:0.75rem;color:var(--muted-foreground,#737373)}[data-slot=\"listing-card-cta\"]{margin-top:0.75rem}[data-slot=\"search-filters\"]{display:flex;flex-direction:column;gap:1.25rem}[data-slot=\"search-filter\"]{margin:0;padding:0;border:0;font-size:0.875rem}[data-slot=\"search-filter\"] legend{margin-bottom:0.5rem;padding:0;color:var(--muted-foreground,#737373)}[data-slot=\"search-range-row\"]{display:flex;align-items:flex-end;gap:0.5rem}[data-slot=\"search-range-side\"]{min-width:0;flex:1}[data-slot=\"search-range-side\"] > span:first-child{margin-bottom:0.25rem;display:block;font-size:0.75rem;color:var(--muted-foreground,#737373)}[data-slot=\"search-range-affix\"]{position:relative;display:block}[data-slot=\"search-range-prefix\"]{pointer-events:none;position:absolute;inset-block:0;left:0;display:flex;align-items:center;padding-left:0.75rem;color:var(--muted-foreground,#737373)}[data-slot=\"search-range-input\"]{min-height:2.5rem;width:100%;border-radius:var(--garagem-search-radius);border:1px solid var(--border,#e4e4e7);background:var(--background,#fff);padding:0 0.75rem}[data-slot=\"search-range-affix\"] [data-slot=\"search-range-input\"]{padding-left:2.5rem}[data-slot=\"search-count-group\"]{display:flex;flex-wrap:wrap;gap:0.375rem}[data-slot=\"search-count-choice\"]{min-height:2.5rem;cursor:pointer;border-radius:var(--garagem-search-radius);border:1px solid var(--border,#e4e4e7);background:var(--background,#fff);padding:0 0.75rem;font-size:0.875rem}[data-slot=\"search-count-choice\"][data-selected=\"true\"]{border-color:var(--primary,#111);background:color-mix(in srgb,var(--primary,#111) 10%,transparent)}[data-slot=\"search-enum-list\"],[data-slot=\"search-scroll\"]{display:flex;flex-direction:column;gap:0.375rem}[data-slot=\"search-enum-option\"]{display:flex;cursor:pointer;align-items:center;gap:0.5rem}[data-slot=\"listing-card-badge\"]{position:absolute;left:0.75rem;top:0.75rem;border-radius:999px;background:color-mix(in srgb,var(--background,#fff) 90%,transparent);padding:0.25rem 0.5rem;font-size:0.75rem;font-weight:500}[data-slot=\"listing-card-body\"]{padding:1rem}[data-slot=\"listing-card-title\"]{display:-webkit-box;margin-top:0.25rem;overflow:hidden;-webkit-box-orient:vertical;-webkit-line-clamp:1;font-size:0.875rem;font-weight:500}[data-slot=\"listing-card-location\"]{margin-top:0.125rem;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:0.75rem;color:var(--muted-foreground,#737373)}[data-slot=\"listing-card-features\"]{display:flex;flex-wrap:wrap;margin-top:0.75rem;gap:0.25rem 1rem;padding:0;list-style:none;font-size:0.75rem;color:var(--muted-foreground,#737373)}[data-slot=\"search-skeleton-block\"]{animation:garagem-search-pulse 1.2s ease-in-out infinite;background:var(--garagem-skeleton);border-radius:0.375rem}[data-slot=\"search-skeleton-card\"]{overflow:hidden;border-radius:var(--garagem-listing-card-radius);border:1px solid var(--border,#e4e4e7)}[data-slot=\"search-skeleton-body\"]{display:flex;flex-direction:column;gap:0.5rem;padding:1rem}[data-slot=\"search-skeleton-block\"][data-kind=\"media\"]{aspect-ratio:var(--garagem-listing-media-ratio)}[data-slot=\"search-skeleton-block\"][data-kind=\"line-lg\"]{height:1.25rem;width:50%}[data-slot=\"search-skeleton-block\"][data-kind=\"line-md\"]{height:1rem;width:75%}[data-slot=\"search-skeleton-block\"][data-kind=\"line-sm\"]{height:0.75rem;width:66.666667%}[data-slot=\"search-skeleton-block\"][data-kind=\"detail-media\"]{max-width:45rem;aspect-ratio:4 / 3}[data-slot=\"search-skeleton-block\"][data-kind=\"detail-title\"]{width:66.666667%;height:2rem;margin-top:1.5rem}@media (prefers-reduced-motion:reduce){[data-slot=\"search-popover\"],[data-slot=\"search-sheet-overlay\"],[data-slot=\"search-sheet-panel\"],[data-slot=\"search-skeleton-block\"]{animation:none}}@keyframes garagem-search-in{from{opacity:0;transform:translateY(-4px) scale(0.98)}to{opacity:1;transform:none}}@keyframes garagem-search-fade{from{opacity:0}to{opacity:1}}@keyframes garagem-search-sheet{from{transform:translateX(100%)}to{transform:none}}@keyframes garagem-search-pulse{50%{opacity:0.55}}";
@@ -15,10 +15,10 @@ export const STUDIO_SDK_CONTRACT = {
15
15
  /**
16
16
  * Exact pin for generated Studio sites. Must be ≥ `selfInjectSince` so
17
17
  * prompts that skip the layout chrome tag match the tarball v0 installs.
18
- * 0.4.7 lets SearchPage fill the site wrapper (`as="div"`) with no
19
- * nested 80rem inset and no padding on the search slot.
18
+ * 0.4.9 adds `listingAmenityGroups` so listing detail never prints
19
+ * amenity ids.
20
20
  */
21
- minNpmVersion: "0.4.7",
21
+ minNpmVersion: "0.4.9",
22
22
  /** First release where ListingCard and ResultsSkeleton inject the sheet. */
23
23
  selfInjectSince: "0.4.2",
24
24
  chromeStrategy: "self-inject" as const,
@@ -51,6 +51,7 @@ export const STUDIO_SDK_CONTRACT = {
51
51
  "isVisitSlotAllowed",
52
52
  "STUDIO_DEFAULT_VISIT_SCHEDULE",
53
53
  ] as const,
54
+ amenityExports: ["listingAmenityGroups"] as const,
54
55
  } as const;
55
56
 
56
57
  export type StudioSdkContract = typeof STUDIO_SDK_CONTRACT;
@@ -65,6 +66,10 @@ export const STUDIO_SITE_LAYOUT = {
65
66
  maxWidthRem: "80rem",
66
67
  maxWidthRemOptions: ["64rem", "80rem", "120rem", "160rem", "240rem"],
67
68
  surfaceClassName: "w-full",
69
+ /** Editor search `<main>` default. Designs may change the spacing values. */
70
+ searchMainClassName: "w-full pt-4 pb-12",
71
+ /** Opt out of default search spacing — flush against the header on purpose. */
72
+ searchFlushMarker: 'data-studio-search-spacing="flush"',
68
73
  wrapperClassName: "mx-auto w-full max-w-site px-4",
69
74
  } as const;
70
75
 
@@ -83,11 +88,11 @@ export function studioLayoutInstruction(): string {
83
88
  \`\`\`css
84
89
  ${studioSiteWidthCss()}
85
90
  \`\`\`
86
- Every page section is two layers: (1) surface — \`section\` / header / footer \`${STUDIO_SITE_LAYOUT.surfaceClassName}\`, background to the viewport edges, no max-width class and no horizontal padding; (2) wrapper — one child \`${STUDIO_SITE_LAYOUT.wrapperClassName}\`. Header and footer use that same inner wrapper. Components fill the wrapper (\`w-full\`). Never nest a second max-width container with extra horizontal padding. ${studioSearchLandmarkInstruction()} Do not use \`ml-auto\` on the content wrapper. To make the site narrower or wider, change ONLY \`--site-max-width\` in \`app/globals.css\` (allowed: ${scale}; default ${STUDIO_SITE_LAYOUT.maxWidthRem}). Do not edit wrapper class names, padding, or per-page containers.`;
91
+ Every page section is two layers: (1) surface — \`section\` / header / footer \`${STUDIO_SITE_LAYOUT.surfaceClassName}\`, background to the viewport edges, no max-width class and no horizontal padding; (2) wrapper — one child \`${STUDIO_SITE_LAYOUT.wrapperClassName}\`. Header and footer use that same inner wrapper. Components fill the wrapper (\`w-full\`). Never nest a second max-width container with extra horizontal padding. ${studioSearchLandmarkInstruction()} Do not use \`ml-auto\` on the content wrapper. To make the site narrower or wider, change ONLY \`--site-max-width\` in \`app/globals.css\` (allowed: ${scale}; default ${STUDIO_SITE_LAYOUT.maxWidthRem}). Do not edit wrapper class names or horizontal padding. Full-bleed image surfaces (home hero, listing gallery) stay flush with the header — do not add vertical padding there.`;
87
92
  }
88
93
 
89
94
  export function studioSearchLandmarkInstruction(): string {
90
- return `Search at \`/imoveis\` (hard rule). The page landmark is \`<main className="${STUDIO_SITE_LAYOUT.surfaceClassName}">\` with one child \`${STUDIO_SITE_LAYOUT.wrapperClassName}\`. Pass \`as="div"\` to \`SearchPage\` so it is not a second main. Do not wrap \`SearchPage\` in \`<section>\`. The wrapper has no extra vertical padding class.`;
95
+ return `Search at \`/imoveis\` (hard rule). The page landmark is \`<main className="${STUDIO_SITE_LAYOUT.searchMainClassName}">\` with one child \`${STUDIO_SITE_LAYOUT.wrapperClassName}\`. Pass \`as="div"\` to \`SearchPage\` so it is not a second main. Do not wrap \`SearchPage\` in \`<section>\`. Do not put vertical padding on SearchPage. \`pt-4 pb-12\` is the default on that search \`<main>\` — change those values if the design needs it. Flush search (glued to the header) is allowed only with \`${STUDIO_SITE_LAYOUT.searchFlushMarker}\` on that \`<main>\`. Never add that vertical padding to home heroes or listing galleries.`;
91
96
  }
92
97
 
93
98
  const REACT_SDK_NAMED_IMPORT_RE =
@@ -166,6 +171,11 @@ export function studioLeadInstruction(): string {
166
171
  return `Listing-detail visit/contact leads: import ${names} from \`${STUDIO_SDK_PACKAGE}\` (the main package, not \`/react\`). Call \`submitVisitLead\` / \`submitContactLead\` — never concatenate a leads webhook URL and never POST the Showcase demo leads route.`;
167
172
  }
168
173
 
174
+ export function studioAmenityInstruction(): string {
175
+ const names = STUDIO_SDK_CONTRACT.amenityExports.join(", ");
176
+ return `Listing amenities: import ${names} from \`${STUDIO_SDK_PACKAGE}\`. Render \`listingAmenityGroups(listing)\` (optional second arg: \`getSearchUi().dictionary\`). Use the helper titles (\`Comodidades\` / \`Comodidades do condomínio\`). Labels are already alphabetical (pt-BR) — keep that order. Omit empty groups. Never print amenity ids, never invent a local label map, and never title a section "Comodidades da unidade".`;
177
+ }
178
+
169
179
  export function studioChromeInstruction(): string {
170
180
  const injectors =
171
181
  compareSemver(
package/src/types.ts CHANGED
@@ -95,7 +95,19 @@ export interface Listing {
95
95
  * details and richer property info. Returned by `getListing`.
96
96
  */
97
97
  export interface ListingDetail extends Listing {
98
+ /**
99
+ * Unit + building amenity ids (legacy merged list). Prefer
100
+ * `propertyFeatures` and `buildingAmenities` with `listingAmenityGroups`.
101
+ */
98
102
  amenities: string[];
103
+ /** Unit amenity ids only. Absent on older payloads — fall back to `amenities`. */
104
+ propertyFeatures?: string[];
105
+ /**
106
+ * Condo amenity ids. Present even when `building` is null (Typesense has
107
+ * `buildingAmenities` but no `buildingId`). Prefer this over reconstructing
108
+ * from the merged `amenities` list.
109
+ */
110
+ buildingAmenities?: string[];
99
111
  tags: string[];
100
112
  property: ListingPropertySummary & {
101
113
  id: string;