@garagem-ai/site-sdk 0.13.6 → 0.14.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.
package/dist/index.d.mts CHANGED
@@ -1,5 +1,5 @@
1
- import { L as ListingDetail, F as FetchLike, R as RequestNextOptions, a as Listing, b as ListingLocation, c as ListingMedia, S as SearchPathFilters, d as SearchUiDictionary, Q as QueryListingsFilters, A as AppliedSearchQuery, e as AppliedSearchChange, f as ListingFilters, g as ListingsResult, h as Site, i as SearchListingsParams, j as SearchListingsResult, k as SearchUi, l as QueryListingsParams, m as QueryListingsResult, n as SimilarListingsResult, C as CmsCollection, o as CmsEntriesResult, p as CmsEntry, B as BoundaryCity, q as BoundaryLayerOptions, M as MapsCoordinates, T as TravelTimeCacheOptions, r as TravelTimeCache, s as MapsFetchOptions, t as BoundaryLayer, u as ListingWithLocation, v as StaticMapOptions, w as StreetViewAvailabilityOptions, x as StreetViewAvailability, y as StreetViewOptions, N as NeighborhoodBoundaryOptions, z as NeighborhoodBoundary, D as TravelDestination, E as TravelMode, G as TravelTimeOptions, H as TravelTime, I as TravelTimesOptions, J as TravelTimeElement, P as PhotoSearchParams, K as PhotoSearchResult, O as PhotoSearchItem, U as ListingWithMatchedPhoto, V as MatchedListingPhoto } from './types-photo-search-CVPyF9zC.mjs';
2
- export { W as BoundaryFeature, X as BoundaryFeatureCollection, Y as BoundaryGeometry, Z as BoundaryLayerUrlKind, _ as BoundarySourceLayer, $ as CmsEntryStatus, a0 as CmsFieldDefinition, a1 as CmsFieldType, a2 as CmsSeoData, a3 as FORBIDDEN_SEARCH_QUERY_KEYS, a4 as GaragemSdkError, a5 as GetCmsCollectionOptions, a6 as GetCmsCollectionsOptions, a7 as GetCmsEntriesOptions, a8 as GetCmsEntryOptions, a9 as GetListingOptions, aa as GetListingsOptions, ab as GetSearchUiOptions, ac as GetSimilarListingsOptions, ad as GetSiteOptions, ae as ListingBusinessType, af as ListingCardModel, ag as ListingPriceVisibility, ah as ListingPropertySummary, ai as LocationNameTables, aj as MAP_POLYGON_MAX_VERTICES, ak as MAP_SEARCH_DEFAULT_PAGE_SIZE, al as MAP_SEARCH_MAX_PAGE_SIZE, am as MAP_VIEWPORT_DEBOUNCE_MS, an as MapBounds, ao as MapBoundsSearchOptions, ap as MapBucket, aq as MapPin, ar as MapPinCluster, as as MapPolygon, at as MapPolygonSearchOptions, au as MapSearchResult, av as MapsBaseOptions, aw as QueryListingsLocation, ax as QueryListingsOptions, ay as SEARCH_EMPTY_COPY, az as SEARCH_SORT_RELEVANCE, aA as SearchChromeModel, aB as SearchListingsOptions, aC as SearchPathLocation, aD as SearchUiFilter, aE as SearchUiOption, aF as StaticMapStyle, aG as TOOLBAR_PRIMARY_FILTER_IDS, aH as applyPathFilter, aI as buildQueryListingsParams, aJ as canonicalizeSearchHref, aK as capMapPage, aL as capMapPageSize, aM as clearStagedPathFilters, aN as clusterBuckets, aO as clusterPins, aP as countFacetChoices, aQ as countOptionLabel, aR as displayPathLocation, aS as getCmsCollection, aT as getCmsCollections, aU as getCmsEntries, aV as getCmsEntry, aW as getListing, aX as getListings, aY as getSearchUi, aZ as getSimilarListings, a_ as getSite, a$ as hrefForAppliedChange, b0 as hrefForPathFilters, b1 as hrefWithExplicitPage, b2 as isListingDetailPath, b3 as isMapBounds, b4 as isMapPolygon, b5 as listingLocationLabel, b6 as mapClusterCellDegrees, b7 as mapSearchPins, b8 as paginationPages, b9 as pathFilterHasOption, ba as pathFilterValue, bb as publicSearchHref, bc as queryListings, bd as rangeDraftFromPath, be as readPublicSearch, bf as searchChromeModel, bg as searchHrefUsesLegacyFilterQuery, bh as searchListings, bi as searchListingsInBounds, bj as searchListingsInPolygon, bk as searchResultsHeading, bl as searchSortOptions, bm as toListingCardModel, bn as toolbarFilterIds, bo as unknownSearchLocation, bp as visibleSearchFilters } from './types-photo-search-CVPyF9zC.mjs';
1
+ import { L as ListingDetail, F as FetchLike, R as RequestNextOptions, a as Listing, b as ListingLocation, c as ListingMedia, S as SearchPathFilters, d as SearchUiDictionary, Q as QueryListingsFilters, A as AppliedSearchQuery, e as AppliedSearchChange, f as ListingFilters, g as ListingsResult, h as Site, i as SearchListingsParams, j as SearchListingsResult, k as SearchUi, l as QueryListingsParams, m as QueryListingsResult, n as SimilarListingsResult, C as CmsCollection, o as CmsEntriesResult, p as CmsEntry, B as BoundaryCity, q as BoundaryLayerOptions, M as MapsCoordinates, T as TravelTimeCacheOptions, r as TravelTimeCache, s as MapsFetchOptions, t as BoundaryLayer, u as ListingWithLocation, v as StaticMapOptions, w as StreetViewAvailabilityOptions, x as StreetViewAvailability, y as StreetViewOptions, N as NeighborhoodBoundaryOptions, z as NeighborhoodBoundary, D as TravelDestination, E as TravelMode, G as TravelTimeOptions, H as TravelTime, I as TravelTimesOptions, J as TravelTimeElement, P as PhotoSearchParams, K as PhotoSearchResult, O as PhotoSearchItem, U as ListingWithMatchedPhoto, V as MatchedListingPhoto } from './types-photo-search--3fBk3Cs.mjs';
2
+ export { W as BoundaryFeature, X as BoundaryFeatureCollection, Y as BoundaryGeometry, Z as BoundaryLayerUrlKind, _ as BoundarySourceLayer, $ as CmsEntryStatus, a0 as CmsFieldDefinition, a1 as CmsFieldType, a2 as CmsSeoData, a3 as FORBIDDEN_SEARCH_QUERY_KEYS, a4 as GaragemSdkError, a5 as GetCmsCollectionOptions, a6 as GetCmsCollectionsOptions, a7 as GetCmsEntriesOptions, a8 as GetCmsEntryOptions, a9 as GetListingOptions, aa as GetListingsOptions, ab as GetSearchUiOptions, ac as GetSimilarListingsOptions, ad as GetSiteOptions, ae as ListingBusinessType, af as ListingCardModel, ag as ListingPriceVisibility, ah as ListingPropertySummary, ai as LocationNameTables, aj as MAP_POLYGON_MAX_VERTICES, ak as MAP_SEARCH_DEFAULT_PAGE_SIZE, al as MAP_SEARCH_MAX_PAGE_SIZE, am as MAP_VIEWPORT_DEBOUNCE_MS, an as MapBounds, ao as MapBoundsSearchOptions, ap as MapBucket, aq as MapPin, ar as MapPinCluster, as as MapPolygon, at as MapPolygonSearchOptions, au as MapSearchResult, av as MapsBaseOptions, aw as QueryListingsLocation, ax as QueryListingsOptions, ay as SEARCH_EMPTY_COPY, az as SEARCH_SORT_RELEVANCE, aA as SearchChromeModel, aB as SearchListingsOptions, aC as SearchPathLocation, aD as SearchUiFilter, aE as SearchUiOption, aF as StaticMapStyle, aG as TOOLBAR_PRIMARY_FILTER_IDS, aH as applyPathFilter, aI as buildQueryListingsParams, aJ as canonicalizeSearchHref, aK as capMapPage, aL as capMapPageSize, aM as clearStagedPathFilters, aN as clusterBuckets, aO as clusterPins, aP as countFacetChoices, aQ as countOptionLabel, aR as displayPathLocation, aS as getCmsCollection, aT as getCmsCollections, aU as getCmsEntries, aV as getCmsEntry, aW as getListing, aX as getListings, aY as getSearchUi, aZ as getSimilarListings, a_ as getSite, a$ as hrefForAppliedChange, b0 as hrefForPathFilters, b1 as hrefWithExplicitPage, b2 as isListingDetailPath, b3 as isMapBounds, b4 as isMapPolygon, b5 as listingLocationLabel, b6 as mapClusterCellDegrees, b7 as mapSearchPins, b8 as paginationPages, b9 as pathFilterHasOption, ba as pathFilterValue, bb as publicSearchHref, bc as queryListings, bd as rangeDraftFromPath, be as readPublicSearch, bf as searchChromeModel, bg as searchHrefUsesLegacyFilterQuery, bh as searchListings, bi as searchListingsInBounds, bj as searchListingsInPolygon, bk as searchResultsHeading, bl as searchSortOptions, bm as toListingCardModel, bn as toolbarFilterIds, bo as unknownSearchLocation, bp as visibleSearchFilters } from './types-photo-search--3fBk3Cs.mjs';
3
3
 
4
4
  /**
5
5
  * Types for the public Share Link API (`GET`/`POST /api/sites/share/{token}`).
@@ -153,9 +153,9 @@ declare function trackListingView(listing: Pick<Listing, "id" | "listingCode" |
153
153
  /**
154
154
  * A visit is a location, a listing, or a static page. Filter paths and
155
155
  * `page` greater than 1 are the crawl space Studio's catch-all answers.
156
- * `analyticsDocumentGuardSource()` is the same check pasted into the
157
- * generated client, which cannot import this helper from the pinned tarball.
158
- * Prompts must not name `isAnalyticsDocumentUrl`.
156
+ * The pinned tarball exports `isAnalyticsDocumentUrl` (since 0.13.6), so
157
+ * Studio prompts may name it. `analyticsDocumentGuardSource()` is the same
158
+ * check pasted into the generated client, which does not import the helper.
159
159
  */
160
160
  /** `true` when this URL is a page a person opened, not a crawl of filters. */
