@sonordev/site-kit 8.5.2 → 8.7.0

package/dist/{chunk-A7RZQI6H.js → chunk-XC2TWYDV.js}

@@ -1,8 +1,8 @@
 'use client';
-import { getSiteDesignTokens, tokensForReport, shouldReportDesign, sendSiteDesign } from './chunk-7HRYSLY2.js';
-import { designTokensHash } from './chunk-IHG36STL.js';
+import { getSiteDesignTokens, tokensForReport, shouldReportDesign, sendSiteDesign } from './chunk-IXZBOOAD.js';
+import { designTokensHash } from './chunk-XHYE24HU.js';
 import { useDeferredActivation } from './chunk-YC7ELZS3.js';
-import { resolveAnalyticsTarget } from './chunk-DLM4FFNH.js';
+import { resolveAnalyticsTarget } from './chunk-QTBAKOCZ.js';
 import { useRef, useEffect } from 'react';
 
 var STAMP_KEY = (site) => `_sk_design_sent:${site}`;

package/dist/{chunk-URJN75ZG.js → chunk-XIDWNXZN.js}

@@ -1,5 +1,5 @@
-import { getSEOPageData, ensureMetadata, getABTest, recordABImpression, getRedirectData, getRobotsData, getSitemapEntries } from './chunk-Y35BWW2C.js';
-import { titleProblem, descriptionProblem } from './chunk-BQR4IPBW.js';
+import { getSEOPageData, ensureMetadata, getABTest, recordABImpression, getRedirectData, getRobotsData, getSitemapEntries } from './chunk-ODOV76VW.js';
+import { titleProblem, descriptionProblem } from './chunk-ISRBSTB7.js';
 import { resolveSiteHost } from './chunk-FESKKJAS.js';
 
 // src/seo/getManagedMetadata.ts
