@stack-mode/site-manager-kit 1.44.0 → 1.45.0

package/src/site-chat.tsx

@@ -1,26 +1,26 @@
-import { bp, tagsFor } from "./client";
-import type { ChatConfig } from "./chat-types";
-import { SiteChatPanel, type SiteChatProps } from "./site-chat-panel";
-
-/** The chat's settings, cached like other reads and refreshed when they change in Site Manager. Null when off. */
-export async function getChatConfig(): Promise<ChatConfig | null> {
-  try {
-    return await bp<ChatConfig>("/chat", { tags: tagsFor("site_chat") });
-  } catch {
-    // Website Chat is off for the site (403), or Site Manager can't be reached: no chat rather than a broken page.
-    return null;
-  }
-}
-
-/**
- * Put once inside <body> in app/layout.tsx, with the chat route at app/api/blueprint/chat/route.ts. Shows a chat
- * button on every page while Website Chat is live in Site Manager, and nothing otherwise.
- *
- *   <SiteChat />                          the site's accent from Site Manager, light or dark from the visitor's device
- *   <SiteChat accent="#0e7c66" theme="light" position="left" />
- */
-export async function SiteChat(props: Omit<SiteChatProps, "config">) {
-  const config = await getChatConfig();
-  if (!config?.live) return null;
-  return <SiteChatPanel config={config} {...props} />;
-}
+import { bp, tagsFor } from "./client";
+import type { ChatConfig } from "./chat-types";
+import { SiteChatPanel, type SiteChatProps } from "./site-chat-panel";
+
+/** The chat's settings, cached like other reads and refreshed when they change in Site Manager. Null when off. */
+export async function getChatConfig(): Promise<ChatConfig | null> {
+  try {
+    return await bp<ChatConfig>("/chat", { tags: tagsFor("site_chat") });
+  } catch {
+    // Website Chat is off for the site (403), or Site Manager can't be reached: no chat rather than a broken page.
+    return null;
+  }
+}
+
+/**
+ * Put once inside <body> in app/layout.tsx, with the chat route at app/api/blueprint/chat/route.ts. Shows a chat
+ * button on every page while Website Chat is live in Site Manager, and nothing otherwise.
+ *
+ *   <SiteChat />                          the site's accent from Site Manager, light or dark from the visitor's device
+ *   <SiteChat accent="#0e7c66" theme="light" position="left" />
+ */
+export async function SiteChat(props: Omit<SiteChatProps, "config">) {
+  const config = await getChatConfig();
+  if (!config?.live) return null;
+  return <SiteChatPanel config={config} {...props} />;
+}

package/src/sitemap.ts

@@ -1,26 +1,26 @@
-import type { MetadataRoute } from "next";
-import { bp, tagsFor } from "./client";
-import type { SitemapEntry } from "./types";
-
-/** Pure: Site Manager's entries to Next's sitemap format, plus any extra entries the site adds. */
-export function buildSitemap(entries: SitemapEntry[], extra: MetadataRoute.Sitemap = []): MetadataRoute.Sitemap {
-  const seen = new Set<string>();
-  const out: MetadataRoute.Sitemap = [];
-  for (const e of [...entries.map((x) => ({ url: x.url, lastModified: new Date(x.lastModified) })), ...extra]) {
-    // Absolute and without a trailing slash, the home page included.
-    const url = e.url.replace(/\/+$/, "");
-    if (seen.has(url)) continue;
-    seen.add(url);
-    out.push({ ...e, url });
-  }
-  return out;
-}
-
-/**
- * For `app/sitemap.ts`: every page Site Manager lists (no noindex, no redirected paths, no pages of sections that
- * are off), with real last-modified dates.
- */
-export async function sitemap(extra: MetadataRoute.Sitemap = []): Promise<MetadataRoute.Sitemap> {
-  const entries = (await bp<SitemapEntry[]>("/sitemap", { tags: tagsFor("seo", "redirects") })) ?? [];
-  return buildSitemap(entries, extra);
-}
+import type { MetadataRoute } from "next";
+import { bp, tagsFor } from "./client";
+import type { SitemapEntry } from "./types";
+
+/** Pure: Site Manager's entries to Next's sitemap format, plus any extra entries the site adds. */
+export function buildSitemap(entries: SitemapEntry[], extra: MetadataRoute.Sitemap = []): MetadataRoute.Sitemap {
+  const seen = new Set<string>();
+  const out: MetadataRoute.Sitemap = [];
+  for (const e of [...entries.map((x) => ({ url: x.url, lastModified: new Date(x.lastModified) })), ...extra]) {
+    // Absolute and without a trailing slash, the home page included.
+    const url = e.url.replace(/\/+$/, "");
+    if (seen.has(url)) continue;
+    seen.add(url);
+    out.push({ ...e, url });
+  }
+  return out;
+}
+
+/**
+ * For `app/sitemap.ts`: every page Site Manager lists (no noindex, no redirected paths, no pages of sections that
+ * are off), with real last-modified dates.
+ */
+export async function sitemap(extra: MetadataRoute.Sitemap = []): Promise<MetadataRoute.Sitemap> {
+  const entries = (await bp<SitemapEntry[]>("/sitemap", { tags: tagsFor("seo", "redirects") })) ?? [];
+  return buildSitemap(entries, extra);
+}

