@garagem-ai/site-sdk 0.4.11 → 0.4.13

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.
package/README.md CHANGED
@@ -54,24 +54,25 @@ raw escape hatch when you need full control.
54
54
 
55
55
  ### Friendly layer (recommended for most use cases)
56
56
 
57
- | API | Description |
58
- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
59
- | `getListings({ siteId, filters?, next? })` | Paginated listings for a site, with simple `filters` (`city`, `businessType`, `propertyType`, `neighborhood`, `minPrice`, `maxPrice`, `limit`, `offset`) |
60
- | `getListing({ siteId, listingId, next? })` | Full detail of a single listing |
61
- | `getSimilarListings({ siteId, listingId, limit?, next? })` | Similar listings carousel (same card shape as `getListings`) |
62
- | `getSite({ siteId? \| domain?, next? })` | Public site profile (returns `null` if unknown) |
63
- | `getCmsCollections({ siteId })` | List CMS collections |
64
- | `getCmsCollection({ siteId, slug })` | One CMS collection schema |
65
- | `getCmsEntries({ siteId, collection, limit?, offset? })` | Published CMS entries only |
66
- | `getCmsEntry({ siteId, collection, slug })` | One published CMS entry |
67
- | `getSearchUi({ siteId, next? })` | Tenant search schema (filters, slugs) |
68
- | `getLeadUi({ siteId, next? })` | Visit-default lead dialog schema (weekday hours, Sat/Sun flags) |
69
- | `submitVisitLead({ siteId, listingId, … })` | POST a visit lead (`listing.id` UUID; civil `visitDate` or `Date`/ISO instant normalized in the schedule timezone) |
70
- | `submitContactLead({ siteId, listingId, … })` | POST a contact lead (no date/time) |
71
- | `slotsForDate` / `normalizeVisitDate` / `expandVisitSchedule` | Pure schedule helpers (`America/Sao_Paulo`, default Mon–Fri 06:00–22:00) |
72
- | `listingDetailModel(listing)` | Listing-detail blocks: breadcrumb, values (price / condo / IPTU), facts (skip empty zeros), location + Maps href, description clamp, video/tour overlays. |
73
- | `listingAmenityGroups(listing, dictionary?)` | Unit / building amenity labels (`Comodidades`, `Comodidades do condomínio`). Reads `propertyFeatures` + `buildingAmenities` (works when `building` is null). Tenant `getSearchUi().dictionary` first, then the SDK fallback; unlabeled ids are dropped. |
74
- | `resolvePublicSiteId({ host?, fallback? })` | Preview uses `fallback` (`GARAGEM_SITE_ID`); live hosts resolve via `getSite({ domain })` |
57
+ | API | Description |
58
+ | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
59
+ | `getListings({ siteId, filters?, next? })` | Paginated listings for a site, with simple `filters` (`city`, `businessType`, `propertyType`, `neighborhood`, `minPrice`, `maxPrice`, `limit`, `offset`) |
60
+ | `getListing({ siteId, listingId, next? })` | Full detail of a single listing |
61
+ | `getSimilarListings({ siteId, listingId, limit?, next? })` | Similar listings carousel (same card shape as `getListings`) |
62
+ | `getSite({ siteId? \| domain?, next? })` | Public site profile (returns `null` if unknown) |
63
+ | `getCmsCollections({ siteId })` | List CMS collections |
64
+ | `getCmsCollection({ siteId, slug })` | One CMS collection schema |
65
+ | `getCmsEntries({ siteId, collection, limit?, offset? })` | Published CMS entries only |
66
+ | `getCmsEntry({ siteId, collection, slug })` | One published CMS entry |
67
+ | `getSearchUi({ siteId, next? })` | Tenant search schema (filters, slugs) |
68
+ | `getLeadUi({ siteId, next? })` | Visit-default lead dialog schema (weekday hours, Sat/Sun flags) |
69
+ | `submitVisitLead({ siteId, listingId, … })` | POST a visit lead (`listing.id` UUID; civil `visitDate` or `Date`/ISO instant normalized in the schedule timezone) |
70
+ | `submitContactLead({ siteId, listingId, … })` | POST a contact lead (no date/time) |
71
+ | `slotsForDate` / `normalizeVisitDate` / `expandVisitSchedule` | Pure schedule helpers (`America/Sao_Paulo`, default Mon–Fri 06:00–22:00) |
72
+ | `listingDetailModel(listing)` | Listing-detail blocks: breadcrumb, location + Maps href, `description` string + toggle label, video/tour overlays. Studio pages map `facts` / `values` via `.label` / `.text` leaves. |
73
+ | `listingDetailFieldsModel(listing, dictionary?)` | Facts, values, and amenity groups that are safe to render: every row has a real label + text; missing condo/IPTU/empty groups are omitted. Used by `ListingDetailFields` (0.4.13+). |
74
+ | `listingAmenityGroups(listing, dictionary?)` | Unit / building amenity labels (`Comodidades`, `Comodidades do condomínio`). Reads `propertyFeatures` + `buildingAmenities` (works when `building` is null). Tenant `getSearchUi().dictionary` first, then the SDK fallback. Studio pages call this helper directly. |
75
+ | `resolvePublicSiteId({ host?, fallback? })` | Preview uses `fallback` (`GARAGEM_SITE_ID`); live hosts resolve via `getSite({ domain })` |
75
76
 
76
77
  ### Advanced layer (when the friendly one isn't enough)
77
78
 
@@ -256,10 +257,11 @@ separate subpath — peer `react` + `next`.
256
257
 
257
258
  Studio codegen follows `STUDIO_SDK_CONTRACT`: pin
258
259
  `@garagem-ai/site-sdk` to `minNpmVersion` and import only
259
- `reactExports` (`SearchPage`, `ListingCard`, `usePublicSearch`,
260
- `ResultsSkeleton` on the Studio pin). Preview, open-in-new-tab, and
261
- published `next build` all resolve that tarball. Do **not** import npm
262
- CSS (`@garagem-ai/site-sdk/react/search.css`) in Studio.
260
+ `reactExports` (`SearchPage`, `ListingCard`,
261
+ `usePublicSearch`, `ResultsSkeleton` on the Studio pin). Preview,
262
+ open-in-new-tab, and published `next build` all resolve that tarball.
263
+ Do **not** import npm CSS (`@garagem-ai/site-sdk/react/search.css`) in
264
+ Studio.
263
265
 
264
266
  `SearchPage`, `ListingCard`, and `ResultsSkeleton` inject the chrome
265
267
  stylesheet (JS `<style>` tag). Layout tags are optional.
@@ -292,9 +294,11 @@ SearchPage fills its parent. Constrain width with `.max-w-site` and
292
294
  `variant` is `toolbar` (default), `dialog`, or `sidebar`. Customize with
293
295
  CSS variables (`SEARCH_CSS_VARS` / `SEARCH_CSS_RECIPE` in `globals.css`),