@@ -232,7 +232,7 @@ async function generateSitemap(options) {
   }));
 }
 async function registerLocalSitemap(options) {
-  const { registerSitemap } = await import('./server-api-EGOKC7Q3.js');
+  const { registerSitemap } = await import('./server-api-XIKDWSNO.js');
   let entries = options.entries || [];
   if (options.autoDiscover && entries.length === 0) {
     try {

package/dist/chunk-XLAHRN4B.js

@@ -0,0 +1 @@
+

package/dist/{chunk-URZTBPZO.js → chunk-XZFOQ2V4.js}

@@ -1,8 +1,8 @@
-import { getLLMsData, getOptimizedLLMsTxt } from './chunk-XA7Q2VQA.js';
-import { linkClassificationHost } from './chunk-5D7ZISUP.js';
+import { getLLMsData, getOptimizedLLMsTxt } from './chunk-EK7P62DT.js';
+import { linkClassificationHost } from './chunk-7DYMM6SS.js';
 import { resolveArticleUrl } from './chunk-4K735O3J.js';
 import { freshFetch } from './chunk-UAYAJPEP.js';
-import { LLM_GEO_CONTRACT_VERSION, sanitizePrimaryLanguageTag, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary } from './chunk-NZ4RXN3G.js';
+import { selectLlmsPages, LLM_GEO_CONTRACT_VERSION, sanitizePrimaryLanguageTag, sanitizeLlmsDisclaimerLine, llmsBlockquoteSummary, llmsAbsoluteUrl, llmsContactLines, isLlmsListablePage, groupLlmsPages, llmsPageTitle, llmsPageListNote } from './chunk-XAZC2TUD.js';
 import { resolveTrailingSlash, applyTrailingSlash } from './chunk-YVKRYQRG.js';
 import { resolveSiteHost } from './chunk-FESKKJAS.js';
 import { readFileSync, existsSync, mkdirSync, writeFileSync, renameSync, unlinkSync, readdirSync } from 'fs';
@@ -101,6 +101,47 @@ function humanizeIndustry(industry) {
   return spaced.charAt(0).toUpperCase() + spaced.slice(1);
 }
 
+// src/llms/merge.ts
+function isFilled(value) {
+  if (typeof value === "string") return value.trim() !== "";
+  return value !== null && value !== void 0;
+}
+function mergeFilledFields(sonor, local) {
+  if (!sonor && !local) return void 0;
+  if (!sonor) return local ?? void 0;
+  if (!local) return sonor;
+  const merged = { ...local };
+  for (const [key, value] of Object.entries(sonor)) {
+    if (isFilled(value) || !isFilled(merged[key])) merged[key] = value;
+  }
+  return merged;
+}
+var NAP_BUSINESS_FIELDS = ["name", "description"];
+var NAP_CONTACT_FIELDS = ["phone", "address", "city", "state", "postal_code"];
+function lacksNap(data) {
+  const business = data.business ?? {};
+  const contact = data.contact ?? {};
+  return NAP_BUSINESS_FIELDS.some((key) => !isFilled(business[key])) || NAP_CONTACT_FIELDS.some((key) => !isFilled(contact[key]));
+}
+function needsLocalData(data) {
+  if (!data) return true;
+  if (!data.services?.length || !data.faq?.length || !data.pages?.length) return true;
+  return lacksNap(data);
+}
+function mergeLlmsData(sonor, local, mergeMeta) {
+  if (!local) return sonor;
+  if (!sonor) return local;
+  return {
+    meta: mergeMeta(local.meta, sonor.meta),
+    business: mergeFilledFields(sonor.business, local.business),
+    contact: mergeFilledFields(sonor.contact, local.contact),
+    services: (sonor.services?.length ? sonor.services : local.services) ?? [],
+    faq: (sonor.faq?.length ? sonor.faq : local.faq) ?? [],
+    pages: (sonor.pages?.length ? sonor.pages : local.pages) ?? [],
+    portfolio: (sonor.portfolio?.length ? sonor.portfolio : local.portfolio) ?? []
+  };
+}
+
 // src/llms/links.ts
 var ABSOLUTE_URL = /https?:\/\/[^\s<>()[\]"'`]+/g;
 var RELATIVE_LINK_TARGET = /\]\((\/(?!\/)[^)\s]*)/g;
@@ -138,19 +179,6 @@ function resolveBaseUrl(optionBaseUrl, businessWebsite) {
   const candidate = optionBaseUrl || businessWebsite || process.env.NEXT_PUBLIC_SITE_URL || process.env.SITE_URL || "";
   return candidate.trim().replace(/\/+$/, "");
 }
-function mergeLLMsData(portal, local) {
-  if (!local) return portal;
-  if (!portal) return local;
-  return {
-    meta: mergeLlmsMeta(local.meta, portal.meta),
-    business: portal.business ?? local.business,
-    contact: portal.contact ?? local.contact,
-    services: (portal.services?.length ? portal.services : local.services) ?? [],
-    faq: (portal.faq?.length ? portal.faq : local.faq) ?? [],
-    pages: (portal.pages?.length ? portal.pages : local.pages) ?? [],
-    portfolio: (portal.portfolio?.length ? portal.portfolio : local.portfolio) ?? []
-  };
-}
 async function generateLLMsTxt(options) {
   const {
     projectId,
@@ -182,11 +210,10 @@ async function generateLLMsTxt(options) {
   } = options;
   const readFetch = fresh ? freshFetch : fetch;
   let data = await getLLMsData(projectId, site, fresh);
-  const useLocal = getLocalData && (!data || !data.services?.length);
-  if (useLocal && getLocalData) {
+  if (getLocalData && needsLocalData(data)) {
     try {
       const local = await getLocalData();
-      data = mergeLLMsData(data ?? null, local);
+      data = mergeLlmsData(data ?? null, local, mergeLlmsMeta);
     } catch (err) {
       console.warn("[site-kit] getLocalData failed:", err);
     }
@@ -222,11 +249,32 @@ async function generateLLMsTxt(options) {
     sections.push(about);
     sectionNames.push("about");
   }
+  if (includeContact) {
+    const contact = generateContactSection(data.contact);
+    if (contact) {
+      sections.push(contact);
+      sectionNames.push("contact");
+    }
+  }
   if (includeServices && data.services?.length > 0) {
-    const services = generateServicesSection(data.services);
+    const services = generateServicesSection(data.services, baseUrl);
     sections.push(services);
     sectionNames.push("services");
   }
+  const renderOptional = optionalPagePaths.length > 0 && Boolean(baseUrl);
+  const optionalKeys = renderOptional ? new Set(optionalPagePaths.map(normalizeLlmsPagePath)) : null;
+  const listable = listablePages(data.pages ?? []);
+  const indexPages = optionalKeys ? listable.filter((p) => !optionalKeys.has(normalizeLlmsPagePath(p.path))) : listable;
+  if (includePages && indexPages.length > 0) {
+    const pages = generatePagesSection(
+      selectLlmsPages(indexPages, maxPages),
+      baseUrl,
+      pageListNotesFromPublicSummaryOnly,
+      data.business?.name
+    );
+    sections.push(pages);
+    sectionNames.push("pages");
+  }
   if (includePortfolio) {
     let portfolioItems = data.portfolio || [];
     if (portfolioItems.length === 0) {
@@ -262,41 +310,11 @@ async function generateLLMsTxt(options) {
       sectionNames.push("portfolio");
     }
   }
-  if (includeContact && data.contact) {
-    const contact = generateContactSection(data.contact);
-    sections.push(contact);
-    sectionNames.push("contact");
-  }
   if (includeFAQ && data.faq?.length > 0) {
     const faq = generateFAQSection(data.faq.slice(0, maxFAQItems));
     sections.push(faq);
     sectionNames.push("faq");
   }
-  const renderOptional = optionalPagePaths.length > 0 && Boolean(baseUrl);
-  const optionalKeys = renderOptional ? new Set(optionalPagePaths.map(normalizeLlmsPagePath)) : null;
-  const indexPages = optionalKeys ? (data.pages ?? []).filter((p) => !optionalKeys.has(normalizeLlmsPagePath(p.path))) : data.pages ?? [];
-  if (includePages && indexPages.length > 0) {
-    const pages = generatePagesSection(
-      indexPages.slice(0, maxPages),
-      baseUrl,
-      pageListNotesFromPublicSummaryOnly
-    );
-    sections.push(pages);
-    sectionNames.push("pages");
-  }
-  if (renderOptional) {
-    const opt = generateOptionalPagesSection(
-      optionalPagePaths,
-      data.pages || [],
-      baseUrl,
-      pageListNotesFromPublicSummaryOnly,
-      trailingSlash
-    );
-    if (opt) {
-      sections.push(opt);
-      sectionNames.push("optional");
-    }
-  }
   if (linkToFullLlms && baseUrl) {
     const fullPath = fullLlmsTxtPath.startsWith("/") ? fullLlmsTxtPath : `/${fullLlmsTxtPath}`;
     const fullUrl = fullPath.startsWith("http") ? fullPath : `${baseUrl}${fullPath}`;
@@ -312,7 +330,7 @@ async function generateLLMsTxt(options) {
     if (includeEntities) {
       attemptedSections.push("knowledge-graph");
       optionalFetches.push(
-        import('./server-api-EGOKC7Q3.js').then(async ({ getEntities, getPrimaryEntity }) => {
+        import('./server-api-XIKDWSNO.js').then(async ({ getEntities, getPrimaryEntity }) => {
           const [entities, primaryEntity] = await Promise.all([
             getEntities().then((e) => e.slice(0, maxEntities)),
             getPrimaryEntity()
@@ -389,6 +407,20 @@ ${custom.content}`);
     sections.splice(index, 0, formatAgentAccessSection(baseUrl, agentOptions));
     sectionNames.splice(index, 0, "agent-access");
   }
+  if (renderOptional) {
+    const opt = generateOptionalPagesSection(
+      optionalPagePaths,
+      data.pages || [],
+      baseUrl,
+      pageListNotesFromPublicSummaryOnly,
+      trailingSlash,
+      data.business?.name
+    );
+    if (opt) {
+      sections.push(opt);
+      sectionNames.push("optional");
+    }
+  }
   return {
     // Every own-site link (pages, clusters, portfolio, custom sections) takes
     // the site's trailing-slash shape in one pass.
@@ -442,8 +474,7 @@ function generateHeaderSection(business, meta, resolvedBaseUrl) {
   const lines = [];
   lines.push(`# ${business.name}`);
   lines.push("");
-  const summary = business.tagline || business.description?.split(".")[0] || business.name;
-  lines.push(`> ${summary}`);
+  lines.push(`> ${llmsBlockquoteSummary(business)}`);
   if (meta?.last_updated) {
     lines.push(`> Content index last updated: ${meta.last_updated}`);
   }
@@ -477,13 +508,13 @@ function generateAboutSection(business) {
   }
   return lines.join("\n");
 }
-function generateServicesSection(services) {
+function generateServicesSection(services, baseUrl) {
   const lines = [];
   lines.push("## Services");
   lines.push("");
   for (const service of services) {
     if (service.url) {
-      lines.push(`- **[${service.name}](${service.url})**: ${service.description}`);
+      lines.push(`- **[${service.name}](${llmsAbsoluteUrl(baseUrl, service.url)})**: ${service.description}`);
     } else {
       lines.push(`- **${service.name}**: ${service.description}`);
     }
@@ -524,29 +555,8 @@ function generatePortfolioSection(items, baseUrl) {
   return lines.join("\n").trim();
 }
 function generateContactSection(contact) {
-  const lines = [];
-  lines.push("## Contact Information");
-  lines.push("");
-  if (contact.phone) {
-    lines.push(`- **Phone:** ${contact.phone}`);
-  }
-  if (contact.email) {
-    lines.push(`- **Email:** ${contact.email}`);
-  }
-  if (contact.address || contact.city) {
-    const addressParts = [
-      contact.address,
-      contact.city,
-      contact.state,
-      contact.postal_code,
-      contact.country
-    ].filter(Boolean);
-    lines.push(`- **Address:** ${addressParts.join(", ")}`);
-  }
-  if (contact.hours) {
-    lines.push(`- **Hours:** ${contact.hours}`);
-  }
-  return lines.join("\n");
+  const lines = llmsContactLines(contact);
+  return lines.length > 0 ? ["## Contact Information", "", ...lines].join("\n") : null;
 }
 function generateFAQSection(faq) {
   const lines = [];
@@ -560,32 +570,42 @@ function generateFAQSection(faq) {
   }
   return lines.join("\n").trim();
 }
-function pageListNote(page, publicSummaryOnly) {
-  const pub = sanitizeLlmsPublicSummary(page.llms_public_summary);
-  if (pub) return pub;
-  if (publicSummaryOnly) return void 0;
-  if (page.description) return page.description.replace(/[\[\]\r\n]/g, " ").trim();
-  return void 0;
+function listablePages(pages) {
+  const seen = /* @__PURE__ */ new Set();
+  return pages.filter((page) => {
+    if (!page?.path || !isLlmsListablePage({ path: page.path })) return false;
+    const key = normalizeLlmsPagePath(page.path);
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
 }
 function normalizeLlmsPagePath(path) {
   const withLeading = path.startsWith("/") ? path : `/${path}`;
   return withLeading.replace(/\/$/, "") || "/";
 }
-function formatPageLine(page, baseUrl, publicSummaryOnly) {
+function formatPageLine(page, baseUrl, publicSummaryOnly, homeName) {
   const url = page.path.startsWith("http") ? page.path : `${baseUrl}${page.path}`;
-  const note = pageListNote(page, publicSummaryOnly);
-  return note ? `- [${page.title}](${url}): ${note}` : `- [${page.title}](${url})`;
+  const title = llmsPageTitle({ path: page.path, title: page.title }, homeName).replace(/[[\]]/g, "");
+  const note = llmsPageListNote(page, publicSummaryOnly);
+  return note ? `- [${title}](${url}): ${note}` : `- [${title}](${url})`;
 }
-function generatePagesSection(pages, baseUrl, publicSummaryOnly) {
+function generatePagesSection(pages, baseUrl, publicSummaryOnly, homeName) {
   const lines = [];
   lines.push("## Site Pages");
   lines.push("");
-  for (const page of pages) {
-    lines.push(formatPageLine(page, baseUrl, publicSummaryOnly));
-  }
+  groupLlmsPages(pages).forEach((group, i) => {
+    if (group.heading) {
+      if (i > 0) lines.push("");
+      lines.push(`### ${group.heading}`, "");
+    }
+    for (const page of group.pages) {
+      lines.push(formatPageLine(page, baseUrl, publicSummaryOnly, homeName));
+    }
+  });
   return lines.join("\n");
 }
-function generateOptionalPagesSection(paths, pages, baseUrl, publicSummaryOnly, trailingSlash) {
+function generateOptionalPagesSection(paths, pages, baseUrl, publicSummaryOnly, trailingSlash, homeName) {
   const byPath = /* @__PURE__ */ new Map();
   for (const page of pages) {
     const key = normalizeLlmsPagePath(page.path);
@@ -599,7 +619,7 @@ function generateOptionalPagesSection(paths, pages, baseUrl, publicSummaryOnly,
     seen.add(key);
     const match = byPath.get(key);
     if (match) {
-      lines.push(formatPageLine(match, baseUrl, publicSummaryOnly));
+      lines.push(formatPageLine(match, baseUrl, publicSummaryOnly, homeName));
       continue;
     }
     const title = key.split("/").filter(Boolean).pop() || key;

package/dist/{chunk-I4LMZNBN.js → chunk-YYPYLYZM.js}

@@ -1,5 +1,5 @@
 'use client';
-import { detectTimezone, releaseSlotHold, fetchBookingTypeDetails, fetchBookingTypes, fetchAvailability, createSlotHold, createBooking, formatDuration, formatDate, formatTime, prepareMeeting } from './chunk-5BRHTBPO.js';
+import { detectTimezone, releaseSlotHold, fetchBookingTypeDetails, fetchBookingTypes, fetchAvailability, createSlotHold, createBooking, formatDuration, formatDate, formatTime, prepareMeeting } from './chunk-DJIGFX33.js';
 import { readPublishedApiConfig, DEFAULT_SONOR_API_URL } from './chunk-W7OPEMGJ.js';
 import { useState, useRef, useMemo, useCallback, useEffect, useId } from 'react';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';

package/dist/client/index.js

@@ -1,6 +1,6 @@
 'use client';
-export { SiteKitCredential } from '../chunk-N4ZCNYWF.js';
-import '../chunk-FVXCQC7W.js';
+export { SiteKitCredential } from '../chunk-A2MDVP47.js';
+import '../chunk-JWCCY72G.js';
 export { VISUAL_VIEWPORT_GAP_PROPERTY, VisualViewportGap, useVisualViewportGap } from '../chunk-6T6CQVNL.js';
 export { useDeferredActivation } from '../chunk-YC7ELZS3.js';
 import '../chunk-FESKKJAS.js';
@@ -9,6 +9,6 @@ export { trackConversion, trackEvent } from '../chunk-LCDVPAMR.js';
 export { getOrCreateSessionId, getOrCreateVisitorId, useSiteKitIdentity } from '../chunk-IPQKQEWI.js';
 import '../chunk-GJWI74ZZ.js';
 import '../chunk-5TM3WPCI.js';
-import '../chunk-OEA7U4HJ.js';
-import '../chunk-CFSIGEUW.js';
+import '../chunk-P5PRR2BB.js';
+import '../chunk-MNORERMF.js';
 import '../chunk-PKBMQBKP.js';

package/dist/contracts/broadcast-layouts.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Broadcast layouts: which compositions a Broadcast card draws, which retired
+ * IDs stay readable and what each one draws as, the Broadcast styles, and the
+ * review card variations with the frozen draw that gives each review its
+ * composition. Sonor's APIs and dashboard import it as
+ * `@sonordev/contracts/broadcast-layouts`.
+ *
+ * Why it exists: a post is centered (`headline`) or low (`anchor`), never
+ * top-aligned. Retiring the top-aligned compositions meant changing the same
+ * lists in three places (the Sonor API, Signal and the dashboard), and any one
+ * of them drifting would let an old ID reach a renderer or a picker. So the
+ * IDs, the retired-to-drawn map, the normalizers, the labels and the review
+ * draw live here once.
+ *
+ * Two lists, on purpose:
+ *  - CARD_LAYOUTS is every ID a stored row, a saved setting or a request may
+ *    carry. Retired IDs stay in it so old rows keep validating; they're
+ *    normalized on the way to a renderer.
+ *  - ARTICLE_COVER_LAYOUTS is what's drawn and offered. Nothing else is.
+ * Both orders are visible (rotation order and refusal messages), so they're
+ * part of the contract.
+ *
+ * Pure: no I/O, no Node built-ins. The review draw takes the SHA-256 digest
+ * of reviewCompositionSeed, which the caller hashes, so the hash stays with
+ * the server.
+ */
+/** Bumped when a stored ID here changes meaning. */
+export declare const BROADCAST_LAYOUTS_CONTRACT_VERSION = 1;
+/**
+ * Every composition ID a stored row, a saved setting or a request may carry.
+ *
+ * - `headline`: centered, the title set large.
+ * - `anchor`:   the background leads, the title sits low.
+ * - `stacked`:  retired 2026-10-14 (title pinned to the top, art below). Draws as `anchor`.
+ * - `split`:    retired (title and stage in columns). Draws as `headline`.
+ */
+export declare const CARD_LAYOUTS: readonly ['stacked', 'headline', 'split', 'anchor'];
+export type CardLayoutId = (typeof CARD_LAYOUTS)[number];
+/** The compositions Broadcast draws and offers: centered or low. Nothing is top-aligned. */
+export declare const ARTICLE_COVER_LAYOUTS: readonly ['headline', 'anchor'];
+export type ArticleCoverLayoutId = (typeof ARTICLE_COVER_LAYOUTS)[number];
+export type RetiredCardLayoutId = Exclude<CardLayoutId, ArticleCoverLayoutId>;
+/** Each retired layout ID, and the composition it draws as. */
+export declare const RETIRED_CARD_LAYOUTS: Readonly<Record<RetiredCardLayoutId, ArticleCoverLayoutId>>;
+/** A readable layout ID, retired ones included. The check every input boundary uses. */
+export declare const isCardLayoutId: (value: unknown) => value is CardLayoutId;
+/** A layout that's drawn and offered today. */
+export declare const isArticleCoverLayoutId: (value: unknown) => value is ArticleCoverLayoutId;
+/** A retired layout ID (an own key of RETIRED_CARD_LAYOUTS, never an inherited one). */
+export declare const isRetiredCardLayoutId: (value: unknown) => value is RetiredCardLayoutId;
+/**
+ * Which composition a layout ID draws. A retired ID becomes what it draws as;
+ * anything else is returned as it came, so callers check isCardLayoutId (or
+ * pass `auto` through) before rendering. Every renderer reads its layout
+ * through here, so a retired ID never reaches one.
+ */
+export declare function normalizeArticleCoverLayout(layout: CardLayoutId): ArticleCoverLayoutId;
+export declare function normalizeArticleCoverLayout<T>(layout: T): T | ArticleCoverLayoutId;
+/** What each drawn layout is called wherever a person picks one. */
+export declare const CARD_LAYOUT_LABELS: Readonly<Record<ArticleCoverLayoutId, string>>;
+/** The layout choices the API serves to pickers and agents, Anchor first. */
+export declare const CARD_LAYOUT_OPTIONS: ReadonlyArray<{
+    id: ArticleCoverLayoutId;
+    label: string;
+}>;
+/** A publication's card layout when it doesn't pin one: rotate. */
+export declare const AUTO_CARD_LAYOUT: 'auto';
+export type PublicationCardLayout = CardLayoutId | typeof AUTO_CARD_LAYOUT;
+/** What a publication-branding write may choose: rotate, or a drawn layout. */
+export declare const PUBLICATION_CARD_LAYOUTS: readonly ["auto", "headline", "anchor"];
+/** What a saved publication-branding profile may carry: a write's choices plus the retired IDs. */
+export declare const SAVED_PUBLICATION_CARD_LAYOUTS: readonly ["auto", "stacked", "headline", "split", "anchor"];
+/**
+ * The shared Broadcast look for article, review and generated post artwork.
+ * One choice per project (stored as `articleStyle`, its legacy wire name).
+ *
+ * - `glass`:     the background full bleed, the words on a frosted card.
+ * - `editorial`: paper, a serif headline, the image framed like a magazine plate.
+ * - `poster`:    one flat accent field, condensed type, big numbers.
+ * - `cinematic`: the image as a widescreen still over solid ground.
+ * - `blueprint`: a drawing sheet, with a grid, mono labels and a title block.
+ * - `focus`:     real project photos, a dark reading gradient and circular details.
+ */
+export declare const BROADCAST_STYLES: readonly ['glass', 'editorial', 'poster', 'cinematic', 'blueprint', 'focus'];
+export type BroadcastStyleId = (typeof BROADCAST_STYLES)[number];
+export declare const DEFAULT_BROADCAST_STYLE: BroadcastStyleId;
+export declare const isBroadcastStyleId: (value: unknown) => value is BroadcastStyleId;
+/**
+ * The review compositions Broadcast draws: `signature` (photo up top, the
+ * quote low) and `frame` (centered). Order matters: a review whose v1 draw
+ * was retired redraws by index into this list.
+ */
+export declare const REVIEW_CARD_VARIATIONS: readonly ['signature', 'frame'];
+export type ReviewCardVariation = (typeof REVIEW_CARD_VARIATIONS)[number];
+/** A review composition when none is chosen, or an unknown one is asked for. */
+export declare const DEFAULT_REVIEW_CARD_VARIATION: ReviewCardVariation;
+/** Each retired review variation, and what it draws as. `spotlight` pinned the quote to the top; retired 2026-10-14. */
+export declare const RETIRED_REVIEW_CARD_VARIATIONS: Readonly<Record<'spotlight', ReviewCardVariation>>;
+/** What each review variation is called wherever a person picks one. */
+export declare const REVIEW_CARD_VARIATION_LABELS: Readonly<Record<ReviewCardVariation, string>>;
+/** The review variation choices, in REVIEW_CARD_VARIATIONS order. */
+export declare const REVIEW_CARD_VARIATION_OPTIONS: ReadonlyArray<{
+    id: ReviewCardVariation;
+    label: string;
+}>;
+/** A review variation that's drawn today. Strict: a retired one isn't. */
+export declare const isReviewCardVariation: (value: unknown) => value is ReviewCardVariation;
+/**
+ * The review composition to draw for a stored or requested value: a drawn
+ * one as it is, a retired one as what it draws as, anything else (null, '',
+ * an unknown string) as the default.
+ */
+export declare function normalizeReviewCardVariation(value: unknown): ReviewCardVariation;
+/**
+ * The v1 draw list, frozen. A review's composition belongs to its immutable
+ * identity, so changing this list (or its order) would reshuffle every
+ * review's card. New compositions get a new seed version, never an edit here.
+ */
+export declare const REVIEW_CARD_VARIATION_V1_DRAW: readonly ['signature', 'spotlight', 'frame'];
+/**
+ * What a review's composition is drawn from: the project and the review, and
+ * nothing a person can edit (platform, artwork, copy and brand never move it).
+ * Hash this string with SHA-256 and pass the digest to
+ * reviewCardVariationFromDigest.
+ */
+export declare function reviewCompositionSeed(projectId: string, reviewId: string): string;
+/**
+ * The composition a review's digest draws. The first four bytes (big-endian)
+ * pick from the v1 list; a review that drew a retired composition redraws
+ * between the drawn ones from the next four, so no other review moves.
+ * `digest` is the SHA-256 of reviewCompositionSeed (a Node Buffer works).
+ */
+export declare function reviewCardVariationFromDigest(digest: ArrayLike<number>): ReviewCardVariation;