package/src/structured-data.tsx

@@ -1,207 +1,207 @@
-import { jsonLdScript } from "./faq";
-import type { Event, FloorPlan, Hours, Listing, Site } from "./types";
-
-// Structured data (schema.org JSON-LD) built from what the kit already read from Site Manager. Pure helpers, so a page
-// builds its blocks from data it fetched and writes them with <StructuredData />. Empty values are left out, never
-// guessed. The business never gets a rating or reviews: search engines ignore self-served reviews for a business.
-
-type Json = Record<string, unknown>;
-
-const CONTEXT = "https://schema.org";
-const DAYS = { mon: "Monday", tue: "Tuesday", wed: "Wednesday", thu: "Thursday", fri: "Friday", sat: "Saturday", sun: "Sunday" } as const;
-
-/** Drops keys whose value is empty: undefined, null, "", or an empty list. */
-function compact(o: Json): Json {
-  return Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined && v !== null && v !== "" && !(Array.isArray(v) && v.length === 0)));
-}
-
-/** An absolute address on the website, from a path or a full URL. Null without a website address. */
-export function absoluteUrl(websiteUrl: string | null, pathOrUrl: string): string | null {
-  if (/^https?:\/\//i.test(pathOrUrl)) return pathOrUrl;
-  if (!websiteUrl) return null;
-  const base = websiteUrl.replace(/\/+$/, "");
-  const path = pathOrUrl.startsWith("/") ? pathOrUrl : `/${pathOrUrl}`;
-  return path === "/" ? base : `${base}${path.replace(/\/+$/, "")}`;
-}
-
-/** Text from HTML for descriptions: tags out, common entities decoded, spaces collapsed, cut to a length. */
-export function plainText(html: string, max = 500): string {
-  const text = html
-    .replace(/<(script|style)[\s\S]*?<\/\1>/gi, " ")
-    // Block-level tags and line breaks separate words; inline ones (<b>, <a>, <em>) sit inside them.
-    .replace(/<\/?(p|div|br|li|ul|ol|h[1-6]|tr|td|th|blockquote|section|article|figure|figcaption|hr)\b[^>]*>/gi, " ")
-    .replace(/<[^>]+>/g, "")
-    .replace(/&nbsp;/g, " ")
-    .replace(/&amp;/g, "&")
-    .replace(/&quot;/g, '"')
-    .replace(/&#39;|&apos;/g, "'")
-    .replace(/&lt;/g, "<")
-    .replace(/&gt;/g, ">")
-    .replace(/\s+/g, " ")
-    .trim();
-  return text.length > max ? `${text.slice(0, max - 1).trimEnd()}…` : text;
-}
-
-function postalAddress(a: { line1: string; line2?: string | null; city?: string | null; region?: string | null; postalCode?: string | null; country?: string | null }): Json | null {
-  const street = [a.line1, a.line2].filter(Boolean).join(", ");
-  if (!street && !a.city) return null;
-  return compact({ "@type": "PostalAddress", streetAddress: street, addressLocality: a.city, addressRegion: a.region, postalCode: a.postalCode, addressCountry: a.country });
-}
-
-/**
- * Opening hours as schema.org specifications: one per set of days sharing the same open and close times. Closed days
- * and days by appointment are left out (they have no times to publish).
- */
-export function openingHours(hours: Hours | null): Json[] {
-  if (!hours) return [];
-  const groups = new Map<string, string[]>();
-  for (const [key, day] of Object.entries(DAYS) as [keyof Hours, string][]) {
-    const h = hours[key];
-    if (!h || h.closed || !("open" in h)) continue;
-    const k = `${h.open}-${h.close}`;
-    groups.set(k, [...(groups.get(k) ?? []), day]);
-  }
-  return [...groups].map(([k, days]) => {
-    const [opens, closes] = k.split("-");
-    return { "@type": "OpeningHoursSpecification", dayOfWeek: days.map((d) => `${CONTEXT}/${d}`), opens, closes };
-  });
-}
-
-/** A Google Maps link for the Google Business Profile place. */
-export const placeMapUrl = (placeId: string) => `https://www.google.com/maps/place/?q=place_id:${encodeURIComponent(placeId)}`;
-
-/** The business as the site's main entity: its type, name, contact details, address, hours, profiles and areas. */
-export function businessJsonLd(site: Pick<Site, "name" | "websiteUrl" | "business">, opts: { logo?: string | null; image?: string | null } = {}): Json {
-  const b = site.business;
-  return compact({
-    "@context": CONTEXT,
-    "@type": b.schemaType || "LocalBusiness",
-    "@id": site.websiteUrl ? `${absoluteUrl(site.websiteUrl, "/")}#business` : undefined,
-    name: b.displayName || site.name,
-    legalName: b.legalName && b.legalName !== b.displayName ? b.legalName : undefined,
-    url: site.websiteUrl ? absoluteUrl(site.websiteUrl, "/") : undefined,
-    logo: opts.logo,
-    image: opts.image ?? opts.logo,
-    telephone: b.phone,
-    email: b.email,
-    address: postalAddress(b.address),
-    geo: b.geo ? { "@type": "GeoCoordinates", latitude: b.geo.lat, longitude: b.geo.lng } : undefined,
-    openingHoursSpecification: openingHours(b.hours),
-    sameAs: b.social.map((s) => s.url).filter((u) => /^https?:\/\//.test(u)),
-    areaServed: (b.serviceAreas ?? []).map((name) => ({ "@type": "Place", name })),
-    priceRange: b.priceRange,
-    foundingDate: b.foundedYear ? String(b.foundedYear) : undefined,
-    hasMap: b.googlePlaceId ? placeMapUrl(b.googlePlaceId) : undefined,
-  });
-}
-
-/** A breadcrumb trail from the home page down to this page. */
-export function breadcrumbJsonLd(items: { name: string; url: string }[]): Json {
-  return {
-    "@context": CONTEXT,
-    "@type": "BreadcrumbList",
-    itemListElement: items.map((it, i) => ({ "@type": "ListItem", position: i + 1, name: it.name, item: it.url })),
-  };
-}
-
-/**
- * Breadcrumb items for a path: Home, then each folder, then the page. `labels` names segments by their path
- * ("/floor-plans": "Floor Plans"); a segment without one is made readable from its slug.
- */
-export function breadcrumbsFor(path: string, websiteUrl: string, labels: Record<string, string> = {}, home = "Home"): { name: string; url: string }[] {
-  const parts = path.split(/[?#]/)[0].split("/").filter(Boolean);
-  const items = [{ name: home, url: absoluteUrl(websiteUrl, "/")! }];
-  parts.forEach((_, i) => {
-    const p = `/${parts.slice(0, i + 1).join("/")}`;
-    const fallback = decodeURIComponent(parts[i]).replace(/[-_]+/g, " ").replace(/^\w/, (c) => c.toUpperCase());
-    items.push({ name: labels[p] ?? fallback, url: absoluteUrl(websiteUrl, p)! });
-  });
-  return items;
-}
-
-const organizer = (site: Pick<Site, "name" | "websiteUrl" | "business">) => compact({ "@type": "Organization", name: site.business.displayName || site.name, url: site.websiteUrl ? absoluteUrl(site.websiteUrl, "/") : undefined });
-
-/** An event: in person at its own location text, else at the business's address. */
-export function eventJsonLd(event: Event, site: Pick<Site, "name" | "websiteUrl" | "business">, url: string): Json {
-  const address = postalAddress(site.business.address);
-  return compact({
-    "@context": CONTEXT,
-    "@type": "Event",
-    name: event.title,
-    startDate: event.allDay ? event.startsAtLocal.slice(0, 10) : event.startsAt,
-    // An all-day end is a local date; the UTC time can fall on another day, so without the local one it's left out.
-    endDate: event.endsAt ? (event.allDay ? event.endsAtLocal?.slice(0, 10) : event.endsAt) : undefined,
-    eventAttendanceMode: `${CONTEXT}/OfflineEventAttendanceMode`,
-    eventStatus: `${CONTEXT}/EventScheduled`,
-    location: compact({ "@type": "Place", name: event.locationText || site.business.displayName || site.name, address }),
-    description: plainText(event.descriptionHtml),
-    image: event.image?.url,
-    url,
-    organizer: organizer(site),
-  });
-}
-
-const sqftValue = (sqft: number | null | undefined) => (sqft ? { "@type": "QuantitativeValue", value: sqft, unitCode: "FTK" } : undefined);
-
-/**
- * A home for sale or sold, as a RealEstateListing about the home itself. Search engines have no rich result for
- * listings, so this is plain description: the offer only while it's for sale and the price is known.
- */
-export function listingJsonLd(listing: Listing, site: Pick<Site, "name" | "websiteUrl" | "business">, url: string): Json {
-  const forSale = listing.status === "active" || listing.status === "coming_soon" || listing.status === "pending";
-  const home = compact({
-    "@type": listing.propertyType === "single_family" ? "SingleFamilyResidence" : "Accommodation",
-    address: postalAddress(listing.address),
-    geo: listing.geo ? { "@type": "GeoCoordinates", latitude: listing.geo.lat, longitude: listing.geo.lng } : undefined,
-    numberOfBedrooms: listing.beds,
-    numberOfBathroomsTotal: listing.baths ? Number(listing.baths) : undefined,
-    floorSize: sqftValue(listing.sqft),
-    yearBuilt: listing.yearBuilt,
-  });
-  return compact({
-    "@context": CONTEXT,
-    "@type": "RealEstateListing",
-    name: listing.headline || [listing.address.line1, listing.address.city].filter(Boolean).join(", "),
-    url,
-    datePosted: listing.listedOn,
-    image: listing.featuredImage?.url,
-    about: home,
-    offers:
-      forSale && listing.price
-        ? { "@type": "Offer", price: listing.price, priceCurrency: "USD", availability: `${CONTEXT}/${listing.status === "pending" ? "LimitedAvailability" : "InStock"}`, seller: organizer(site) }
-        : undefined,
-  });
-}
-
-/** A floor plan inside its apartment community, with beds, baths, size and the starting rent when it's known. */
-export function floorPlanJsonLd(plan: FloorPlan, site: Pick<Site, "name" | "websiteUrl" | "business">, url: string): Json {
-  const b = site.business;
-  return compact({
-    "@context": CONTEXT,
-    "@type": b.schemaType || "ApartmentComplex",
-    name: b.displayName || site.name,
-    url: site.websiteUrl ? absoluteUrl(site.websiteUrl, "/") : undefined,
-    address: postalAddress(b.address),
-    accommodationFloorPlan: compact({
-      "@type": "FloorPlan",
-      name: plan.name,
-      url,
-      numberOfBedrooms: plan.beds,
-      numberOfBathroomsTotal: Number(plan.baths),
-      floorSize: sqftValue(plan.sqftMin),
-      image: plan.images.find((i) => i.kind === "plan")?.url ?? plan.images[0]?.url,
-      offers: plan.startingRent ? { "@type": "Offer", price: plan.startingRent, priceCurrency: "USD", description: "Starting rent per month" } : undefined,
-    }),
-  });
-}
-
-/** One `<script type="application/ld+json">` per block. A server component: put it anywhere in a page or layout. */
-export function StructuredData({ blocks }: { blocks: (Json | null | undefined | false)[] }) {
-  return (
-    <>
-      {blocks.filter((b): b is Json => !!b).map((b, i) => (
-        <script key={i} type="application/ld+json" dangerouslySetInnerHTML={{ __html: jsonLdScript(b) }} />
-      ))}
-    </>
-  );
-}
+import { jsonLdScript } from "./faq";
+import type { Event, FloorPlan, Hours, Listing, Site } from "./types";
+
+// Structured data (schema.org JSON-LD) built from what the kit already read from Site Manager. Pure helpers, so a page
+// builds its blocks from data it fetched and writes them with <StructuredData />. Empty values are left out, never
+// guessed. The business never gets a rating or reviews: search engines ignore self-served reviews for a business.
+
+type Json = Record<string, unknown>;
+
+const CONTEXT = "https://schema.org";
+const DAYS = { mon: "Monday", tue: "Tuesday", wed: "Wednesday", thu: "Thursday", fri: "Friday", sat: "Saturday", sun: "Sunday" } as const;
+
+/** Drops keys whose value is empty: undefined, null, "", or an empty list. */
+function compact(o: Json): Json {
+  return Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined && v !== null && v !== "" && !(Array.isArray(v) && v.length === 0)));
+}
+
+/** An absolute address on the website, from a path or a full URL. Null without a website address. */
+export function absoluteUrl(websiteUrl: string | null, pathOrUrl: string): string | null {
+  if (/^https?:\/\//i.test(pathOrUrl)) return pathOrUrl;
+  if (!websiteUrl) return null;
+  const base = websiteUrl.replace(/\/+$/, "");
+  const path = pathOrUrl.startsWith("/") ? pathOrUrl : `/${pathOrUrl}`;
+  return path === "/" ? base : `${base}${path.replace(/\/+$/, "")}`;
+}
+
+/** Text from HTML for descriptions: tags out, common entities decoded, spaces collapsed, cut to a length. */
+export function plainText(html: string, max = 500): string {
+  const text = html
+    .replace(/<(script|style)[\s\S]*?<\/\1>/gi, " ")
+    // Block-level tags and line breaks separate words; inline ones (<b>, <a>, <em>) sit inside them.
+    .replace(/<\/?(p|div|br|li|ul|ol|h[1-6]|tr|td|th|blockquote|section|article|figure|figcaption|hr)\b[^>]*>/gi, " ")
+    .replace(/<[^>]+>/g, "")
+    .replace(/&nbsp;/g, " ")
+    .replace(/&amp;/g, "&")
+    .replace(/&quot;/g, '"')
+    .replace(/&#39;|&apos;/g, "'")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/\s+/g, " ")
+    .trim();
+  return text.length > max ? `${text.slice(0, max - 1).trimEnd()}…` : text;
+}
+
+function postalAddress(a: { line1: string; line2?: string | null; city?: string | null; region?: string | null; postalCode?: string | null; country?: string | null }): Json | null {
+  const street = [a.line1, a.line2].filter(Boolean).join(", ");
+  if (!street && !a.city) return null;
+  return compact({ "@type": "PostalAddress", streetAddress: street, addressLocality: a.city, addressRegion: a.region, postalCode: a.postalCode, addressCountry: a.country });
+}
+
+/**
+ * Opening hours as schema.org specifications: one per set of days sharing the same open and close times. Closed days
+ * and days by appointment are left out (they have no times to publish).
+ */
+export function openingHours(hours: Hours | null): Json[] {
+  if (!hours) return [];
+  const groups = new Map<string, string[]>();
+  for (const [key, day] of Object.entries(DAYS) as [keyof Hours, string][]) {
+    const h = hours[key];
+    if (!h || h.closed || !("open" in h)) continue;
+    const k = `${h.open}-${h.close}`;
+    groups.set(k, [...(groups.get(k) ?? []), day]);
+  }
+  return [...groups].map(([k, days]) => {
+    const [opens, closes] = k.split("-");
+    return { "@type": "OpeningHoursSpecification", dayOfWeek: days.map((d) => `${CONTEXT}/${d}`), opens, closes };
+  });
+}
+
+/** A Google Maps link for the Google Business Profile place. */
+export const placeMapUrl = (placeId: string) => `https://www.google.com/maps/place/?q=place_id:${encodeURIComponent(placeId)}`;
+
+/** The business as the site's main entity: its type, name, contact details, address, hours, profiles and areas. */
+export function businessJsonLd(site: Pick<Site, "name" | "websiteUrl" | "business">, opts: { logo?: string | null; image?: string | null } = {}): Json {
+  const b = site.business;
+  return compact({
+    "@context": CONTEXT,
+    "@type": b.schemaType || "LocalBusiness",
+    "@id": site.websiteUrl ? `${absoluteUrl(site.websiteUrl, "/")}#business` : undefined,
+    name: b.displayName || site.name,
+    legalName: b.legalName && b.legalName !== b.displayName ? b.legalName : undefined,
+    url: site.websiteUrl ? absoluteUrl(site.websiteUrl, "/") : undefined,
+    logo: opts.logo,
+    image: opts.image ?? opts.logo,
+    telephone: b.phone,
+    email: b.email,
+    address: postalAddress(b.address),
+    geo: b.geo ? { "@type": "GeoCoordinates", latitude: b.geo.lat, longitude: b.geo.lng } : undefined,
+    openingHoursSpecification: openingHours(b.hours),
+    sameAs: b.social.map((s) => s.url).filter((u) => /^https?:\/\//.test(u)),
+    areaServed: (b.serviceAreas ?? []).map((name) => ({ "@type": "Place", name })),
+    priceRange: b.priceRange,
+    foundingDate: b.foundedYear ? String(b.foundedYear) : undefined,
+    hasMap: b.googlePlaceId ? placeMapUrl(b.googlePlaceId) : undefined,
+  });
+}
+
+/** A breadcrumb trail from the home page down to this page. */
+export function breadcrumbJsonLd(items: { name: string; url: string }[]): Json {
+  return {
+    "@context": CONTEXT,
+    "@type": "BreadcrumbList",
+    itemListElement: items.map((it, i) => ({ "@type": "ListItem", position: i + 1, name: it.name, item: it.url })),
+  };
+}
+
+/**
+ * Breadcrumb items for a path: Home, then each folder, then the page. `labels` names segments by their path
+ * ("/floor-plans": "Floor Plans"); a segment without one is made readable from its slug.
+ */
+export function breadcrumbsFor(path: string, websiteUrl: string, labels: Record<string, string> = {}, home = "Home"): { name: string; url: string }[] {
+  const parts = path.split(/[?#]/)[0].split("/").filter(Boolean);
+  const items = [{ name: home, url: absoluteUrl(websiteUrl, "/")! }];
+  parts.forEach((_, i) => {
+    const p = `/${parts.slice(0, i + 1).join("/")}`;
+    const fallback = decodeURIComponent(parts[i]).replace(/[-_]+/g, " ").replace(/^\w/, (c) => c.toUpperCase());
+    items.push({ name: labels[p] ?? fallback, url: absoluteUrl(websiteUrl, p)! });
+  });
+  return items;
+}
+
+const organizer = (site: Pick<Site, "name" | "websiteUrl" | "business">) => compact({ "@type": "Organization", name: site.business.displayName || site.name, url: site.websiteUrl ? absoluteUrl(site.websiteUrl, "/") : undefined });
+
+/** An event: in person at its own location text, else at the business's address. */
+export function eventJsonLd(event: Event, site: Pick<Site, "name" | "websiteUrl" | "business">, url: string): Json {
+  const address = postalAddress(site.business.address);
+  return compact({
+    "@context": CONTEXT,
+    "@type": "Event",
+    name: event.title,
+    startDate: event.allDay ? event.startsAtLocal.slice(0, 10) : event.startsAt,
+    // An all-day end is a local date; the UTC time can fall on another day, so without the local one it's left out.
+    endDate: event.endsAt ? (event.allDay ? event.endsAtLocal?.slice(0, 10) : event.endsAt) : undefined,
+    eventAttendanceMode: `${CONTEXT}/OfflineEventAttendanceMode`,
+    eventStatus: `${CONTEXT}/EventScheduled`,
+    location: compact({ "@type": "Place", name: event.locationText || site.business.displayName || site.name, address }),
+    description: plainText(event.descriptionHtml),
+    image: event.image?.url,
+    url,
+    organizer: organizer(site),
+  });
+}
+
+const sqftValue = (sqft: number | null | undefined) => (sqft ? { "@type": "QuantitativeValue", value: sqft, unitCode: "FTK" } : undefined);
+
+/**
+ * A home for sale or sold, as a RealEstateListing about the home itself. Search engines have no rich result for
+ * listings, so this is plain description: the offer only while it's for sale and the price is known.
+ */
+export function listingJsonLd(listing: Listing, site: Pick<Site, "name" | "websiteUrl" | "business">, url: string): Json {
+  const forSale = listing.status === "active" || listing.status === "coming_soon" || listing.status === "pending";
+  const home = compact({
+    "@type": listing.propertyType === "single_family" ? "SingleFamilyResidence" : "Accommodation",
+    address: postalAddress(listing.address),
+    geo: listing.geo ? { "@type": "GeoCoordinates", latitude: listing.geo.lat, longitude: listing.geo.lng } : undefined,
+    numberOfBedrooms: listing.beds,
+    numberOfBathroomsTotal: listing.baths ? Number(listing.baths) : undefined,
+    floorSize: sqftValue(listing.sqft),
+    yearBuilt: listing.yearBuilt,
+  });
+  return compact({
+    "@context": CONTEXT,
+    "@type": "RealEstateListing",
+    name: listing.headline || [listing.address.line1, listing.address.city].filter(Boolean).join(", "),
+    url,
+    datePosted: listing.listedOn,
+    image: listing.featuredImage?.url,
+    about: home,
+    offers:
+      forSale && listing.price
+        ? { "@type": "Offer", price: listing.price, priceCurrency: "USD", availability: `${CONTEXT}/${listing.status === "pending" ? "LimitedAvailability" : "InStock"}`, seller: organizer(site) }
+        : undefined,
+  });
+}
+
+/** A floor plan inside its apartment community, with beds, baths, size and the starting rent when it's known. */
+export function floorPlanJsonLd(plan: FloorPlan, site: Pick<Site, "name" | "websiteUrl" | "business">, url: string): Json {
+  const b = site.business;
+  return compact({
+    "@context": CONTEXT,
+    "@type": b.schemaType || "ApartmentComplex",
+    name: b.displayName || site.name,
+    url: site.websiteUrl ? absoluteUrl(site.websiteUrl, "/") : undefined,
+    address: postalAddress(b.address),
+    accommodationFloorPlan: compact({
+      "@type": "FloorPlan",
+      name: plan.name,
+      url,
+      numberOfBedrooms: plan.beds,
+      numberOfBathroomsTotal: Number(plan.baths),
+      floorSize: sqftValue(plan.sqftMin),
+      image: plan.images.find((i) => i.kind === "plan")?.url ?? plan.images[0]?.url,
+      offers: plan.startingRent ? { "@type": "Offer", price: plan.startingRent, priceCurrency: "USD", description: "Starting rent per month" } : undefined,
+    }),
+  });
+}
+
+/** One `<script type="application/ld+json">` per block. A server component: put it anywhere in a page or layout. */
+export function StructuredData({ blocks }: { blocks: (Json | null | undefined | false)[] }) {
+  return (
+    <>
+      {blocks.filter((b): b is Json => !!b).map((b, i) => (
+        <script key={i} type="application/ld+json" dangerouslySetInnerHTML={{ __html: jsonLdScript(b) }} />
+      ))}
+    </>
+  );
+}