294
296
  `classNames`, `icons`, and `data-slot`. Home and search should share
295
- `ListingCard`. The search H1 is SEO stable: hit count is a sibling
296
- `<span>`, not inside `<h1>`. Presentation tokens stay framework-free on
297
- the main entry so other adapters can reuse them.
297
+ `ListingCard`. Listing detail maps `listingDetailModel` leaves and
298
+ `listingAmenityGroups`. The search H1 is SEO
299
+ stable: hit count is a sibling `<span>`, not inside `<h1>`. Presentation
300
+ tokens stay framework-free on the main entry so other adapters can reuse
301
+ them.
298
302
 
299
303
  Hand-written Next apps that prefer a layout tag or a padded search
300
304
  fallback can import those after they ship on npm; until then they are
package/dist/index.d.mts CHANGED
@@ -1,5 +1,5 @@
1
- import { R as RequestNextOptions, L as ListingFilters, Q as QueryListingsParams, S as SearchListingsParams, C as CmsCollection, a as CmsEntriesResult, b as CmsEntry, c as ListingDetail, d as ListingsResult, e as SearchUi, f as SimilarListingsResult, g as Site, h as QueryListingsResult, i as SearchListingsResult, j as ListingLocation, k as ListingMedia, l as SearchPathFilters, m as SearchUiDictionary, n as QueryListingsFilters, A as AppliedSearchQuery, o as AppliedSearchChange } from './search-engine-B83s_fVd.mjs';
2
- export { p as CmsEntryStatus, q as CmsFieldDefinition, r as CmsFieldType, s as CmsSeoData, F as FORBIDDEN_SEARCH_QUERY_KEYS, t as Listing, u as ListingBusinessType, v as ListingCardModel, w as ListingPriceVisibility, x as ListingPropertySummary, y as LocationNameTables, z as QueryListingsLocation, B as SEARCH_SORT_RELEVANCE, D as SearchPathLocation, E as SearchUiFilter, G as SearchUiOption, T as TOOLBAR_PRIMARY_FILTER_IDS, H as applyPathFilter, I as buildQueryListingsParams, J as canonicalizeSearchHref, K as clearStagedPathFilters, M as countFacetChoices, N as countOptionLabel, O as displayPathLocation, P as hrefForAppliedChange, U as hrefForPathFilters, V as hrefWithExplicitPage, W as isListingDetailPath, X as listingLocationLabel, Y as paginationPages, Z as pathFilterHasOption, _ as pathFilterValue, $ as publicSearchHref, a0 as readPublicSearch, a1 as searchHrefUsesLegacyFilterQuery, a2 as searchResultsHeading, a3 as searchSortOptions, a4 as toListingCardModel, a5 as toolbarFilterIds, a6 as visibleSearchFilters } from './search-engine-B83s_fVd.mjs';
1
+ import { R as RequestNextOptions, L as ListingFilters, Q as QueryListingsParams, S as SearchListingsParams, C as CmsCollection, a as CmsEntriesResult, b as CmsEntry, c as ListingDetail, d as ListingsResult, e as SearchUi, f as SimilarListingsResult, g as Site, h as QueryListingsResult, i as SearchListingsResult, j as SearchPathFilters, k as SearchUiDictionary, l as QueryListingsFilters, A as AppliedSearchQuery, m as AppliedSearchChange } from './search-engine-1O4sKtKb.mjs';
2
+ export { n as AMENITY_FALLBACK_LABELS, o as AmenityLabelDictionary, p as AmenityLabelOption, q as CmsEntryStatus, r as CmsFieldDefinition, s as CmsFieldType, t as CmsSeoData, F as FORBIDDEN_SEARCH_QUERY_KEYS, u as LISTING_AMENITY_TITLES, v as LISTING_DESCRIPTION_CLAMP, w as Listing, x as ListingAmenityGroup, y as ListingAmenityGroupKey, z as ListingAmenitySource, B as ListingBreadcrumbCrumb, D as ListingBusinessType, E as ListingCardModel, G as ListingDescriptionPreview, H as ListingDetailFieldsModel, I as ListingDetailFieldsSource, J as ListingDetailModel, K as ListingFact, M as ListingLocation, N as ListingLocationBlock, O as ListingMedia, P as ListingMediaOverlay, T as ListingPriceVisibility, U as ListingPropertySummary, V as ListingValue, W as LocationNameTables, X as QueryListingsLocation, Y as SEARCH_SORT_RELEVANCE, Z as SearchPathLocation, _ as SearchUiFilter, $ as SearchUiOption, a0 as TOOLBAR_PRIMARY_FILTER_IDS, a1 as applyPathFilter, a2 as buildQueryListingsParams, a3 as canonicalizeSearchHref, a4 as clearStagedPathFilters, a5 as countFacetChoices, a6 as countOptionLabel, a7 as displayPathLocation, a8 as hrefForAppliedChange, a9 as hrefForPathFilters, aa as hrefWithExplicitPage, ab as isListingDetailPath, ac as labelAmenities, ad as listingAmenityGroups, ae as listingBreadcrumb, af as listingDescriptionPreview, ag as listingDetailFieldsModel, ah as listingDetailModel, ai as listingFacts, aj as listingLocationBlock, ak as listingLocationLabel, al as listingMapsHref, am as listingMediaOverlays, an as listingValues, ao as paginationPages, ap as pathFilterHasOption, aq as pathFilterValue, ar as publicSearchHref, as as readPublicSearch, at as searchHrefUsesLegacyFilterQuery, au as searchResultsHeading, av as searchSortOptions, aw as toListingCardModel, ax as toolbarFilterIds, ay as visibleSearchFilters } from './search-engine-1O4sKtKb.mjs';
3
3
 
4
4
  /** Custom fetch implementation. Defaults to the global `fetch`. */
5
5
  type FetchLike = typeof fetch;
@@ -258,48 +258,6 @@ declare function getLeadUi(options: GetLeadUiOptions): Promise<LeadUi>;
258
258
  declare function submitVisitLead(input: VisitLeadInput): Promise<LeadSubmitResult>;
259
259
  declare function submitContactLead(input: ContactLeadInput): Promise<LeadSubmitResult>;
260
260
 