161
161
  declare function isAnalyticsDocumentUrl(href: string): boolean;
@@ -682,9 +682,11 @@ declare const STUDIO_SDK_CONTRACT: {
682
682
  /**
683
683
  * Exact pin for generated Studio sites. Must match a tarball already on
684
684
  * npm — v0 installs this version. After a later changeset publishes, bump
685
- * this and move that release's names from `optionalReactExports` /
686
- * `unpublishedSearchExports` / `unpublishedPhoneExports` into the
687
- * prompt-safe lists. Do not bump here until that tarball is on npm.
685
+ * this and move names that tarball newly exports out of
686
+ * `optionalReactExports` / `unpublishedSearchExports` /
687
+ * `unpublishedPhoneExports` into the prompt-safe lists. Names that stay
688
+ * forbidden after they ship (`searchChromeModel`, `rangeDraftFromPath`)
689
+ * do not move. Do not bump here until that tarball is on npm.
688
690
  * Phone mask helpers shipped in 0.6.0. Map search
689
691
  * (`useMapSearch`, `searchListingsInBounds`) shipped in 0.9.0 — 0.7.0
690
692
  * does not export them. Property registration shipped in 0.10.0.
@@ -693,10 +695,12 @@ declare const STUDIO_SDK_CONTRACT: {
693
695
  * 0.12.0. Analytics catalog events (`trackListingView` plus the search
694
696
  * and lead emitters) shipped in 0.13.0. `property_search` sends a city
695
697
  * or neighborhood only when the site's location table knows it, as of
696
- * 0.13.2. Search filter helpers (`visibleSearchFilters` /
697
- * `toolbarFilterIds`) shipped in 0.4.12 and remain on this pin.
698
+ * 0.13.2. Development cards (`model.unitCount`, "A partir de" on a
699
+ * public price) shipped in 0.14.0. Search filter helpers
700
+ * (`visibleSearchFilters` / `toolbarFilterIds`) shipped in 0.4.12 and
701
+ * remain on this pin.
698
702
  */
699
- readonly minNpmVersion: "0.13.2";
703
+ readonly minNpmVersion: "0.14.0";
700
704
  /** Historical: older tarballs inject card CSS when those components mount. */
701
705
  readonly selfInjectSince: "0.4.2";
702
706
  readonly chromeStrategy: "app-owned";
@@ -755,17 +759,19 @@ declare const STUDIO_SDK_CONTRACT: {
755
759
  /**
756
760
  * Names already on the pinned npm tarball (`minNpmVersion`) — safe for
757
761
  * Studio prompts and completeness. Includes `visibleSearchFilters` +
758
- * `toolbarFilterIds` (shipped in 0.4.12). Do not confuse with
759
- * `unpublishedSearchExports` (`searchChromeModel`, …).
762
+ * `toolbarFilterIds` (shipped in 0.4.12) and `unknownSearchLocation`
763
+ * (shipped in 0.13.4). Do not confuse with `unpublishedSearchExports`
764
+ * (`searchChromeModel`, …).
760
765
  */
761
- readonly searchExports: readonly ["searchResultsHeading", "searchSortOptions", "visibleSearchFilters", "toolbarFilterIds", "paginationPages", "hrefWithExplicitPage", "countOptionLabel", "countFacetChoices"];
766
+ readonly searchExports: readonly ["searchResultsHeading", "searchSortOptions", "visibleSearchFilters", "toolbarFilterIds", "paginationPages", "hrefWithExplicitPage", "countOptionLabel", "countFacetChoices", "unknownSearchLocation"];
762
767
  /**
763
- * Main-package helpers in git / newer tarballs but not required on
764
- * `minNpmVersion`. Prompts must not mention these until the pin bumps and
765
- * they move into `searchExports`. Independent of the 0.4.12 filter helpers
766
- * already listed in `searchExports`.
768
+ * Exported by the pinned tarball, and still forbidden in prompts.
769
+ * `searchChromeModel` is retired bundled chrome — the prompt names
770
+ * `visibleSearchFilters` and `toolbarFilterIds` instead. `rangeDraftFromPath`
771
+ * stays unnamed; price and area drafts stay local state. Helpers the pin
772
+ * allows (`unknownSearchLocation`, `isAnalyticsDocumentUrl`) are not here.
767
773
  */
768
- readonly unpublishedSearchExports: readonly ["searchChromeModel", "rangeDraftFromPath", "unknownSearchLocation", "isAnalyticsDocumentUrl"];
774
+ readonly unpublishedSearchExports: readonly ["searchChromeModel", "rangeDraftFromPath"];
769
775
  /**
770
776
  * maps.fndn.ai helpers (static map, street view, boundaries, travel
771
777
  * time) plus friendly map search. They ship in npm 0.9.0 (`mapsSince`).
@@ -826,11 +832,21 @@ declare const STUDIO_SDK_CONTRACT: {
826
832
  /**
827
833
  * Listing-view analytics. Search and lead catalog events need no prompt:
828
834
  * `usePublicSearch` and the lead helpers emit them from `analyticsSince`.
829
- * Below it `studioListingViewInstruction` prints nothing and
830
- * `studioCodegenContractViolations` flags `trackListingView`.
835
+ * `isAnalyticsDocumentUrl` shipped in 0.13.6 and is prompt-safe on this
836
+ * pin (it is not a search import). Below `analyticsSince`,
837
+ * `studioListingViewInstruction` prints nothing and
838
+ * `studioCodegenContractViolations` flags these names.
831
839
  */
832
- readonly analyticsExports: readonly ["trackListingView"];
840
+ readonly analyticsExports: readonly ["trackListingView", "isAnalyticsDocumentUrl"];
833
841
  readonly analyticsSince: "0.13.0";
842
+ /**
843
+ * Development cards (`model.unitCount`, "A partir de" on `priceLabel`).
844
+ * The search API can return `listing.development` before this pin.
845
+ * Prompts must not name `unitCount` until `minNpmVersion` reaches
846
+ * `developmentCardSince` — v0 copies the field and an older
847
+ * `toListingCardModel` does not set it.
848
+ */
849
+ readonly developmentCardSince: "0.14.0";
834
850
  };
835
851
  type StudioSdkContract = typeof STUDIO_SDK_CONTRACT;
836
852
  /** Whether the pinned tarball carries the seller-lead surface. */
@@ -888,7 +904,13 @@ declare function unavailableReactImports(source: string, pin: string): string[];
888
904
  declare function studioPublishableKeyInstruction(): string;
889
905
  declare function studioSdkPinInstruction(): string;
890
906
  declare function studioLeadInstruction(): string;
891
- declare function studioListingCardInstruction(): string;
907
+ declare function developmentCardPublished(pin?: string): boolean;
908
+ /**
909
+ * How a generated card renders a collapsed development. Empty until the
910
+ * pin ships `toListingCardModel`'s `unitCount`.
911
+ */
912
+ declare function studioDevelopmentCardInstruction(pin?: string): string;
913
+ declare function studioListingCardInstruction(pin?: string): string;
892
914
  declare function studioListingDetailInstruction(): string;
893
915
  /**
894
916
  * Listing-detail photo intelligence, gated on the published pin. The base
@@ -1559,4 +1581,4 @@ declare function resolveMatchedCoverPhoto(photo: MatchedListingPhoto | null | un
1559
1581
  */
1560
1582
  declare function applyMatchedPhotoCover<T extends Listing>(cards: ReadonlyArray<T>, photoResults: PhotoSearchResult | ReadonlyArray<PhotoSearchItem> | null | undefined, options?: ApplyMatchedPhotoCoverOptions): Array<T & ListingWithMatchedPhoto>;
1561
1583
 
1562
- export { AMENITY_FALLBACK_LABELS, type AmenityLabelDictionary, type AmenityLabelOption, AppliedSearchChange, AppliedSearchQuery, type ApplyMatchedPhotoCoverOptions, BoundaryCity, BoundaryLayer, BoundaryLayerOptions, CmsCollection, CmsEntriesResult, CmsEntry, type ContactLeadInput, type CreateGaragemClientOptions, DEFAULT_MAPS_BASE_URL, DEFAULT_PHONE_COUNTRY_CODE, FetchLike, type GaragemClient, type GetLeadUiOptions, type GetListingMarketPositionOptions, type GetNeighborhoodSummaryOptions, type GetShareLinkOptions, type GetSimilarByPhotoOptions, type HHmm, LISTING_AMENITY_TITLES, LISTING_DESCRIPTION_CLAMP, type LeadContact, type LeadField, type LeadFieldId, LeadSubmitError, type LeadSubmitErrorCode, type LeadSubmitResult, type LeadUi, Listing, type ListingAmenityGroup, type ListingAmenityGroupKey, type ListingAmenitySource, type ListingBreadcrumbCrumb, type ListingDescriptionPreview, ListingDetail, type ListingDetailFieldsModel, type ListingDetailFieldsSource, type ListingDetailModel, type ListingFact, ListingFilters, ListingLocation, type ListingLocationBlock, type ListingMarketPosition, ListingMedia, type ListingMediaOverlay, type ListingPhotoGroup, type ListingValue, type ListingVisualHighlightsOptions, ListingWithLocation, ListingWithMatchedPhoto, ListingsResult, type LocationFilterInput, MAPS_MAX_IMAGE_EDGE, MAPS_SITE_HEADER, MATCHED_PHOTO_COVER_MAX_DISTANCE, MAX_NATIONAL_PHONE_DIGITS, MapsCoordinates, MapsFetchOptions, type MarketListingType, type MarketPriceBand, type MarketPropertyType, type MarketUnavailableReason, MatchedListingPhoto, NeighborhoodBoundary, NeighborhoodBoundaryOptions, type NeighborhoodSummary, type NeighborhoodSummaryQuery, PHONE_COUNTRIES, PHOTO_GROUP_OTHER_KEY, PHOTO_GROUP_OTHER_LABEL, PHOTO_SEARCH_MIN_QUERY_LENGTH, type ParsedPhoneInput, type PhoneCountry, PhotoSearchItem, PhotoSearchParams, PhotoSearchResult, type PriceEstimate, type PriceEstimateConfidence, type PriceEstimateInput, QueryListingsFilters, QueryListingsParams, QueryListingsResult, RequestNextOptions, type RequestPriceEstimateOptions, type ResolvePublicSiteIdOptions, SELLER_LEAD_PHOTO_MAX_BYTES, SELLER_LEAD_PHOTO_MAX_COUNT, SELLER_LEAD_PHOTO_TYPES, SITE_ANALYTICS_EVENT, STUDIO_DEFAULT_PHOTO_SCHEDULE_CONFIG, STUDIO_DEFAULT_VISIT_SCHEDULE, STUDIO_SDK_CONTRACT, STUDIO_SDK_PACKAGE, STUDIO_SITE_LAYOUT, type SearchListingPhotosOptions, SearchListingsParams, SearchListingsResult, SearchPathFilters, SearchUi, SearchUiDictionary, type SellerAddressErrors, type SellerAddressField, type SellerBusinessType, type SellerLeadAddress, type SellerLeadInput, type SellerLeadProperty, type SellerPhotoScheduleConfig, type ShareEntityType, type ShareLinkError, type ShareLinkErrorReason, type ShareLinkResult, type ShareLinkSuccess, type ShareLinkToken, type ShareListingEntity, type SimilarByPhotoItem, type SimilarByPhotoResult, SimilarListingsResult, type SimilarPhotoMatch, Site, StaticMapOptions, StreetViewAvailability, StreetViewAvailabilityOptions, StreetViewOptions, type StudioSdkContract, TravelDestination, TravelMode, TravelTime, TravelTimeCache, TravelTimeCacheOptions, TravelTimeElement, TravelTimeOptions, TravelTimesOptions, type UploadSellerLeadPhotoInput, VISIT_TIME_ZONE, type VisitHours, type VisitLeadInput, type VisitSchedule, type VisitScheduleConfig, analyticsDocumentGuardSource, applyMatchedPhotoCover, boundaryCitySlug, boundaryLayerId, boundaryLayerUrl, clearTravelTimeCache, coarsenCoordinates, coerceNpmVersion, collapseDuplicatedBrazilianMobileNine, compareSemver, composeSearchPublicHref, composeSearchPublicPath, coordinateDecimals, createClient, createGaragemClient, createTravelTimeCache, defaultPhoneCountry, expandVisitSchedule, expandVisitTimeSlots, findPhoneCountry, formatAreaM2, formatGroupedInteger, formatListingPrice, formatPhoneNational, getBoundaryLayer, getLeadUi, getListingMarketPosition, getNeighborhoodSummary, getShareLink, getSimilarByPhoto, hasShowcaseLeadsPostUrl, isAnalyticsDocumentUrl, isAnalyticsOnPin, isPhotoSearchOnPin, isSellerLeadOnPin, isShareLinkOnPin, isStudioPreviewHost, isValidEmail, isValidName, isValidPhone, isVisitSlotAllowed, labelAmenities, listingAmenityGroups, listingBreadcrumb, listingBusinessLabel, listingCoordinates, listingDescriptionPreview, listingDetailFieldsModel, listingDetailModel, listingFacts, listingLocationBlock, listingLookupKey, listingMapsHref, listingMediaOverlays, listingPhotoGroups, listingPublicPath, listingStaticMapUrl, listingStreetViewAvailable, listingStreetViewMetadataUrl, listingStreetViewUrl, listingValues, listingVisualHighlights, mapsExportsPublished, marketExportsAvailableAt, marketPositionLabel, maxZoomForCoordinates, mergeAppliedSearchQueryIntoSearch, nationalPhoneDigits, neighborhoodBoundaryLayer, neighborhoodBoundaryUrl, normalizeMapsBaseUrl, normalizeVisitDate, normalizeVisitTime, parseAppliedSearchQuery, parseGroupedInteger, parsePhoneInput, parseReactSdkNamedImports, parseSearchPublicPath, pathFiltersToQueryFilters, pathLocationToFilterInput, phoneCountrySearchValue, photoRoomLabel, photoSearchUrl, priceBandLabel, reduceAppliedSearchQuery, remaskPhoneForCountry, requestPriceEstimate, resolveMatchedCoverPhoto, resolvePublicSiteId, resolveTravelDestination, searchListingPhotos, sellerAddressErrors, sellerPhotoSchedule, serializeAppliedSearchQuery, slotsForDate, studioAmenityInstruction, studioChromeInstruction, studioCodegenContractViolations, studioDefaultLeadUi, studioLayoutInstruction, studioLeadInstruction, studioListingCardInstruction, studioListingDetailInstruction, studioListingViewInstruction, studioMapSearchInstruction, studioMapsInstruction, studioMarketInstruction, studioPhotoInstruction, studioPhotoInstructionFor, studioPhotoSearchInstruction, studioPublishableKeyInstruction, studioSdkPinInstruction, studioSearchInstruction, studioSearchLandmarkInstruction, studioSellerLeadSdkInstruction, studioShareLinkInstruction, studioSiteWidthCss, submitContactLead, submitSellerLead, submitVisitLead, toE164, trackListingView, travelTimeCacheKey, travelTimeFromListing, travelTimesFromListing, truncateNationalPhoneDigits, unavailableReactImports, uploadSellerLeadPhoto };
1584
+ export { AMENITY_FALLBACK_LABELS, type AmenityLabelDictionary, type AmenityLabelOption, AppliedSearchChange, AppliedSearchQuery, type ApplyMatchedPhotoCoverOptions, BoundaryCity, BoundaryLayer, BoundaryLayerOptions, CmsCollection, CmsEntriesResult, CmsEntry, type ContactLeadInput, type CreateGaragemClientOptions, DEFAULT_MAPS_BASE_URL, DEFAULT_PHONE_COUNTRY_CODE, FetchLike, type GaragemClient, type GetLeadUiOptions, type GetListingMarketPositionOptions, type GetNeighborhoodSummaryOptions, type GetShareLinkOptions, type GetSimilarByPhotoOptions, type HHmm, LISTING_AMENITY_TITLES, LISTING_DESCRIPTION_CLAMP, type LeadContact, type LeadField, type LeadFieldId, LeadSubmitError, type LeadSubmitErrorCode, type LeadSubmitResult, type LeadUi, Listing, type ListingAmenityGroup, type ListingAmenityGroupKey, type ListingAmenitySource, type ListingBreadcrumbCrumb, type ListingDescriptionPreview, ListingDetail, type ListingDetailFieldsModel, type ListingDetailFieldsSource, type ListingDetailModel, type ListingFact, ListingFilters, ListingLocation, type ListingLocationBlock, type ListingMarketPosition, ListingMedia, type ListingMediaOverlay, type ListingPhotoGroup, type ListingValue, type ListingVisualHighlightsOptions, ListingWithLocation, ListingWithMatchedPhoto, ListingsResult, type LocationFilterInput, MAPS_MAX_IMAGE_EDGE, MAPS_SITE_HEADER, MATCHED_PHOTO_COVER_MAX_DISTANCE, MAX_NATIONAL_PHONE_DIGITS, MapsCoordinates, MapsFetchOptions, type MarketListingType, type MarketPriceBand, type MarketPropertyType, type MarketUnavailableReason, MatchedListingPhoto, NeighborhoodBoundary, NeighborhoodBoundaryOptions, type NeighborhoodSummary, type NeighborhoodSummaryQuery, PHONE_COUNTRIES, PHOTO_GROUP_OTHER_KEY, PHOTO_GROUP_OTHER_LABEL, PHOTO_SEARCH_MIN_QUERY_LENGTH, type ParsedPhoneInput, type PhoneCountry, PhotoSearchItem, PhotoSearchParams, PhotoSearchResult, type PriceEstimate, type PriceEstimateConfidence, type PriceEstimateInput, QueryListingsFilters, QueryListingsParams, QueryListingsResult, RequestNextOptions, type RequestPriceEstimateOptions, type ResolvePublicSiteIdOptions, SELLER_LEAD_PHOTO_MAX_BYTES, SELLER_LEAD_PHOTO_MAX_COUNT, SELLER_LEAD_PHOTO_TYPES, SITE_ANALYTICS_EVENT, STUDIO_DEFAULT_PHOTO_SCHEDULE_CONFIG, STUDIO_DEFAULT_VISIT_SCHEDULE, STUDIO_SDK_CONTRACT, STUDIO_SDK_PACKAGE, STUDIO_SITE_LAYOUT, type SearchListingPhotosOptions, SearchListingsParams, SearchListingsResult, SearchPathFilters, SearchUi, SearchUiDictionary, type SellerAddressErrors, type SellerAddressField, type SellerBusinessType, type SellerLeadAddress, type SellerLeadInput, type SellerLeadProperty, type SellerPhotoScheduleConfig, type ShareEntityType, type ShareLinkError, type ShareLinkErrorReason, type ShareLinkResult, type ShareLinkSuccess, type ShareLinkToken, type ShareListingEntity, type SimilarByPhotoItem, type SimilarByPhotoResult, SimilarListingsResult, type SimilarPhotoMatch, Site, StaticMapOptions, StreetViewAvailability, StreetViewAvailabilityOptions, StreetViewOptions, type StudioSdkContract, TravelDestination, TravelMode, TravelTime, TravelTimeCache, TravelTimeCacheOptions, TravelTimeElement, TravelTimeOptions, TravelTimesOptions, type UploadSellerLeadPhotoInput, VISIT_TIME_ZONE, type VisitHours, type VisitLeadInput, type VisitSchedule, type VisitScheduleConfig, analyticsDocumentGuardSource, applyMatchedPhotoCover, boundaryCitySlug, boundaryLayerId, boundaryLayerUrl, clearTravelTimeCache, coarsenCoordinates, coerceNpmVersion, collapseDuplicatedBrazilianMobileNine, compareSemver, composeSearchPublicHref, composeSearchPublicPath, coordinateDecimals, createClient, createGaragemClient, createTravelTimeCache, defaultPhoneCountry, developmentCardPublished, expandVisitSchedule, expandVisitTimeSlots, findPhoneCountry, formatAreaM2, formatGroupedInteger, formatListingPrice, formatPhoneNational, getBoundaryLayer, getLeadUi, getListingMarketPosition, getNeighborhoodSummary, getShareLink, getSimilarByPhoto, hasShowcaseLeadsPostUrl, isAnalyticsDocumentUrl, isAnalyticsOnPin, isPhotoSearchOnPin, isSellerLeadOnPin, isShareLinkOnPin, isStudioPreviewHost, isValidEmail, isValidName, isValidPhone, isVisitSlotAllowed, labelAmenities, listingAmenityGroups, listingBreadcrumb, listingBusinessLabel, listingCoordinates, listingDescriptionPreview, listingDetailFieldsModel, listingDetailModel, listingFacts, listingLocationBlock, listingLookupKey, listingMapsHref, listingMediaOverlays, listingPhotoGroups, listingPublicPath, listingStaticMapUrl, listingStreetViewAvailable, listingStreetViewMetadataUrl, listingStreetViewUrl, listingValues, listingVisualHighlights, mapsExportsPublished, marketExportsAvailableAt, marketPositionLabel, maxZoomForCoordinates, mergeAppliedSearchQueryIntoSearch, nationalPhoneDigits, neighborhoodBoundaryLayer, neighborhoodBoundaryUrl, normalizeMapsBaseUrl, normalizeVisitDate, normalizeVisitTime, parseAppliedSearchQuery, parseGroupedInteger, parsePhoneInput, parseReactSdkNamedImports, parseSearchPublicPath, pathFiltersToQueryFilters, pathLocationToFilterInput, phoneCountrySearchValue, photoRoomLabel, photoSearchUrl, priceBandLabel, reduceAppliedSearchQuery, remaskPhoneForCountry, requestPriceEstimate, resolveMatchedCoverPhoto, resolvePublicSiteId, resolveTravelDestination, searchListingPhotos, sellerAddressErrors, sellerPhotoSchedule, serializeAppliedSearchQuery, slotsForDate, studioAmenityInstruction, studioChromeInstruction, studioCodegenContractViolations, studioDefaultLeadUi, studioDevelopmentCardInstruction, studioLayoutInstruction, studioLeadInstruction, studioListingCardInstruction, studioListingDetailInstruction, studioListingViewInstruction, studioMapSearchInstruction, studioMapsInstruction, studioMarketInstruction, studioPhotoInstruction, studioPhotoInstructionFor, studioPhotoSearchInstruction, studioPublishableKeyInstruction, studioSdkPinInstruction, studioSearchInstruction, studioSearchLandmarkInstruction, studioSellerLeadSdkInstruction, studioShareLinkInstruction, studioSiteWidthCss, submitContactLead, submitSellerLead, submitVisitLead, toE164, trackListingView, travelTimeCacheKey, travelTimeFromListing, travelTimesFromListing, truncateNationalPhoneDigits, unavailableReactImports, uploadSellerLeadPhoto };
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { L as ListingDetail, F as FetchLike, R as RequestNextOptions, a as Listing, b as ListingLocation, c as ListingMedia, S as SearchPathFilters, d as SearchUiDictionary, Q as QueryListingsFilters, A as AppliedSearchQuery, e as AppliedSearchChange, f as ListingFilters, g as ListingsResult, h as Site, i as SearchListingsParams, j as SearchListingsResult, k as SearchUi, l as QueryListingsParams, m as QueryListingsResult, n as SimilarListingsResult, C as CmsCollection, o as CmsEntriesResult, p as CmsEntry, B as BoundaryCity, q as BoundaryLayerOptions, M as MapsCoordinates, T as TravelTimeCacheOptions, r as TravelTimeCache, s as MapsFetchOptions, t as BoundaryLayer, u as ListingWithLocation, v as StaticMapOptions, w as StreetViewAvailabilityOptions, x as StreetViewAvailability, y as StreetViewOptions, N as NeighborhoodBoundaryOptions, z as NeighborhoodBoundary, D as TravelDestination, E as TravelMode, G as TravelTimeOptions, H as TravelTime, I as TravelTimesOptions, J as TravelTimeElement, P as PhotoSearchParams, K as PhotoSearchResult, O as PhotoSearchItem, U as ListingWithMatchedPhoto, V as MatchedListingPhoto } from './types-photo-search-CVPyF9zC.js';
2
- export { W as BoundaryFeature, X as BoundaryFeatureCollection, Y as BoundaryGeometry, Z as BoundaryLayerUrlKind, _ as BoundarySourceLayer, $ as CmsEntryStatus, a0 as CmsFieldDefinition, a1 as CmsFieldType, a2 as CmsSeoData, a3 as FORBIDDEN_SEARCH_QUERY_KEYS, a4 as GaragemSdkError, a5 as GetCmsCollectionOptions, a6 as GetCmsCollectionsOptions, a7 as GetCmsEntriesOptions, a8 as GetCmsEntryOptions, a9 as GetListingOptions, aa as GetListingsOptions, ab as GetSearchUiOptions, ac as GetSimilarListingsOptions, ad as GetSiteOptions, ae as ListingBusinessType, af as ListingCardModel, ag as ListingPriceVisibility, ah as ListingPropertySummary, ai as LocationNameTables, aj as MAP_POLYGON_MAX_VERTICES, ak as MAP_SEARCH_DEFAULT_PAGE_SIZE, al as MAP_SEARCH_MAX_PAGE_SIZE, am as MAP_VIEWPORT_DEBOUNCE_MS, an as MapBounds, ao as MapBoundsSearchOptions, ap as MapBucket, aq as MapPin, ar as MapPinCluster, as as MapPolygon, at as MapPolygonSearchOptions, au as MapSearchResult, av as MapsBaseOptions, aw as QueryListingsLocation, ax as QueryListingsOptions, ay as SEARCH_EMPTY_COPY, az as SEARCH_SORT_RELEVANCE, aA as SearchChromeModel, aB as SearchListingsOptions, aC as SearchPathLocation, aD as SearchUiFilter, aE as SearchUiOption, aF as StaticMapStyle, aG as TOOLBAR_PRIMARY_FILTER_IDS, aH as applyPathFilter, aI as buildQueryListingsParams, aJ as canonicalizeSearchHref, aK as capMapPage, aL as capMapPageSize, aM as clearStagedPathFilters, aN as clusterBuckets, aO as clusterPins, aP as countFacetChoices, aQ as countOptionLabel, aR as displayPathLocation, aS as getCmsCollection, aT as getCmsCollections, aU as getCmsEntries, aV as getCmsEntry, aW as getListing, aX as getListings, aY as getSearchUi, aZ as getSimilarListings, a_ as getSite, a$ as hrefForAppliedChange, b0 as hrefForPathFilters, b1 as hrefWithExplicitPage, b2 as isListingDetailPath, b3 as isMapBounds, b4 as isMapPolygon, b5 as listingLocationLabel, b6 as mapClusterCellDegrees, b7 as mapSearchPins, b8 as paginationPages, b9 as pathFilterHasOption, ba as pathFilterValue, bb as publicSearchHref, bc as queryListings, bd as rangeDraftFromPath, be as readPublicSearch, bf as searchChromeModel, bg as searchHrefUsesLegacyFilterQuery, bh as searchListings, bi as searchListingsInBounds, bj as searchListingsInPolygon, bk as searchResultsHeading, bl as searchSortOptions, bm as toListingCardModel, bn as toolbarFilterIds, bo as unknownSearchLocation, bp as visibleSearchFilters } from './types-photo-search-CVPyF9zC.js';
1
+ import { L as ListingDetail, F as FetchLike, R as RequestNextOptions, a as Listing, b as ListingLocation, c as ListingMedia, S as SearchPathFilters, d as SearchUiDictionary, Q as QueryListingsFilters, A as AppliedSearchQuery, e as AppliedSearchChange, f as ListingFilters, g as ListingsResult, h as Site, i as SearchListingsParams, j as SearchListingsResult, k as SearchUi, l as QueryListingsParams, m as QueryListingsResult, n as SimilarListingsResult, C as CmsCollection, o as CmsEntriesResult, p as CmsEntry, B as BoundaryCity, q as BoundaryLayerOptions, M as MapsCoordinates, T as TravelTimeCacheOptions, r as TravelTimeCache, s as MapsFetchOptions, t as BoundaryLayer, u as ListingWithLocation, v as StaticMapOptions, w as StreetViewAvailabilityOptions, x as StreetViewAvailability, y as StreetViewOptions, N as NeighborhoodBoundaryOptions, z as NeighborhoodBoundary, D as TravelDestination, E as TravelMode, G as TravelTimeOptions, H as TravelTime, I as TravelTimesOptions, J as TravelTimeElement, P as PhotoSearchParams, K as PhotoSearchResult, O as PhotoSearchItem, U as ListingWithMatchedPhoto, V as MatchedListingPhoto } from './types-photo-search--3fBk3Cs.js';
2
+ export { W as BoundaryFeature, X as BoundaryFeatureCollection, Y as BoundaryGeometry, Z as BoundaryLayerUrlKind, _ as BoundarySourceLayer, $ as CmsEntryStatus, a0 as CmsFieldDefinition, a1 as CmsFieldType, a2 as CmsSeoData, a3 as FORBIDDEN_SEARCH_QUERY_KEYS, a4 as GaragemSdkError, a5 as GetCmsCollectionOptions, a6 as GetCmsCollectionsOptions, a7 as GetCmsEntriesOptions, a8 as GetCmsEntryOptions, a9 as GetListingOptions, aa as GetListingsOptions, ab as GetSearchUiOptions, ac as GetSimilarListingsOptions, ad as GetSiteOptions, ae as ListingBusinessType, af as ListingCardModel, ag as ListingPriceVisibility, ah as ListingPropertySummary, ai as LocationNameTables, aj as MAP_POLYGON_MAX_VERTICES, ak as MAP_SEARCH_DEFAULT_PAGE_SIZE, al as MAP_SEARCH_MAX_PAGE_SIZE, am as MAP_VIEWPORT_DEBOUNCE_MS, an as MapBounds, ao as MapBoundsSearchOptions, ap as MapBucket, aq as MapPin, ar as MapPinCluster, as as MapPolygon, at as MapPolygonSearchOptions, au as MapSearchResult, av as MapsBaseOptions, aw as QueryListingsLocation, ax as QueryListingsOptions, ay as SEARCH_EMPTY_COPY, az as SEARCH_SORT_RELEVANCE, aA as SearchChromeModel, aB as SearchListingsOptions, aC as SearchPathLocation, aD as SearchUiFilter, aE as SearchUiOption, aF as StaticMapStyle, aG as TOOLBAR_PRIMARY_FILTER_IDS, aH as applyPathFilter, aI as buildQueryListingsParams, aJ as canonicalizeSearchHref, aK as capMapPage, aL as capMapPageSize, aM as clearStagedPathFilters, aN as clusterBuckets, aO as clusterPins, aP as countFacetChoices, aQ as countOptionLabel, aR as displayPathLocation, aS as getCmsCollection, aT as getCmsCollections, aU as getCmsEntries, aV as getCmsEntry, aW as getListing, aX as getListings, aY as getSearchUi, aZ as getSimilarListings, a_ as getSite, a$ as hrefForAppliedChange, b0 as hrefForPathFilters, b1 as hrefWithExplicitPage, b2 as isListingDetailPath, b3 as isMapBounds, b4 as isMapPolygon, b5 as listingLocationLabel, b6 as mapClusterCellDegrees, b7 as mapSearchPins, b8 as paginationPages, b9 as pathFilterHasOption, ba as pathFilterValue, bb as publicSearchHref, bc as queryListings, bd as rangeDraftFromPath, be as readPublicSearch, bf as searchChromeModel, bg as searchHrefUsesLegacyFilterQuery, bh as searchListings, bi as searchListingsInBounds, bj as searchListingsInPolygon, bk as searchResultsHeading, bl as searchSortOptions, bm as toListingCardModel, bn as toolbarFilterIds, bo as unknownSearchLocation, bp as visibleSearchFilters } from './types-photo-search--3fBk3Cs.js';
3
3
 
4
4
  /**
5
5
  * Types for the public Share Link API (`GET`/`POST /api/sites/share/{token}`).
@@ -153,9 +153,9 @@ declare function trackListingView(listing: Pick<Listing, "id" | "listingCode" |
153
153
  /**
154
154
  * A visit is a location, a listing, or a static page. Filter paths and
155
155
  * `page` greater than 1 are the crawl space Studio's catch-all answers.
156
- * `analyticsDocumentGuardSource()` is the same check pasted into the
157
- * generated client, which cannot import this helper from the pinned tarball.
158
- * Prompts must not name `isAnalyticsDocumentUrl`.
156
+ * The pinned tarball exports `isAnalyticsDocumentUrl` (since 0.13.6), so
157
+ * Studio prompts may name it. `analyticsDocumentGuardSource()` is the same
158
+ * check pasted into the generated client, which does not import the helper.
159
159
  */
160
160
  /** `true` when this URL is a page a person opened, not a crawl of filters. */
161
161
  declare function isAnalyticsDocumentUrl(href: string): boolean;
@@ -682,9 +682,11 @@ declare const STUDIO_SDK_CONTRACT: {
682
682
  /**
683
683
  * Exact pin for generated Studio sites. Must match a tarball already on
684
684
  * npm — v0 installs this version. After a later changeset publishes, bump
685
- * this and move that release's names from `optionalReactExports` /
686
- * `unpublishedSearchExports` / `unpublishedPhoneExports` into the
687
- * prompt-safe lists. Do not bump here until that tarball is on npm.
685
+ * this and move names that tarball newly exports out of
686
+ * `optionalReactExports` / `unpublishedSearchExports` /
687
+ * `unpublishedPhoneExports` into the prompt-safe lists. Names that stay
688
+ * forbidden after they ship (`searchChromeModel`, `rangeDraftFromPath`)
689
+ * do not move. Do not bump here until that tarball is on npm.
688
690
  * Phone mask helpers shipped in 0.6.0. Map search
689
691
  * (`useMapSearch`, `searchListingsInBounds`) shipped in 0.9.0 — 0.7.0
690
692
  * does not export them. Property registration shipped in 0.10.0.
@@ -693,10 +695,12 @@ declare const STUDIO_SDK_CONTRACT: {
693
695
  * 0.12.0. Analytics catalog events (`trackListingView` plus the search
694
696
  * and lead emitters) shipped in 0.13.0. `property_search` sends a city
695
697
  * or neighborhood only when the site's location table knows it, as of
696
- * 0.13.2. Search filter helpers (`visibleSearchFilters` /
697
- * `toolbarFilterIds`) shipped in 0.4.12 and remain on this pin.
698
+ * 0.13.2. Development cards (`model.unitCount`, "A partir de" on a
699
+ * public price) shipped in 0.14.0. Search filter helpers
700
+ * (`visibleSearchFilters` / `toolbarFilterIds`) shipped in 0.4.12 and
701
+ * remain on this pin.
698
702
  */
699
- readonly minNpmVersion: "0.13.2";
703
+ readonly minNpmVersion: "0.14.0";
700
704
  /** Historical: older tarballs inject card CSS when those components mount. */
701
705
  readonly selfInjectSince: "0.4.2";
702
706
  readonly chromeStrategy: "app-owned";
@@ -755,17 +759,19 @@ declare const STUDIO_SDK_CONTRACT: {
755
759
  /**
756
760
  * Names already on the pinned npm tarball (`minNpmVersion`) — safe for
757
761
  * Studio prompts and completeness. Includes `visibleSearchFilters` +
758
- * `toolbarFilterIds` (shipped in 0.4.12). Do not confuse with
759
- * `unpublishedSearchExports` (`searchChromeModel`, …).
762
+ * `toolbarFilterIds` (shipped in 0.4.12) and `unknownSearchLocation`
763
+ * (shipped in 0.13.4). Do not confuse with `unpublishedSearchExports`
764
+ * (`searchChromeModel`, …).
760
765
  */
761
- readonly searchExports: readonly ["searchResultsHeading", "searchSortOptions", "visibleSearchFilters", "toolbarFilterIds", "paginationPages", "hrefWithExplicitPage", "countOptionLabel", "countFacetChoices"];
766
+ readonly searchExports: readonly ["searchResultsHeading", "searchSortOptions", "visibleSearchFilters", "toolbarFilterIds", "paginationPages", "hrefWithExplicitPage", "countOptionLabel", "countFacetChoices", "unknownSearchLocation"];
762
767
  /**
763
- * Main-package helpers in git / newer tarballs but not required on
764
- * `minNpmVersion`. Prompts must not mention these until the pin bumps and
765
- * they move into `searchExports`. Independent of the 0.4.12 filter helpers
766
- * already listed in `searchExports`.
768
+ * Exported by the pinned tarball, and still forbidden in prompts.
769
+ * `searchChromeModel` is retired bundled chrome — the prompt names
770
+ * `visibleSearchFilters` and `toolbarFilterIds` instead. `rangeDraftFromPath`
771
+ * stays unnamed; price and area drafts stay local state. Helpers the pin
772
+ * allows (`unknownSearchLocation`, `isAnalyticsDocumentUrl`) are not here.
767
773
  */
768
- readonly unpublishedSearchExports: readonly ["searchChromeModel", "rangeDraftFromPath", "unknownSearchLocation", "isAnalyticsDocumentUrl"];
774
+ readonly unpublishedSearchExports: readonly ["searchChromeModel", "rangeDraftFromPath"];
769
775
  /**
770
776
  * maps.fndn.ai helpers (static map, street view, boundaries, travel
771
777
  * time) plus friendly map search. They ship in npm 0.9.0 (`mapsSince`).
@@ -826,11 +832,21 @@ declare const STUDIO_SDK_CONTRACT: {
826
832
  /**
827
833
  * Listing-view analytics. Search and lead catalog events need no prompt:
828
834
  * `usePublicSearch` and the lead helpers emit them from `analyticsSince`.
829
- * Below it `studioListingViewInstruction` prints nothing and
830
- * `studioCodegenContractViolations` flags `trackListingView`.
835
+ * `isAnalyticsDocumentUrl` shipped in 0.13.6 and is prompt-safe on this
836
+ * pin (it is not a search import). Below `analyticsSince`,
837
+ * `studioListingViewInstruction` prints nothing and
838
+ * `studioCodegenContractViolations` flags these names.
831
839
  */
832
- readonly analyticsExports: readonly ["trackListingView"];
840
+ readonly analyticsExports: readonly ["trackListingView", "isAnalyticsDocumentUrl"];
833
841
  readonly analyticsSince: "0.13.0";
842
+ /**
843
+ * Development cards (`model.unitCount`, "A partir de" on `priceLabel`).
844
+ * The search API can return `listing.development` before this pin.
845
+ * Prompts must not name `unitCount` until `minNpmVersion` reaches
846
+ * `developmentCardSince` — v0 copies the field and an older
847
+ * `toListingCardModel` does not set it.
848
+ */
849
+ readonly developmentCardSince: "0.14.0";
834
850
  };
835
851
  type StudioSdkContract = typeof STUDIO_SDK_CONTRACT;
836
852
  /** Whether the pinned tarball carries the seller-lead surface. */
@@ -888,7 +904,13 @@ declare function unavailableReactImports(source: string, pin: string): string[];
888
904
  declare function studioPublishableKeyInstruction(): string;
889
905
  declare function studioSdkPinInstruction(): string;
890
906
  declare function studioLeadInstruction(): string;
891
- declare function studioListingCardInstruction(): string;
907
+ declare function developmentCardPublished(pin?: string): boolean;
908
+ /**
909
+ * How a generated card renders a collapsed development. Empty until the
910
+ * pin ships `toListingCardModel`'s `unitCount`.
911
+ */
912
+ declare function studioDevelopmentCardInstruction(pin?: string): string;
913
+ declare function studioListingCardInstruction(pin?: string): string;
892
914
  declare function studioListingDetailInstruction(): string;
893
915
  /**
894
916
  * Listing-detail photo intelligence, gated on the published pin. The base
@@ -1559,4 +1581,4 @@ declare function resolveMatchedCoverPhoto(photo: MatchedListingPhoto | null | un
1559
1581
  */
1560
1582
  declare function applyMatchedPhotoCover<T extends Listing>(cards: ReadonlyArray<T>, photoResults: PhotoSearchResult | ReadonlyArray<PhotoSearchItem> | null | undefined, options?: ApplyMatchedPhotoCoverOptions): Array<T & ListingWithMatchedPhoto>;
1561
1583
 
1562
- export { AMENITY_FALLBACK_LABELS, type AmenityLabelDictionary, type AmenityLabelOption, AppliedSearchChange, AppliedSearchQuery, type ApplyMatchedPhotoCoverOptions, BoundaryCity, BoundaryLayer, BoundaryLayerOptions, CmsCollection, CmsEntriesResult, CmsEntry, type ContactLeadInput, type CreateGaragemClientOptions, DEFAULT_MAPS_BASE_URL, DEFAULT_PHONE_COUNTRY_CODE, FetchLike, type GaragemClient, type GetLeadUiOptions, type GetListingMarketPositionOptions, type GetNeighborhoodSummaryOptions, type GetShareLinkOptions, type GetSimilarByPhotoOptions, type HHmm, LISTING_AMENITY_TITLES, LISTING_DESCRIPTION_CLAMP, type LeadContact, type LeadField, type LeadFieldId, LeadSubmitError, type LeadSubmitErrorCode, type LeadSubmitResult, type LeadUi, Listing, type ListingAmenityGroup, type ListingAmenityGroupKey, type ListingAmenitySource, type ListingBreadcrumbCrumb, type ListingDescriptionPreview, ListingDetail, type ListingDetailFieldsModel, type ListingDetailFieldsSource, type ListingDetailModel, type ListingFact, ListingFilters, ListingLocation, type ListingLocationBlock, type ListingMarketPosition, ListingMedia, type ListingMediaOverlay, type ListingPhotoGroup, type ListingValue, type ListingVisualHighlightsOptions, ListingWithLocation, ListingWithMatchedPhoto, ListingsResult, type LocationFilterInput, MAPS_MAX_IMAGE_EDGE, MAPS_SITE_HEADER, MATCHED_PHOTO_COVER_MAX_DISTANCE, MAX_NATIONAL_PHONE_DIGITS, MapsCoordinates, MapsFetchOptions, type MarketListingType, type MarketPriceBand, type MarketPropertyType, type MarketUnavailableReason, MatchedListingPhoto, NeighborhoodBoundary, NeighborhoodBoundaryOptions, type NeighborhoodSummary, type NeighborhoodSummaryQuery, PHONE_COUNTRIES, PHOTO_GROUP_OTHER_KEY, PHOTO_GROUP_OTHER_LABEL, PHOTO_SEARCH_MIN_QUERY_LENGTH, type ParsedPhoneInput, type PhoneCountry, PhotoSearchItem, PhotoSearchParams, PhotoSearchResult, type PriceEstimate, type PriceEstimateConfidence, type PriceEstimateInput, QueryListingsFilters, QueryListingsParams, QueryListingsResult, RequestNextOptions, type RequestPriceEstimateOptions, type ResolvePublicSiteIdOptions, SELLER_LEAD_PHOTO_MAX_BYTES, SELLER_LEAD_PHOTO_MAX_COUNT, SELLER_LEAD_PHOTO_TYPES, SITE_ANALYTICS_EVENT, STUDIO_DEFAULT_PHOTO_SCHEDULE_CONFIG, STUDIO_DEFAULT_VISIT_SCHEDULE, STUDIO_SDK_CONTRACT, STUDIO_SDK_PACKAGE, STUDIO_SITE_LAYOUT, type SearchListingPhotosOptions, SearchListingsParams, SearchListingsResult, SearchPathFilters, SearchUi, SearchUiDictionary, type SellerAddressErrors, type SellerAddressField, type SellerBusinessType, type SellerLeadAddress, type SellerLeadInput, type SellerLeadProperty, type SellerPhotoScheduleConfig, type ShareEntityType, type ShareLinkError, type ShareLinkErrorReason, type ShareLinkResult, type ShareLinkSuccess, type ShareLinkToken, type ShareListingEntity, type SimilarByPhotoItem, type SimilarByPhotoResult, SimilarListingsResult, type SimilarPhotoMatch, Site, StaticMapOptions, StreetViewAvailability, StreetViewAvailabilityOptions, StreetViewOptions, type StudioSdkContract, TravelDestination, TravelMode, TravelTime, TravelTimeCache, TravelTimeCacheOptions, TravelTimeElement, TravelTimeOptions, TravelTimesOptions, type UploadSellerLeadPhotoInput, VISIT_TIME_ZONE, type VisitHours, type VisitLeadInput, type VisitSchedule, type VisitScheduleConfig, analyticsDocumentGuardSource, applyMatchedPhotoCover, boundaryCitySlug, boundaryLayerId, boundaryLayerUrl, clearTravelTimeCache, coarsenCoordinates, coerceNpmVersion, collapseDuplicatedBrazilianMobileNine, compareSemver, composeSearchPublicHref, composeSearchPublicPath, coordinateDecimals, createClient, createGaragemClient, createTravelTimeCache, defaultPhoneCountry, expandVisitSchedule, expandVisitTimeSlots, findPhoneCountry, formatAreaM2, formatGroupedInteger, formatListingPrice, formatPhoneNational, getBoundaryLayer, getLeadUi, getListingMarketPosition, getNeighborhoodSummary, getShareLink, getSimilarByPhoto, hasShowcaseLeadsPostUrl, isAnalyticsDocumentUrl, isAnalyticsOnPin, isPhotoSearchOnPin, isSellerLeadOnPin, isShareLinkOnPin, isStudioPreviewHost, isValidEmail, isValidName, isValidPhone, isVisitSlotAllowed, labelAmenities, listingAmenityGroups, listingBreadcrumb, listingBusinessLabel, listingCoordinates, listingDescriptionPreview, listingDetailFieldsModel, listingDetailModel, listingFacts, listingLocationBlock, listingLookupKey, listingMapsHref, listingMediaOverlays, listingPhotoGroups, listingPublicPath, listingStaticMapUrl, listingStreetViewAvailable, listingStreetViewMetadataUrl, listingStreetViewUrl, listingValues, listingVisualHighlights, mapsExportsPublished, marketExportsAvailableAt, marketPositionLabel, maxZoomForCoordinates, mergeAppliedSearchQueryIntoSearch, nationalPhoneDigits, neighborhoodBoundaryLayer, neighborhoodBoundaryUrl, normalizeMapsBaseUrl, normalizeVisitDate, normalizeVisitTime, parseAppliedSearchQuery, parseGroupedInteger, parsePhoneInput, parseReactSdkNamedImports, parseSearchPublicPath, pathFiltersToQueryFilters, pathLocationToFilterInput, phoneCountrySearchValue, photoRoomLabel, photoSearchUrl, priceBandLabel, reduceAppliedSearchQuery, remaskPhoneForCountry, requestPriceEstimate, resolveMatchedCoverPhoto, resolvePublicSiteId, resolveTravelDestination, searchListingPhotos, sellerAddressErrors, sellerPhotoSchedule, serializeAppliedSearchQuery, slotsForDate, studioAmenityInstruction, studioChromeInstruction, studioCodegenContractViolations, studioDefaultLeadUi, studioLayoutInstruction, studioLeadInstruction, studioListingCardInstruction, studioListingDetailInstruction, studioListingViewInstruction, studioMapSearchInstruction, studioMapsInstruction, studioMarketInstruction, studioPhotoInstruction, studioPhotoInstructionFor, studioPhotoSearchInstruction, studioPublishableKeyInstruction, studioSdkPinInstruction, studioSearchInstruction, studioSearchLandmarkInstruction, studioSellerLeadSdkInstruction, studioShareLinkInstruction, studioSiteWidthCss, submitContactLead, submitSellerLead, submitVisitLead, toE164, trackListingView, travelTimeCacheKey, travelTimeFromListing, travelTimesFromListing, truncateNationalPhoneDigits, unavailableReactImports, uploadSellerLeadPhoto };
1584
+ export { AMENITY_FALLBACK_LABELS, type AmenityLabelDictionary, type AmenityLabelOption, AppliedSearchChange, AppliedSearchQuery, type ApplyMatchedPhotoCoverOptions, BoundaryCity, BoundaryLayer, BoundaryLayerOptions, CmsCollection, CmsEntriesResult, CmsEntry, type ContactLeadInput, type CreateGaragemClientOptions, DEFAULT_MAPS_BASE_URL, DEFAULT_PHONE_COUNTRY_CODE, FetchLike, type GaragemClient, type GetLeadUiOptions, type GetListingMarketPositionOptions, type GetNeighborhoodSummaryOptions, type GetShareLinkOptions, type GetSimilarByPhotoOptions, type HHmm, LISTING_AMENITY_TITLES, LISTING_DESCRIPTION_CLAMP, type LeadContact, type LeadField, type LeadFieldId, LeadSubmitError, type LeadSubmitErrorCode, type LeadSubmitResult, type LeadUi, Listing, type ListingAmenityGroup, type ListingAmenityGroupKey, type ListingAmenitySource, type ListingBreadcrumbCrumb, type ListingDescriptionPreview, ListingDetail, type ListingDetailFieldsModel, type ListingDetailFieldsSource, type ListingDetailModel, type ListingFact, ListingFilters, ListingLocation, type ListingLocationBlock, type ListingMarketPosition, ListingMedia, type ListingMediaOverlay, type ListingPhotoGroup, type ListingValue, type ListingVisualHighlightsOptions, ListingWithLocation, ListingWithMatchedPhoto, ListingsResult, type LocationFilterInput, MAPS_MAX_IMAGE_EDGE, MAPS_SITE_HEADER, MATCHED_PHOTO_COVER_MAX_DISTANCE, MAX_NATIONAL_PHONE_DIGITS, MapsCoordinates, MapsFetchOptions, type MarketListingType, type MarketPriceBand, type MarketPropertyType, type MarketUnavailableReason, MatchedListingPhoto, NeighborhoodBoundary, NeighborhoodBoundaryOptions, type NeighborhoodSummary, type NeighborhoodSummaryQuery, PHONE_COUNTRIES, PHOTO_GROUP_OTHER_KEY, PHOTO_GROUP_OTHER_LABEL, PHOTO_SEARCH_MIN_QUERY_LENGTH, type ParsedPhoneInput, type PhoneCountry, PhotoSearchItem, PhotoSearchParams, PhotoSearchResult, type PriceEstimate, type PriceEstimateConfidence, type PriceEstimateInput, QueryListingsFilters, QueryListingsParams, QueryListingsResult, RequestNextOptions, type RequestPriceEstimateOptions, type ResolvePublicSiteIdOptions, SELLER_LEAD_PHOTO_MAX_BYTES, SELLER_LEAD_PHOTO_MAX_COUNT, SELLER_LEAD_PHOTO_TYPES, SITE_ANALYTICS_EVENT, STUDIO_DEFAULT_PHOTO_SCHEDULE_CONFIG, STUDIO_DEFAULT_VISIT_SCHEDULE, STUDIO_SDK_CONTRACT, STUDIO_SDK_PACKAGE, STUDIO_SITE_LAYOUT, type SearchListingPhotosOptions, SearchListingsParams, SearchListingsResult, SearchPathFilters, SearchUi, SearchUiDictionary, type SellerAddressErrors, type SellerAddressField, type SellerBusinessType, type SellerLeadAddress, type SellerLeadInput, type SellerLeadProperty, type SellerPhotoScheduleConfig, type ShareEntityType, type ShareLinkError, type ShareLinkErrorReason, type ShareLinkResult, type ShareLinkSuccess, type ShareLinkToken, type ShareListingEntity, type SimilarByPhotoItem, type SimilarByPhotoResult, SimilarListingsResult, type SimilarPhotoMatch, Site, StaticMapOptions, StreetViewAvailability, StreetViewAvailabilityOptions, StreetViewOptions, type StudioSdkContract, TravelDestination, TravelMode, TravelTime, TravelTimeCache, TravelTimeCacheOptions, TravelTimeElement, TravelTimeOptions, TravelTimesOptions, type UploadSellerLeadPhotoInput, VISIT_TIME_ZONE, type VisitHours, type VisitLeadInput, type VisitSchedule, type VisitScheduleConfig, analyticsDocumentGuardSource, applyMatchedPhotoCover, boundaryCitySlug, boundaryLayerId, boundaryLayerUrl, clearTravelTimeCache, coarsenCoordinates, coerceNpmVersion, collapseDuplicatedBrazilianMobileNine, compareSemver, composeSearchPublicHref, composeSearchPublicPath, coordinateDecimals, createClient, createGaragemClient, createTravelTimeCache, defaultPhoneCountry, developmentCardPublished, expandVisitSchedule, expandVisitTimeSlots, findPhoneCountry, formatAreaM2, formatGroupedInteger, formatListingPrice, formatPhoneNational, getBoundaryLayer, getLeadUi, getListingMarketPosition, getNeighborhoodSummary, getShareLink, getSimilarByPhoto, hasShowcaseLeadsPostUrl, isAnalyticsDocumentUrl, isAnalyticsOnPin, isPhotoSearchOnPin, isSellerLeadOnPin, isShareLinkOnPin, isStudioPreviewHost, isValidEmail, isValidName, isValidPhone, isVisitSlotAllowed, labelAmenities, listingAmenityGroups, listingBreadcrumb, listingBusinessLabel, listingCoordinates, listingDescriptionPreview, listingDetailFieldsModel, listingDetailModel, listingFacts, listingLocationBlock, listingLookupKey, listingMapsHref, listingMediaOverlays, listingPhotoGroups, listingPublicPath, listingStaticMapUrl, listingStreetViewAvailable, listingStreetViewMetadataUrl, listingStreetViewUrl, listingValues, listingVisualHighlights, mapsExportsPublished, marketExportsAvailableAt, marketPositionLabel, maxZoomForCoordinates, mergeAppliedSearchQueryIntoSearch, nationalPhoneDigits, neighborhoodBoundaryLayer, neighborhoodBoundaryUrl, normalizeMapsBaseUrl, normalizeVisitDate, normalizeVisitTime, parseAppliedSearchQuery, parseGroupedInteger, parsePhoneInput, parseReactSdkNamedImports, parseSearchPublicPath, pathFiltersToQueryFilters, pathLocationToFilterInput, phoneCountrySearchValue, photoRoomLabel, photoSearchUrl, priceBandLabel, reduceAppliedSearchQuery, remaskPhoneForCountry, requestPriceEstimate, resolveMatchedCoverPhoto, resolvePublicSiteId, resolveTravelDestination, searchListingPhotos, sellerAddressErrors, sellerPhotoSchedule, serializeAppliedSearchQuery, slotsForDate, studioAmenityInstruction, studioChromeInstruction, studioCodegenContractViolations, studioDefaultLeadUi, studioDevelopmentCardInstruction, studioLayoutInstruction, studioLeadInstruction, studioListingCardInstruction, studioListingDetailInstruction, studioListingViewInstruction, studioMapSearchInstruction, studioMapsInstruction, studioMarketInstruction, studioPhotoInstruction, studioPhotoInstructionFor, studioPhotoSearchInstruction, studioPublishableKeyInstruction, studioSdkPinInstruction, studioSearchInstruction, studioSearchLandmarkInstruction, studioSellerLeadSdkInstruction, studioShareLinkInstruction, studioSiteWidthCss, submitContactLead, submitSellerLead, submitVisitLead, toE164, trackListingView, travelTimeCacheKey, travelTimeFromListing, travelTimesFromListing, truncateNationalPhoneDigits, unavailableReactImports, uploadSellerLeadPhoto };
package/dist/index.js CHANGED
@@ -80,6 +80,7 @@ __export(src_exports, {
80
80
  createGaragemClient: () => createGaragemClient,
81
81
  createTravelTimeCache: () => createTravelTimeCache,
82
82
  defaultPhoneCountry: () => defaultPhoneCountry,
83
+ developmentCardPublished: () => developmentCardPublished,
83
84
  displayPathLocation: () => displayPathLocation,
84
85
  expandVisitSchedule: () => expandVisitSchedule,
85
86
  expandVisitTimeSlots: () => expandVisitTimeSlots,
@@ -195,6 +196,7 @@ __export(src_exports, {
195
196
  studioChromeInstruction: () => studioChromeInstruction,
196
197
  studioCodegenContractViolations: () => studioCodegenContractViolations,
197
198
  studioDefaultLeadUi: () => studioDefaultLeadUi,
199
+ studioDevelopmentCardInstruction: () => studioDevelopmentCardInstruction,
198
200
  studioLayoutInstruction: () => studioLayoutInstruction,
199
201
  studioLeadInstruction: () => studioLeadInstruction,
200
202
  studioListingCardInstruction: () => studioListingCardInstruction,
@@ -3137,9 +3139,21 @@ function listingAmenityGroups(listing, dictionary) {
3137
3139
  function listingLocationLabel(location) {
3138
3140
  return [location.neighborhood, location.city, location.state].map((part) => part ? String(part).trim() : "").filter(Boolean).join(", ");
3139
3141
  }
3142
+ function cardPriceLabel(isPrivate, collapsed, price, formattedPrice) {
3143
+ if (isPrivate) return "Sob consulta";
3144
+ if (collapsed && price != null) return `A partir de ${formattedPrice}`;
3145
+ return formattedPrice;
3146
+ }
3140
3147
  function toListingCardModel(listing) {
3141
3148
  const isPrivate = listing.priceVisibility === "private";
3142
3149
  const area = listing.property?.usableArea ?? listing.property?.totalArea;
3150
+ const unitCount = listing.development?.unitCount;
3151
+ const collapsed = typeof unitCount === "number" && unitCount > 1;
3152
+ const formattedPrice = formatListingPrice(
3153
+ listing.price,
3154
+ "pt-BR",
3155
+ listing.currency ?? "BRL"
3156
+ );
3143
3157
  return {
3144
3158
  href: listingPublicPath(listing),
3145
3159
  title: listing.title,
@@ -3147,7 +3161,12 @@ function toListingCardModel(listing) {
3147
3161
  businessLabel: listingBusinessLabel(listing.businessType),
3148
3162
  priceVisibility: listing.priceVisibility,
3149
3163
  price: listing.price,
3150
- priceLabel: isPrivate ? "Sob consulta" : formatListingPrice(listing.price, "pt-BR", listing.currency ?? "BRL"),
3164
+ priceLabel: cardPriceLabel(
3165
+ isPrivate,
3166
+ collapsed,
3167
+ listing.price,
3168
+ formattedPrice
3169
+ ),
3151
3170
  pricePeriod: listing.businessType === "rental" && !isPrivate && listing.price != null ? "/m\xEAs" : null,
3152
3171
  locationLabel: listingLocationLabel(listing.location || {}),
3153
3172
  propertyType: listing.property?.type ?? null,
@@ -3156,7 +3175,8 @@ function toListingCardModel(listing) {
3156
3175
  bedrooms: listing.property?.bedrooms ?? null,
3157
3176
  bathrooms: listing.property?.bathrooms ?? null,
3158
3177
  parkingSpaces: listing.property?.parkingSpaces ?? null,
3159
- areaM2: area ?? null
3178
+ areaM2: area ?? null,
3179
+ unitCount: collapsed && typeof unitCount === "number" ? unitCount : null
3160
3180
  };
3161
3181
  }
3162
3182
 
@@ -3455,9 +3475,11 @@ var STUDIO_SDK_CONTRACT = {
3455
3475
  /**
3456
3476
  * Exact pin for generated Studio sites. Must match a tarball already on
3457
3477
  * npm — v0 installs this version. After a later changeset publishes, bump
3458
- * this and move that release's names from `optionalReactExports` /
3459
- * `unpublishedSearchExports` / `unpublishedPhoneExports` into the
3460
- * prompt-safe lists. Do not bump here until that tarball is on npm.
3478
+ * this and move names that tarball newly exports out of
3479
+ * `optionalReactExports` / `unpublishedSearchExports` /
3480
+ * `unpublishedPhoneExports` into the prompt-safe lists. Names that stay
3481
+ * forbidden after they ship (`searchChromeModel`, `rangeDraftFromPath`)
3482
+ * do not move. Do not bump here until that tarball is on npm.
3461
3483
  * Phone mask helpers shipped in 0.6.0. Map search
3462
3484
  * (`useMapSearch`, `searchListingsInBounds`) shipped in 0.9.0 — 0.7.0
3463
3485
  * does not export them. Property registration shipped in 0.10.0.
@@ -3466,10 +3488,12 @@ var STUDIO_SDK_CONTRACT = {
3466
3488
  * 0.12.0. Analytics catalog events (`trackListingView` plus the search
3467
3489
  * and lead emitters) shipped in 0.13.0. `property_search` sends a city
3468
3490
  * or neighborhood only when the site's location table knows it, as of
3469
- * 0.13.2. Search filter helpers (`visibleSearchFilters` /
3470
- * `toolbarFilterIds`) shipped in 0.4.12 and remain on this pin.
3491
+ * 0.13.2. Development cards (`model.unitCount`, "A partir de" on a
3492
+ * public price) shipped in 0.14.0. Search filter helpers
3493
+ * (`visibleSearchFilters` / `toolbarFilterIds`) shipped in 0.4.12 and
3494
+ * remain on this pin.
3471
3495
  */
3472
- minNpmVersion: "0.13.2",
3496
+ minNpmVersion: "0.14.0",
3473
3497
  /** Historical: older tarballs inject card CSS when those components mount. */
3474
3498
  selfInjectSince: "0.4.2",
3475
3499
  chromeStrategy: "app-owned",
@@ -3571,8 +3595,9 @@ var STUDIO_SDK_CONTRACT = {
3571
3595
  /**
3572
3596
  * Names already on the pinned npm tarball (`minNpmVersion`) — safe for
3573
3597
  * Studio prompts and completeness. Includes `visibleSearchFilters` +
3574
- * `toolbarFilterIds` (shipped in 0.4.12). Do not confuse with
3575
- * `unpublishedSearchExports` (`searchChromeModel`, …).
3598
+ * `toolbarFilterIds` (shipped in 0.4.12) and `unknownSearchLocation`
3599
+ * (shipped in 0.13.4). Do not confuse with `unpublishedSearchExports`
3600
+ * (`searchChromeModel`, …).
3576
3601
  */
3577
3602
  searchExports: [
3578
3603
  "searchResultsHeading",
@@ -3582,23 +3607,19 @@ var STUDIO_SDK_CONTRACT = {
3582
3607
  "paginationPages",
3583
3608
  "hrefWithExplicitPage",
3584
3609
  "countOptionLabel",
3585
- "countFacetChoices"
3610
+ "countFacetChoices",
3611
+ "unknownSearchLocation"
3586
3612
  ],
3587
3613
  /**
3588
- * Main-package helpers in git / newer tarballs but not required on
3589
- * `minNpmVersion`. Prompts must not mention these until the pin bumps and
3590
- * they move into `searchExports`. Independent of the 0.4.12 filter helpers
3591
- * already listed in `searchExports`.
3614
+ * Exported by the pinned tarball, and still forbidden in prompts.
3615
+ * `searchChromeModel` is retired bundled chrome — the prompt names
3616
+ * `visibleSearchFilters` and `toolbarFilterIds` instead. `rangeDraftFromPath`
3617
+ * stays unnamed; price and area drafts stay local state. Helpers the pin
3618
+ * allows (`unknownSearchLocation`, `isAnalyticsDocumentUrl`) are not here.
3592
3619
  */
3593
3620
  unpublishedSearchExports: [
3594
3621
  "searchChromeModel",
3595
- "rangeDraftFromPath",
3596
- // `unknownSearchLocation` is in git. Prompts inline the same check with
3597
- // `parseSearchPublicPath` + `locationsPath` until this name is on the pin.
3598
- "unknownSearchLocation",
3599
- // In git. The installed client inlines the check. Naming it in a prompt
3600
- // makes v0 import it from the pinned tarball, which does not export it.
3601
- "isAnalyticsDocumentUrl"
3622
+ "rangeDraftFromPath"
3602
3623
  ],
3603
3624
  /**
3604
3625
  * maps.fndn.ai helpers (static map, street view, boundaries, travel
@@ -3686,11 +3707,21 @@ var STUDIO_SDK_CONTRACT = {
3686
3707
  /**
3687
3708
  * Listing-view analytics. Search and lead catalog events need no prompt:
3688
3709
  * `usePublicSearch` and the lead helpers emit them from `analyticsSince`.
3689
- * Below it `studioListingViewInstruction` prints nothing and
3690
- * `studioCodegenContractViolations` flags `trackListingView`.
3710
+ * `isAnalyticsDocumentUrl` shipped in 0.13.6 and is prompt-safe on this
3711
+ * pin (it is not a search import). Below `analyticsSince`,
3712
+ * `studioListingViewInstruction` prints nothing and
3713
+ * `studioCodegenContractViolations` flags these names.
3714
+ */
3715
+ analyticsExports: ["trackListingView", "isAnalyticsDocumentUrl"],
3716
+ analyticsSince: "0.13.0",
3717
+ /**
3718
+ * Development cards (`model.unitCount`, "A partir de" on `priceLabel`).
3719
+ * The search API can return `listing.development` before this pin.
3720
+ * Prompts must not name `unitCount` until `minNpmVersion` reaches
3721
+ * `developmentCardSince` — v0 copies the field and an older
3722
+ * `toListingCardModel` does not set it.
3691
3723
  */
3692
- analyticsExports: ["trackListingView"],
3693
- analyticsSince: "0.13.0"
3724
+ developmentCardSince: "0.14.0"
3694
3725
  };
3695
3726
  function isSellerLeadOnPin(pin = STUDIO_SDK_CONTRACT.minNpmVersion) {
3696
3727
  return compareSemver(pin, STUDIO_SDK_CONTRACT.sellerLeadSince) >= 0;
@@ -3815,9 +3846,20 @@ function studioLeadInstruction() {
3815
3846
  const phone = STUDIO_SDK_CONTRACT.phoneExports.join(", ");
3816
3847
  return `Listing-detail visit/contact leads: import ${names} from \`${STUDIO_SDK_PACKAGE}\` (the main package, not \`/react\`). Call \`submitVisitLead\` / \`submitContactLead\` \u2014 never concatenate a leads webhook URL and never POST the Showcase demo leads route. Phone fields: import ${phone} from the same package. Display draft is \`formatPhoneNational\` (default country \`BR\`); changing country calls \`remaskPhoneForCountry\`; submit \`toE164\` and require \`isValidPhone\`. Do not invent a second mask and do not import \`@garagem/ui\` PhoneInput.`;
3817
3848
  }
3818
- function studioListingCardInstruction() {
3849
+ function developmentCardPublished(pin = STUDIO_SDK_CONTRACT.minNpmVersion) {
3850
+ return compareSemver(pin, STUDIO_SDK_CONTRACT.developmentCardSince) >= 0;
3851
+ }
3852
+ function studioDevelopmentCardInstruction(pin = STUDIO_SDK_CONTRACT.minNpmVersion) {
3853
+ if (!developmentCardPublished(pin)) return "";
3854
+ return `Development cards: \`toListingCardModel\` sets \`model.unitCount\` when several primary-market units were collapsed into one card, and \`model.priceLabel\` already starts with "A partir de". When \`model.unitCount\` is greater than 1, show it as "N unidades" and omit that line when it is null. Keep \`model.title\`, \`model.priceLabel\`, and \`model.href\`. Do not group listings in the page.`;
3855
+ }
3856
+ function studioListingCardInstruction(pin = STUDIO_SDK_CONTRACT.minNpmVersion) {
3819
3857
  const names = STUDIO_SDK_CONTRACT.listingCardExports.join(", ");
3820
- return `Listing card (site-wide). WRITE \`components/garagem/listing-card.tsx\` \u2014 one module for home, search results, and similar listings. Do not invent a second card. From \`${STUDIO_SDK_PACKAGE}\` import ${names}. \`const model = toListingCardModel(listing)\`. href is \`model.href\` / \`listingPublicPath(listing)\` \u2014 never \`listing.id\` or \`property.id\`. Skip the card or omit the link when href is empty (no \`href=""\`, no \`href="#"\`). Must show title (\`model.title\`) and price (\`model.priceLabel\` \u2014 \u201CSob consulta\u201D when private; \`model.pricePeriod\` \u201C/m\xEAs\u201D when present, omit when null). Photo: \`model.coverSrc\` as img \`src\`, alt \`model.coverAlt\`; skip the img when cover is missing; an empty-photo block is allowed; never Unsplash, \`/placeholder.svg\`, or invented \`?query=\` images. Show when present, omit the line when missing: \`locationLabel\` (else \`propertyType\`), \`listingBusinessLabel\` / \`model.businessLabel\`, bedrooms, bathrooms, parkingSpaces, area via \`formatAreaM2\`. Never interpolate the listing object as a React child. Design is free (grid vs carousel vs mosaic; radius is site \`--radius\`). WRITE \`components/garagem/listing-card-skeleton.tsx\` only for a slot whose content is still unknown \u2014 never as a \`<Suspense>\` fallback that replaces the catalog, and never the text \u201CCarregando im\xF3veis\u2026\u201D. Do not \`if (search.loading) return\` that skeleton inside the search client.`;
3858
+ const base = `Listing card (site-wide). WRITE \`components/garagem/listing-card.tsx\` \u2014 one module for home, search results, and similar listings. Do not invent a second card. From \`${STUDIO_SDK_PACKAGE}\` import ${names}. \`const model = toListingCardModel(listing)\`. href is \`model.href\` / \`listingPublicPath(listing)\` \u2014 never \`listing.id\` or \`property.id\`. Skip the card or omit the link when href is empty (no \`href=""\`, no \`href="#"\`). Must show title (\`model.title\`) and price (\`model.priceLabel\` \u2014 \u201CSob consulta\u201D when private; \`model.pricePeriod\` \u201C/m\xEAs\u201D when present, omit when null). Photo: \`model.coverSrc\` as img \`src\`, alt \`model.coverAlt\`; skip the img when cover is missing; an empty-photo block is allowed; never Unsplash, \`/placeholder.svg\`, or invented \`?query=\` images. Show when present, omit the line when missing: \`locationLabel\` (else \`propertyType\`), \`listingBusinessLabel\` / \`model.businessLabel\`, bedrooms, bathrooms, parkingSpaces, area via \`formatAreaM2\`. Never interpolate the listing object as a React child. Design is free (grid vs carousel vs mosaic; radius is site \`--radius\`). WRITE \`components/garagem/listing-card-skeleton.tsx\` only for a slot whose content is still unknown \u2014 never as a \`<Suspense>\` fallback that replaces the catalog, and never the text \u201CCarregando im\xF3veis\u2026\u201D. Do not \`if (search.loading) return\` that skeleton inside the search client.`;
3859
+ const development = studioDevelopmentCardInstruction(pin);
3860
+ return development ? `${base}
3861
+
3862
+ ${development}` : base;
3821
3863
  }
3822
3864
  function studioListingDetailInstruction() {
3823
3865
  const names = STUDIO_SDK_CONTRACT.listingDetailExports.join(", ");
@@ -5365,6 +5407,7 @@ function applyMatchedPhotoCover(cards, photoResults, options = {}) {
5365
5407
  createGaragemClient,
5366
5408
  createTravelTimeCache,
5367
5409
  defaultPhoneCountry,
5410
+ developmentCardPublished,
5368
5411
  displayPathLocation,
5369
5412
  expandVisitSchedule,
5370
5413
  expandVisitTimeSlots,
@@ -5480,6 +5523,7 @@ function applyMatchedPhotoCover(cards, photoResults, options = {}) {
5480
5523
  studioChromeInstruction,
5481
5524
  studioCodegenContractViolations,
5482
5525
  studioDefaultLeadUi,
5526
+ studioDevelopmentCardInstruction,
5483
5527
  studioLayoutInstruction,
5484
5528
  studioLeadInstruction,
5485
5529
  studioListingCardInstruction,