261
- /**
262
- * Portuguese labels for listing amenity ids. Tenant search-ui dictionary
263
- * wins; this map is the default-catalog fallback so generated Studio pages
264
- * never print camelCase keys.
265
- */
266
- declare const LISTING_AMENITY_TITLES: {
267
- readonly unit: "Comodidades";
268
- readonly building: "Comodidades do condomínio";
269
- };
270
- type AmenityLabelOption = {
271
- id: string;
272
- label: string;
273
- };
274
- type AmenityLabelDictionary = {
275
- propertyFeatures?: AmenityLabelOption[];
276
- buildingAmenities?: AmenityLabelOption[];
277
- };
278
- type ListingAmenityGroupKey = keyof typeof LISTING_AMENITY_TITLES;
279
- type ListingAmenityGroup = {
280
- key: ListingAmenityGroupKey;
281
- title: string;
282
- labels: string[];
283
- };
284
- type ListingAmenitySource = {
285
- amenities?: string[] | null;
286
- propertyFeatures?: string[] | null;
287
- /** Condo amenity ids, even when `building` is null (no buildingId). */
288
- buildingAmenities?: string[] | null;
289
- building?: {
290
- amenities?: string[] | null;
291
- } | null;
292
- };
293
- /**
294
- * Default tenant ids + canonical `has*` / `is*` keys seen on public listings.
295
- * Aligned with DEFAULT_PROPERTY_FEATURES and DEFAULT_BUILDING_FEATURES from
296
- * Foundation's field-definitions.ts so generated Studio pages never need a
297
- * dictionary for standard amenities.
298
- */
299
- declare const AMENITY_FALLBACK_LABELS: Record<string, string>;
300
- declare function labelAmenities(ids: readonly string[] | null | undefined, dictionary?: AmenityLabelOption[]): string[];
301
- declare function listingAmenityGroups(listing: ListingAmenitySource, dictionary?: AmenityLabelDictionary): ListingAmenityGroup[];
302
-
303
261
  /** Public listing URLs. Prefer `listing.path` from the API; fallback is `/imoveis/id-{listingCode}`. */
304
262
  declare function listingLookupKey(raw: string): string;
305
263
  declare function listingPublicPath(listing: {
@@ -308,84 +266,6 @@ declare function listingPublicPath(listing: {
308
266
  id?: string | null;
309
267
  }): string;
310
268
 
311
- declare const LISTING_DESCRIPTION_CLAMP = 280;
312
- type ListingFact = {
313
- key: string;
314
- label: string;
315
- text: string;
316
- };
317
- type ListingValue = {
318
- key: string;
319
- label: string;
320
- text: string;
321
- };
322
- type ListingBreadcrumbCrumb = {
323
- label: string;
324
- href: string;
325
- };
326
- type ListingLocationBlock = {
327
- label: string;
328
- mapsHref: string | null;
329
- };
330
- type ListingDescriptionPreview = {
331
- text: string;
332
- truncated: boolean;
333
- toggleLabel: string | null;
334
- };
335
- type ListingMediaOverlay = {
336
- key: "video" | "tour";
337
- hash: "video" | "tour";
338
- title: string;
339
- href: string;
340
- embedSrc: string;
341
- };
342
- declare function listingValues(listing: {
343
- price?: number | null;
344
- priceVisibility?: string | null;
345
- property?: {
346
- condoFee?: number | null;
347
- propertyTax?: number | null;
348
- } | null;
349
- }): ListingValue[];
350
- declare function listingFacts(listing: {
351
- property?: {
352
- totalArea?: number | null;
353
- usableArea?: number | null;
354
- bedrooms?: number | null;
355
- suites?: number | null;
356
- parkingSpaces?: number | null;
357
- rooms?: number | null;
358
- floor?: number | string | null;
359
- } | null;
360
- }): ListingFact[];
361
- declare function listingMapsHref(location: ListingLocation | null | undefined): string | null;
362
- declare function listingLocationBlock(listing: {
363
- location?: ListingLocation | null;
364
- } | null | undefined): ListingLocationBlock | null;
365
- declare function listingBreadcrumb(listing: {
366
- path?: string | null;
367
- listingCode?: string | null;
368
- id?: string | null;
369
- }): ListingBreadcrumbCrumb[];
370
- declare function listingDescriptionPreview(description: string | null | undefined, expanded?: boolean): ListingDescriptionPreview | null;
371
- declare function listingMediaOverlays(listing: {
372
- media?: ListingMedia[] | null;
373
- }): ListingMediaOverlay[];
374
- declare function listingDetailModel(listing: Pick<ListingDetail, "id" | "listingCode" | "path" | "price" | "priceVisibility" | "description"> & {
375
- property?: ListingDetail["property"] | null;
376
- location?: ListingLocation | null;
377
- media?: ListingMedia[] | null;
378
- }, options?: {
379
- descriptionExpanded?: boolean;
380
- }): {
381
- breadcrumb: ListingBreadcrumbCrumb[];
382
- values: ListingValue[];
383
- facts: ListingFact[];
384
- location: ListingLocationBlock | null;
385
- description: ListingDescriptionPreview | null;
386
- mediaOverlays: ListingMediaOverlay[];
387
- };
388
-
389
269
  /**
390
270
  * Presentation helpers with no UI framework.
391
271
  * React / React Native / Flutter adapters consume these formatters and
@@ -477,13 +357,12 @@ declare const STUDIO_SDK_PACKAGE: "@garagem-ai/site-sdk";
477
357
  declare const STUDIO_SDK_CONTRACT: {
478
358
  readonly package: "@garagem-ai/site-sdk";
479
359
  /**
480
- * Exact pin for generated Studio sites. Must be ≥ `selfInjectSince` so
481
- * prompts that skip the layout chrome tag match the tarball v0 installs.
482
- * 0.4.9 adds listingDetailModel (values, facts, location, breadcrumb,
483
- * description clamp, video/tour), getSimilarListings, and
484
- * listingAmenityGroups so listing detail never prints amenity ids.
360
+ * Exact pin for generated Studio sites. Must match a tarball already on
361
+ * npm — v0 installs this version. After the 0.4.13 changeset publishes,
362
+ * bump this and move that release's names from `optionalReactExports`
363
+ * into `reactExports`.
485
364
  */
486
- readonly minNpmVersion: "0.4.9";
365
+ readonly minNpmVersion: "0.4.12";
487
366
  /** First release where ListingCard and ResultsSkeleton inject the sheet. */
488
367
  readonly selfInjectSince: "0.4.2";
489
368
  readonly chromeStrategy: "self-inject";
@@ -498,6 +377,7 @@ declare const STUDIO_SDK_CONTRACT: {
498
377
  readonly optionalReactExports: {
499
378
  readonly SearchPageFallback: "0.4.1";
500
379
  readonly SearchChromeStyles: "0.4.1";
380
+ readonly ListingDetailFields: "0.4.13";
501
381
  };
502
382
  readonly forbiddenImports: readonly ["@garagem-ai/site-sdk/react/search.css"];
503
383
  readonly leadStrategy: "visit-default";
@@ -649,4 +529,4 @@ interface GaragemClient {
649
529
  */
650
530
  declare function createGaragemClient(options?: CreateGaragemClientOptions): GaragemClient;
651
531
 
652
- export { AMENITY_FALLBACK_LABELS, type AmenityLabelDictionary, type AmenityLabelOption, AppliedSearchChange, AppliedSearchQuery, CmsCollection, CmsEntriesResult, CmsEntry, type ContactLeadInput, type CreateGaragemClientOptions, type FetchLike, type GaragemClient, GaragemSdkError, type GetCmsCollectionOptions, type GetCmsCollectionsOptions, type GetCmsEntriesOptions, type GetCmsEntryOptions, type GetLeadUiOptions, type GetListingOptions, type GetListingsOptions, type GetSearchUiOptions, type GetSimilarListingsOptions, type GetSiteOptions, type HHmm, LISTING_AMENITY_TITLES, LISTING_DESCRIPTION_CLAMP, type LeadContact, type LeadField, type LeadFieldId, LeadSubmitError, type LeadSubmitErrorCode, type LeadSubmitResult, type LeadUi, type ListingAmenityGroup, type ListingAmenityGroupKey, type ListingAmenitySource, type ListingBreadcrumbCrumb, type ListingDescriptionPreview, ListingDetail, type ListingFact, ListingFilters, ListingLocation, type ListingLocationBlock, ListingMedia, type ListingMediaOverlay, type ListingValue, ListingsResult, type LocationFilterInput, QueryListingsFilters, type QueryListingsOptions, QueryListingsParams, QueryListingsResult, RequestNextOptions, type ResolvePublicSiteIdOptions, SEARCH_CSS_RECIPE, SEARCH_CSS_VARS, STUDIO_DEFAULT_VISIT_SCHEDULE, STUDIO_SDK_CONTRACT, STUDIO_SDK_PACKAGE, STUDIO_SITE_LAYOUT, type SearchListingsOptions, SearchListingsParams, SearchListingsResult, SearchPathFilters, SearchUi, SearchUiDictionary, SimilarListingsResult, Site, type StudioSdkContract, VISIT_TIME_ZONE, type VisitHours, type VisitLeadInput, type VisitSchedule, type VisitScheduleConfig, coerceNpmVersion, compareSemver, composeSearchPublicHref, composeSearchPublicPath, createGaragemClient, expandVisitSchedule, expandVisitTimeSlots, formatAreaM2, formatGroupedInteger, formatListingPrice, getCmsCollection, getCmsCollections, getCmsEntries, getCmsEntry, getLeadUi, getListing, getListings, getSearchUi, getSimilarListings, getSite, hasShowcaseLeadsPostUrl, isStudioPreviewHost, isVisitSlotAllowed, labelAmenities, listingAmenityGroups, listingBreadcrumb, listingBusinessLabel, listingDescriptionPreview, listingDetailModel, listingFacts, listingLocationBlock, listingLookupKey, listingMapsHref, listingMediaOverlays, listingPublicPath, listingValues, mergeAppliedSearchQueryIntoSearch, normalizeVisitDate, normalizeVisitTime, parseAppliedSearchQuery, parseGroupedInteger, parseReactSdkNamedImports, parseSearchPublicPath, pathFiltersToQueryFilters, pathLocationToFilterInput, queryListings, reduceAppliedSearchQuery, resolvePublicSiteId, searchListings, serializeAppliedSearchQuery, slotsForDate, studioAmenityInstruction, studioChromeInstruction, studioCodegenContractViolations, studioDefaultLeadUi, studioLayoutInstruction, studioLeadInstruction, studioListingDetailInstruction, studioSdkPinInstruction, studioSearchLandmarkInstruction, studioSiteWidthCss, submitContactLead, submitVisitLead, unavailableReactImports };
532
+ export { AppliedSearchChange, AppliedSearchQuery, CmsCollection, CmsEntriesResult, CmsEntry, type ContactLeadInput, type CreateGaragemClientOptions, type FetchLike, type GaragemClient, GaragemSdkError, type GetCmsCollectionOptions, type GetCmsCollectionsOptions, type GetCmsEntriesOptions, type GetCmsEntryOptions, type GetLeadUiOptions, type GetListingOptions, type GetListingsOptions, type GetSearchUiOptions, type GetSimilarListingsOptions, type GetSiteOptions, type HHmm, type LeadContact, type LeadField, type LeadFieldId, LeadSubmitError, type LeadSubmitErrorCode, type LeadSubmitResult, type LeadUi, ListingDetail, ListingFilters, ListingsResult, type LocationFilterInput, QueryListingsFilters, type QueryListingsOptions, QueryListingsParams, QueryListingsResult, RequestNextOptions, type ResolvePublicSiteIdOptions, SEARCH_CSS_RECIPE, SEARCH_CSS_VARS, STUDIO_DEFAULT_VISIT_SCHEDULE, STUDIO_SDK_CONTRACT, STUDIO_SDK_PACKAGE, STUDIO_SITE_LAYOUT, type SearchListingsOptions, SearchListingsParams, SearchListingsResult, SearchPathFilters, SearchUi, SearchUiDictionary, SimilarListingsResult, Site, type StudioSdkContract, VISIT_TIME_ZONE, type VisitHours, type VisitLeadInput, type VisitSchedule, type VisitScheduleConfig, coerceNpmVersion, compareSemver, composeSearchPublicHref, composeSearchPublicPath, createGaragemClient, expandVisitSchedule, expandVisitTimeSlots, formatAreaM2, formatGroupedInteger, formatListingPrice, getCmsCollection, getCmsCollections, getCmsEntries, getCmsEntry, getLeadUi, getListing, getListings, getSearchUi, getSimilarListings, getSite, hasShowcaseLeadsPostUrl, isStudioPreviewHost, isVisitSlotAllowed, listingBusinessLabel, listingLookupKey, listingPublicPath, mergeAppliedSearchQueryIntoSearch, normalizeVisitDate, normalizeVisitTime, parseAppliedSearchQuery, parseGroupedInteger, parseReactSdkNamedImports, parseSearchPublicPath, pathFiltersToQueryFilters, pathLocationToFilterInput, queryListings, reduceAppliedSearchQuery, resolvePublicSiteId, searchListings, serializeAppliedSearchQuery, slotsForDate, studioAmenityInstruction, studioChromeInstruction, studioCodegenContractViolations, studioDefaultLeadUi, studioLayoutInstruction, studioLeadInstruction, studioListingDetailInstruction, studioSdkPinInstruction, studioSearchLandmarkInstruction, studioSiteWidthCss, submitContactLead, submitVisitLead, unavailableReactImports };
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { R as RequestNextOptions, L as ListingFilters, Q as QueryListingsParams, S as SearchListingsParams, C as CmsCollection, a as CmsEntriesResult, b as CmsEntry, c as ListingDetail, d as ListingsResult, e as SearchUi, f as SimilarListingsResult, g as Site, h as QueryListingsResult, i as SearchListingsResult, j as ListingLocation, k as ListingMedia, l as SearchPathFilters, m as SearchUiDictionary, n as QueryListingsFilters, A as AppliedSearchQuery, o as AppliedSearchChange } from './search-engine-B83s_fVd.js';
2
- export { p as CmsEntryStatus, q as CmsFieldDefinition, r as CmsFieldType, s as CmsSeoData, F as FORBIDDEN_SEARCH_QUERY_KEYS, t as Listing, u as ListingBusinessType, v as ListingCardModel, w as ListingPriceVisibility, x as ListingPropertySummary, y as LocationNameTables, z as QueryListingsLocation, B as SEARCH_SORT_RELEVANCE, D as SearchPathLocation, E as SearchUiFilter, G as SearchUiOption, T as TOOLBAR_PRIMARY_FILTER_IDS, H as applyPathFilter, I as buildQueryListingsParams, J as canonicalizeSearchHref, K as clearStagedPathFilters, M as countFacetChoices, N as countOptionLabel, O as displayPathLocation, P as hrefForAppliedChange, U as hrefForPathFilters, V as hrefWithExplicitPage, W as isListingDetailPath, X as listingLocationLabel, Y as paginationPages, Z as pathFilterHasOption, _ as pathFilterValue, $ as publicSearchHref, a0 as readPublicSearch, a1 as searchHrefUsesLegacyFilterQuery, a2 as searchResultsHeading, a3 as searchSortOptions, a4 as toListingCardModel, a5 as toolbarFilterIds, a6 as visibleSearchFilters } from './search-engine-B83s_fVd.js';
1
+ import { R as RequestNextOptions, L as ListingFilters, Q as QueryListingsParams, S as SearchListingsParams, C as CmsCollection, a as CmsEntriesResult, b as CmsEntry, c as ListingDetail, d as ListingsResult, e as SearchUi, f as SimilarListingsResult, g as Site, h as QueryListingsResult, i as SearchListingsResult, j as SearchPathFilters, k as SearchUiDictionary, l as QueryListingsFilters, A as AppliedSearchQuery, m as AppliedSearchChange } from './search-engine-1O4sKtKb.js';
2
+ export { n as AMENITY_FALLBACK_LABELS, o as AmenityLabelDictionary, p as AmenityLabelOption, q as CmsEntryStatus, r as CmsFieldDefinition, s as CmsFieldType, t as CmsSeoData, F as FORBIDDEN_SEARCH_QUERY_KEYS, u as LISTING_AMENITY_TITLES, v as LISTING_DESCRIPTION_CLAMP, w as Listing, x as ListingAmenityGroup, y as ListingAmenityGroupKey, z as ListingAmenitySource, B as ListingBreadcrumbCrumb, D as ListingBusinessType, E as ListingCardModel, G as ListingDescriptionPreview, H as ListingDetailFieldsModel, I as ListingDetailFieldsSource, J as ListingDetailModel, K as ListingFact, M as ListingLocation, N as ListingLocationBlock, O as ListingMedia, P as ListingMediaOverlay, T as ListingPriceVisibility, U as ListingPropertySummary, V as ListingValue, W as LocationNameTables, X as QueryListingsLocation, Y as SEARCH_SORT_RELEVANCE, Z as SearchPathLocation, _ as SearchUiFilter, $ as SearchUiOption, a0 as TOOLBAR_PRIMARY_FILTER_IDS, a1 as applyPathFilter, a2 as buildQueryListingsParams, a3 as canonicalizeSearchHref, a4 as clearStagedPathFilters, a5 as countFacetChoices, a6 as countOptionLabel, a7 as displayPathLocation, a8 as hrefForAppliedChange, a9 as hrefForPathFilters, aa as hrefWithExplicitPage, ab as isListingDetailPath, ac as labelAmenities, ad as listingAmenityGroups, ae as listingBreadcrumb, af as listingDescriptionPreview, ag as listingDetailFieldsModel, ah as listingDetailModel, ai as listingFacts, aj as listingLocationBlock, ak as listingLocationLabel, al as listingMapsHref, am as listingMediaOverlays, an as listingValues, ao as paginationPages, ap as pathFilterHasOption, aq as pathFilterValue, ar as publicSearchHref, as as readPublicSearch, at as searchHrefUsesLegacyFilterQuery, au as searchResultsHeading, av as searchSortOptions, aw as toListingCardModel, ax as toolbarFilterIds, ay as visibleSearchFilters } from './search-engine-1O4sKtKb.js';
3
3
 
4
4
  /** Custom fetch implementation. Defaults to the global `fetch`. */
5
5
  type FetchLike = typeof fetch;
@@ -258,48 +258,6 @@ declare function getLeadUi(options: GetLeadUiOptions): Promise<LeadUi>;
258
258
  declare function submitVisitLead(input: VisitLeadInput): Promise<LeadSubmitResult>;
259
259
  declare function submitContactLead(input: ContactLeadInput): Promise<LeadSubmitResult>;
260
260
 
261
- /**
262
- * Portuguese labels for listing amenity ids. Tenant search-ui dictionary
263
- * wins; this map is the default-catalog fallback so generated Studio pages
264
- * never print camelCase keys.
265
- */
266
- declare const LISTING_AMENITY_TITLES: {
267
- readonly unit: "Comodidades";
268
- readonly building: "Comodidades do condomínio";
269
- };
270
- type AmenityLabelOption = {
271
- id: string;
272
- label: string;
273
- };
274
- type AmenityLabelDictionary = {
275
- propertyFeatures?: AmenityLabelOption[];
276
- buildingAmenities?: AmenityLabelOption[];
277
- };
278
- type ListingAmenityGroupKey = keyof typeof LISTING_AMENITY_TITLES;
279
- type ListingAmenityGroup = {
280
- key: ListingAmenityGroupKey;
281
- title: string;
282
- labels: string[];
283
- };
284
- type ListingAmenitySource = {
285
- amenities?: string[] | null;
286
- propertyFeatures?: string[] | null;
287
- /** Condo amenity ids, even when `building` is null (no buildingId). */
288
- buildingAmenities?: string[] | null;
289
- building?: {
290
- amenities?: string[] | null;
291
- } | null;
292
- };
293
- /**
294
- * Default tenant ids + canonical `has*` / `is*` keys seen on public listings.
295
- * Aligned with DEFAULT_PROPERTY_FEATURES and DEFAULT_BUILDING_FEATURES from
296
- * Foundation's field-definitions.ts so generated Studio pages never need a
297
- * dictionary for standard amenities.
298
- */
299
- declare const AMENITY_FALLBACK_LABELS: Record<string, string>;
300
- declare function labelAmenities(ids: readonly string[] | null | undefined, dictionary?: AmenityLabelOption[]): string[];
301
- declare function listingAmenityGroups(listing: ListingAmenitySource, dictionary?: AmenityLabelDictionary): ListingAmenityGroup[];
302
-
303
261
  /** Public listing URLs. Prefer `listing.path` from the API; fallback is `/imoveis/id-{listingCode}`. */
304
262
  declare function listingLookupKey(raw: string): string;
305
263
  declare function listingPublicPath(listing: {
@@ -308,84 +266,6 @@ declare function listingPublicPath(listing: {
308
266
  id?: string | null;
309
267
  }): string;
310
268
 
311
- declare const LISTING_DESCRIPTION_CLAMP = 280;
312
- type ListingFact = {
313
- key: string;
314
- label: string;
315
- text: string;
316
- };
317
- type ListingValue = {
318
- key: string;
319
- label: string;
320
- text: string;
321
- };
322
- type ListingBreadcrumbCrumb = {
323
- label: string;
324
- href: string;
325
- };
326
- type ListingLocationBlock = {
327
- label: string;
328
- mapsHref: string | null;
329
- };
330
- type ListingDescriptionPreview = {
331
- text: string;
332
- truncated: boolean;
333
- toggleLabel: string | null;
334
- };
335
- type ListingMediaOverlay = {
336
- key: "video" | "tour";
337
- hash: "video" | "tour";
338
- title: string;
339
- href: string;
340
- embedSrc: string;
341
- };
342
- declare function listingValues(listing: {
343
- price?: number | null;
344
- priceVisibility?: string | null;
345
- property?: {
346
- condoFee?: number | null;
347
- propertyTax?: number | null;
348
- } | null;
349
- }): ListingValue[];
350
- declare function listingFacts(listing: {
351
- property?: {
352
- totalArea?: number | null;
353
- usableArea?: number | null;
354
- bedrooms?: number | null;
355
- suites?: number | null;
356
- parkingSpaces?: number | null;
357
- rooms?: number | null;
358
- floor?: number | string | null;
359
- } | null;
360
- }): ListingFact[];
361
- declare function listingMapsHref(location: ListingLocation | null | undefined): string | null;
362
- declare function listingLocationBlock(listing: {
363
- location?: ListingLocation | null;
364
- } | null | undefined): ListingLocationBlock | null;
365
- declare function listingBreadcrumb(listing: {
366
- path?: string | null;
367
- listingCode?: string | null;
368
- id?: string | null;
369
- }): ListingBreadcrumbCrumb[];
370
- declare function listingDescriptionPreview(description: string | null | undefined, expanded?: boolean): ListingDescriptionPreview | null;
371
- declare function listingMediaOverlays(listing: {
372
- media?: ListingMedia[] | null;
373
- }): ListingMediaOverlay[];
374
- declare function listingDetailModel(listing: Pick<ListingDetail, "id" | "listingCode" | "path" | "price" | "priceVisibility" | "description"> & {
375
- property?: ListingDetail["property"] | null;
376
- location?: ListingLocation | null;
377
- media?: ListingMedia[] | null;
378
- }, options?: {
379
- descriptionExpanded?: boolean;
380
- }): {
381
- breadcrumb: ListingBreadcrumbCrumb[];
382
- values: ListingValue[];
383
- facts: ListingFact[];
384
- location: ListingLocationBlock | null;
385
- description: ListingDescriptionPreview | null;
386
- mediaOverlays: ListingMediaOverlay[];
387
- };
388
-
389
269
  /**
390
270
  * Presentation helpers with no UI framework.
391
271
  * React / React Native / Flutter adapters consume these formatters and
@@ -477,13 +357,12 @@ declare const STUDIO_SDK_PACKAGE: "@garagem-ai/site-sdk";
477
357
  declare const STUDIO_SDK_CONTRACT: {
478
358
  readonly package: "@garagem-ai/site-sdk";
479
359
  /**
480
- * Exact pin for generated Studio sites. Must be ≥ `selfInjectSince` so
481
- * prompts that skip the layout chrome tag match the tarball v0 installs.
482
- * 0.4.9 adds listingDetailModel (values, facts, location, breadcrumb,
483
- * description clamp, video/tour), getSimilarListings, and
484
- * listingAmenityGroups so listing detail never prints amenity ids.
360
+ * Exact pin for generated Studio sites. Must match a tarball already on
361
+ * npm — v0 installs this version. After the 0.4.13 changeset publishes,
362
+ * bump this and move that release's names from `optionalReactExports`
363
+ * into `reactExports`.
485
364
  */
486
- readonly minNpmVersion: "0.4.9";
365
+ readonly minNpmVersion: "0.4.12";
487
366
  /** First release where ListingCard and ResultsSkeleton inject the sheet. */
488
367
  readonly selfInjectSince: "0.4.2";
489
368
  readonly chromeStrategy: "self-inject";
@@ -498,6 +377,7 @@ declare const STUDIO_SDK_CONTRACT: {
498
377
  readonly optionalReactExports: {
499
378
  readonly SearchPageFallback: "0.4.1";
500
379
  readonly SearchChromeStyles: "0.4.1";
380
+ readonly ListingDetailFields: "0.4.13";
501
381
  };
502
382
  readonly forbiddenImports: readonly ["@garagem-ai/site-sdk/react/search.css"];
503
383
  readonly leadStrategy: "visit-default";
@@ -649,4 +529,4 @@ interface GaragemClient {
649
529
  */
650
530
  declare function createGaragemClient(options?: CreateGaragemClientOptions): GaragemClient;
651
531
 
652
- export { AMENITY_FALLBACK_LABELS, type AmenityLabelDictionary, type AmenityLabelOption, AppliedSearchChange, AppliedSearchQuery, CmsCollection, CmsEntriesResult, CmsEntry, type ContactLeadInput, type CreateGaragemClientOptions, type FetchLike, type GaragemClient, GaragemSdkError, type GetCmsCollectionOptions, type GetCmsCollectionsOptions, type GetCmsEntriesOptions, type GetCmsEntryOptions, type GetLeadUiOptions, type GetListingOptions, type GetListingsOptions, type GetSearchUiOptions, type GetSimilarListingsOptions, type GetSiteOptions, type HHmm, LISTING_AMENITY_TITLES, LISTING_DESCRIPTION_CLAMP, type LeadContact, type LeadField, type LeadFieldId, LeadSubmitError, type LeadSubmitErrorCode, type LeadSubmitResult, type LeadUi, type ListingAmenityGroup, type ListingAmenityGroupKey, type ListingAmenitySource, type ListingBreadcrumbCrumb, type ListingDescriptionPreview, ListingDetail, type ListingFact, ListingFilters, ListingLocation, type ListingLocationBlock, ListingMedia, type ListingMediaOverlay, type ListingValue, ListingsResult, type LocationFilterInput, QueryListingsFilters, type QueryListingsOptions, QueryListingsParams, QueryListingsResult, RequestNextOptions, type ResolvePublicSiteIdOptions, SEARCH_CSS_RECIPE, SEARCH_CSS_VARS, STUDIO_DEFAULT_VISIT_SCHEDULE, STUDIO_SDK_CONTRACT, STUDIO_SDK_PACKAGE, STUDIO_SITE_LAYOUT, type SearchListingsOptions, SearchListingsParams, SearchListingsResult, SearchPathFilters, SearchUi, SearchUiDictionary, SimilarListingsResult, Site, type StudioSdkContract, VISIT_TIME_ZONE, type VisitHours, type VisitLeadInput, type VisitSchedule, type VisitScheduleConfig, coerceNpmVersion, compareSemver, composeSearchPublicHref, composeSearchPublicPath, createGaragemClient, expandVisitSchedule, expandVisitTimeSlots, formatAreaM2, formatGroupedInteger, formatListingPrice, getCmsCollection, getCmsCollections, getCmsEntries, getCmsEntry, getLeadUi, getListing, getListings, getSearchUi, getSimilarListings, getSite, hasShowcaseLeadsPostUrl, isStudioPreviewHost, isVisitSlotAllowed, labelAmenities, listingAmenityGroups, listingBreadcrumb, listingBusinessLabel, listingDescriptionPreview, listingDetailModel, listingFacts, listingLocationBlock, listingLookupKey, listingMapsHref, listingMediaOverlays, listingPublicPath, listingValues, mergeAppliedSearchQueryIntoSearch, normalizeVisitDate, normalizeVisitTime, parseAppliedSearchQuery, parseGroupedInteger, parseReactSdkNamedImports, parseSearchPublicPath, pathFiltersToQueryFilters, pathLocationToFilterInput, queryListings, reduceAppliedSearchQuery, resolvePublicSiteId, searchListings, serializeAppliedSearchQuery, slotsForDate, studioAmenityInstruction, studioChromeInstruction, studioCodegenContractViolations, studioDefaultLeadUi, studioLayoutInstruction, studioLeadInstruction, studioListingDetailInstruction, studioSdkPinInstruction, studioSearchLandmarkInstruction, studioSiteWidthCss, submitContactLead, submitVisitLead, unavailableReactImports };
532
+ export { AppliedSearchChange, AppliedSearchQuery, CmsCollection, CmsEntriesResult, CmsEntry, type ContactLeadInput, type CreateGaragemClientOptions, type FetchLike, type GaragemClient, GaragemSdkError, type GetCmsCollectionOptions, type GetCmsCollectionsOptions, type GetCmsEntriesOptions, type GetCmsEntryOptions, type GetLeadUiOptions, type GetListingOptions, type GetListingsOptions, type GetSearchUiOptions, type GetSimilarListingsOptions, type GetSiteOptions, type HHmm, type LeadContact, type LeadField, type LeadFieldId, LeadSubmitError, type LeadSubmitErrorCode, type LeadSubmitResult, type LeadUi, ListingDetail, ListingFilters, ListingsResult, type LocationFilterInput, QueryListingsFilters, type QueryListingsOptions, QueryListingsParams, QueryListingsResult, RequestNextOptions, type ResolvePublicSiteIdOptions, SEARCH_CSS_RECIPE, SEARCH_CSS_VARS, STUDIO_DEFAULT_VISIT_SCHEDULE, STUDIO_SDK_CONTRACT, STUDIO_SDK_PACKAGE, STUDIO_SITE_LAYOUT, type SearchListingsOptions, SearchListingsParams, SearchListingsResult, SearchPathFilters, SearchUi, SearchUiDictionary, SimilarListingsResult, Site, type StudioSdkContract, VISIT_TIME_ZONE, type VisitHours, type VisitLeadInput, type VisitSchedule, type VisitScheduleConfig, coerceNpmVersion, compareSemver, composeSearchPublicHref, composeSearchPublicPath, createGaragemClient, expandVisitSchedule, expandVisitTimeSlots, formatAreaM2, formatGroupedInteger, formatListingPrice, getCmsCollection, getCmsCollections, getCmsEntries, getCmsEntry, getLeadUi, getListing, getListings, getSearchUi, getSimilarListings, getSite, hasShowcaseLeadsPostUrl, isStudioPreviewHost, isVisitSlotAllowed, listingBusinessLabel, listingLookupKey, listingPublicPath, mergeAppliedSearchQueryIntoSearch, normalizeVisitDate, normalizeVisitTime, parseAppliedSearchQuery, parseGroupedInteger, parseReactSdkNamedImports, parseSearchPublicPath, pathFiltersToQueryFilters, pathLocationToFilterInput, queryListings, reduceAppliedSearchQuery, resolvePublicSiteId, searchListings, serializeAppliedSearchQuery, slotsForDate, studioAmenityInstruction, studioChromeInstruction, studioCodegenContractViolations, studioDefaultLeadUi, studioLayoutInstruction, studioLeadInstruction, studioListingDetailInstruction, studioSdkPinInstruction, studioSearchLandmarkInstruction, studioSiteWidthCss, submitContactLead, submitVisitLead, unavailableReactImports };
package/dist/index.js CHANGED
@@ -74,6 +74,7 @@ __export(src_exports, {
74
74
  listingBreadcrumb: () => listingBreadcrumb,
75
75
  listingBusinessLabel: () => listingBusinessLabel,
76
76
  listingDescriptionPreview: () => listingDescriptionPreview,
77
+ listingDetailFieldsModel: () => listingDetailFieldsModel,
77
78
  listingDetailModel: () => listingDetailModel,
78
79
  listingFacts: () => listingFacts,
79
80
  listingLocationBlock: () => listingLocationBlock,
@@ -2288,31 +2289,58 @@ function listingMediaOverlays(listing) {
2288
2289
  return overlays;
2289
2290
  }
2290
2291
  function listingDetailModel(listing, options) {
2292
+ const text = listing.description?.trim() ?? "";
2293
+ const description = text || null;
2294
+ const truncated = description != null && description.length > LISTING_DESCRIPTION_CLAMP;
2295
+ const expanded = options?.descriptionExpanded === true;
2291
2296
  return {
2292
2297
  breadcrumb: listingBreadcrumb(listing),
2293
2298
  values: listingValues(listing),
2294
2299
  facts: listingFacts(listing),
2295
2300
  location: listingLocationBlock(listing),
2296
- description: listingDescriptionPreview(
2297
- listing.description,
2298
- options?.descriptionExpanded === true
2299
- ),
2301
+ description,
2302
+ descriptionTruncated: truncated,
2303
+ descriptionToggleLabel: truncated ? expanded ? "Ler menos" : "Ler mais" : null,
2300
2304
  mediaOverlays: listingMediaOverlays(listing)
2301
2305
  };
2302
2306
  }
2303
2307
 
2308
+ // src/listing-detail-fields.ts
2309
+ function visibleText(value) {
2310
+ if (typeof value !== "string") return null;
2311
+ const trimmed = value.trim();
2312
+ if (!trimmed || trimmed === "undefined" || trimmed === "null") return null;
2313
+ return trimmed;
2314
+ }
2315
+ function visibleRows(rows) {
2316
+ return rows.filter((row) => {
2317
+ const label = visibleText(row.label);
2318
+ const text = visibleText(row.text);
2319
+ return label != null && text != null;
2320
+ });
2321
+ }
2322
+ function listingDetailFieldsModel(listing, dictionary) {
2323
+ return {
2324
+ facts: visibleRows(listingFacts(listing)),
2325
+ values: visibleRows(listingValues(listing)),
2326
+ amenityGroups: listingAmenityGroups(listing, dictionary).map((group) => ({
2327
+ ...group,
2328
+ labels: group.labels.map((label) => visibleText(label)).filter((label) => label != null)
2329
+ })).filter((group) => group.labels.length > 0)
2330
+ };
2331
+ }
2332
+
2304
2333
  // src/studio-contract.ts
2305
2334
  var STUDIO_SDK_PACKAGE = "@garagem-ai/site-sdk";
2306
2335
  var STUDIO_SDK_CONTRACT = {
2307
2336
  package: STUDIO_SDK_PACKAGE,
2308
2337
  /**
2309
- * Exact pin for generated Studio sites. Must be ≥ `selfInjectSince` so
2310
- * prompts that skip the layout chrome tag match the tarball v0 installs.
2311
- * 0.4.9 adds listingDetailModel (values, facts, location, breadcrumb,
2312
- * description clamp, video/tour), getSimilarListings, and
2313
- * listingAmenityGroups so listing detail never prints amenity ids.
2338
+ * Exact pin for generated Studio sites. Must match a tarball already on
2339
+ * npm — v0 installs this version. After the 0.4.13 changeset publishes,
2340
+ * bump this and move that release's names from `optionalReactExports`
2341
+ * into `reactExports`.
2314
2342
  */
2315
- minNpmVersion: "0.4.9",
2343
+ minNpmVersion: "0.4.12",
2316
2344
  /** First release where ListingCard and ResultsSkeleton inject the sheet. */
2317
2345
  selfInjectSince: "0.4.2",
2318
2346
  chromeStrategy: "self-inject",
@@ -2331,7 +2359,8 @@ var STUDIO_SDK_CONTRACT = {
2331
2359
  */
2332
2360
  optionalReactExports: {
2333
2361
  SearchPageFallback: "0.4.1",
2334
- SearchChromeStyles: "0.4.1"
2362
+ SearchChromeStyles: "0.4.1",
2363
+ ListingDetailFields: "0.4.13"
2335
2364
  },
2336
2365
  forbiddenImports: ["@garagem-ai/site-sdk/react/search.css"],
2337
2366
  leadStrategy: "visit-default",
@@ -2375,7 +2404,7 @@ ${studioSiteWidthCss()}
2375
2404
  Every page section is two layers: (1) surface \u2014 \`section\` / header / footer \`${STUDIO_SITE_LAYOUT.surfaceClassName}\`, background to the viewport edges, no max-width class and no horizontal padding; (2) wrapper \u2014 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 \u2014 do not add vertical padding there.`;
2376
2405
  }
2377
2406
  function studioSearchLandmarkInstruction() {
2378
- 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>\` \u2014 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.`;
2407
+ 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. Mount as one line: \`<SearchPage as="div" siteId={() => resolveSiteId(window.location.host)} baseUrl={GARAGEM_API_BASE} variant="toolbar" />\`. Do not wrap \`SearchPage\` in \`<section>\` or add another \`<h1>\`. SearchPage owns the SEO heading: count in \`data-slot="search-heading-count"\` (sibling \`<span>\`), title in \`<h1 data-slot="search-heading-title">\` \u2014 never put the count inside the H1. Do not put vertical padding on SearchPage. \`pt-4 pb-12\` is the default on that search \`<main>\` \u2014 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.`;
2379
2408
  }
2380
2409
  var REACT_SDK_NAMED_IMPORT_RE = /(?:^|[\n;])\s*import\s+(?!type\b)(?:type\s+)?\{([^}]+)\}\s+from\s+['"]@garagem-ai\/site-sdk\/react['"]/g;
2381
2410
  var SHOWCASE_LEADS_POST_URL_RE = /\/api\/sites\/[^\s"']*\/leads(?!\/ui)/;
@@ -2442,11 +2471,10 @@ function studioLeadInstruction() {
2442
2471
  }
2443
2472
  function studioListingDetailInstruction() {
2444
2473
  const names = STUDIO_SDK_CONTRACT.listingDetailExports.join(", ");
2445
- return `Listing detail blocks: import ${names} from \`${STUDIO_SDK_PACKAGE}\` and \`ListingCard\` from \`${STUDIO_SDK_PACKAGE}/react\`. Render \`listingDetailModel(listing)\` for breadcrumb (hrefs are search prefixes of \`listing.path\`, never invented paths), values (price / sob consulta, condo, IPTU), facts (omit empty zeros; bedrooms \u2260 salas), location plus a discreet Google Maps \`<a target="_blank" rel="noopener noreferrer">\`, and description with the helper clamp + toggle (keep the full text; do not drop the remainder). Video/tour: \`model.mediaOverlays\` as hash links (\`#video\` / \`#tour\`) and a fullscreen overlay that closes with browser back; omit when empty. Similar listings: \`getSimilarListings({ siteId, listingId, baseUrl })\` + \`ListingCard\`; hide the section when the list is empty. Do not invent a local recommendation loop.`;
2474
+ return `Listing detail: import ${names} from \`${STUDIO_SDK_PACKAGE}\` and \`ListingCard\` from \`${STUDIO_SDK_PACKAGE}/react\`. Render \`listingDetailModel\` leaves: \`model.facts[].label\` / \`.text\`, \`model.values[].label\` / \`.text\`, \`model.location.label\` / \`model.location.mapsHref\`, breadcrumb \`.href\` (search prefixes of \`listing.path\`). \`model.description\` is the complete string \u2014 do not slice. Never interpolate \`model.location\`, \`model.facts\`, \`model.values\`, \`model.breadcrumb\`, or \`model.mediaOverlays\` as a React child. Video/tour: \`model.mediaOverlays\` as hash links (\`#video\` / \`#tour\`) and a fullscreen overlay that closes with browser back; omit when empty. Similar listings: \`getSimilarListings({ siteId, listingId, baseUrl })\` + \`ListingCard\`; hide the section when empty. Do not invent a local recommendation loop.`;
2446
2475
  }
2447
2476
  function studioAmenityInstruction() {
2448
- const names = STUDIO_SDK_CONTRACT.amenityExports.join(", ");
2449
- 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\xEDnio\`). Labels are already alphabetical (pt-BR) \u2014 keep that order. Omit empty groups. Never print amenity ids, never invent a local label map, and never title a section "Comodidades da unidade".`;
2477
+ return `Listing amenities: Portuguese labels from \`listingAmenityGroups(listing)\` (optional dictionary from \`getSearchUi()\`). Titles: \`Comodidades\` / \`Comodidades do condom\xEDnio\`. Never print amenity ids, never invent a local label map, and never title a section "Comodidades da unidade".`;
2450
2478
  }
2451
2479
  function studioChromeInstruction() {
2452
2480
  const injectors = compareSemver(
@@ -2687,6 +2715,7 @@ function createGaragemClient(options = {}) {
2687
2715
  listingBreadcrumb,
2688
2716
  listingBusinessLabel,
2689
2717
  listingDescriptionPreview,
2718
+ listingDetailFieldsModel,
2690
2719
  listingDetailModel,
2691
2720
  listingFacts,
2692
2721
  listingLocationBlock,