@sonordev/site-kit 8.6.0 → 8.7.0

package/dist/{chunk-RI2N2EBI.js → chunk-JYITKUUB.js}

@@ -1,5 +1,6 @@
 import { insertArticlePhotos } from './chunk-WHPCGQHC.js';
 import { resolveRepresentativeImage, generateArticleAuthorNode, articleImageSchema, resolveArticleArtwork, withArticleAuthorIdentity } from './chunk-UVYUTBT4.js';
+import { stripHtmlTags } from './chunk-IBHBEUZV.js';
 import { resolveArticleUrl, createPublicationRoutes, resolvePublicationUrl, articleCategorySlug } from './chunk-4K735O3J.js';
 import { withoutSchemaPlaceholders } from './chunk-VWWITFWM.js';
 import { withSiteParam, withSiteBody } from './chunk-MJP63SSS.js';
@@ -208,6 +209,13 @@ function createPublicationPreviewHandler(options) {
     } });
   };
 }
+
+// packages/press-kit/src/articles/article-body.ts
+function articleBodyHtml(post) {
+  return typeof post.content_html === "string" ? post.content_html : "";
+}
+
+// packages/press-kit/src/articles/server-core.ts
 async function getArticleResult(slug, options) {
   const config = resolveServerApiConfig();
   return config ? readArticleBySlug({ ...config, site: options?.site }, slug) : { state: "unavailable" };
@@ -631,7 +639,7 @@ async function getAllArticles(options = {}) {
   return posts.slice(0, maxPosts);
 }
 function stripHtml(html) {
-  return html.replace(/<[^>]*>/g, "").trim();
+  return stripHtmlTags(html).replace(/</g, "&lt;").replace(/>/g, "&gt;").trim();
 }
 async function generateRssFeed(options) {
   const {
@@ -683,7 +691,7 @@ async function generateRssFeed(options) {
     const postUrl = resolveArticleUrl(post, { ...options, siteUrl });
     const pubDate = post.published_at ? new Date(post.published_at).toUTCString() : now;
     const author = typeof post.author === "string" ? post.author : post.author?.name || "Unknown";
-    const fullContent = insertArticlePhotos(post.content_html || post.content || "", post.editorial_photos);
+    const fullContent = insertArticlePhotos(articleBodyHtml(post), post.editorial_photos);
     const description2 = sanitizeExcerpt(post.excerpt, 300) || stripHtml(fullContent).substring(0, 300) + "...";
     rss += `    <item>
       <title>${escapeXml(post.title)}</title>
@@ -707,7 +715,7 @@ async function generateRssFeed(options) {
       }
     }
     if (post.featured_image) {
-      rss += `      <enclosure url="${post.featured_image}" type="image/jpeg"/>
+      rss += `      <enclosure url="${escapeXml(post.featured_image)}" type="image/jpeg"/>
 `;
     }
     rss += `    </item>
@@ -746,7 +754,7 @@ async function generateAtomFeed(options) {
     const updated = post.updated_at || post.published_at || now;
     const published = post.published_at || now;
     const author = typeof post.author === "string" ? post.author : post.author?.name || "Unknown";
-    const fullContent = insertArticlePhotos(post.content_html || post.content || "", post.editorial_photos);
+    const fullContent = insertArticlePhotos(articleBodyHtml(post), post.editorial_photos);
     atom += `  <entry>
     <title>${escapeXml(post.title)}</title>
     <link href="${escapeXml(postUrl)}"/>
@@ -1164,4 +1172,4 @@ function generateAuthorPageMetadata(author, options = {}) {
   };
 }
 
-export { ArticleUnavailableError, FEED_DEFAULT_ITEMS, NEWS_SITEMAP_MAX_URLS, NEWS_SITEMAP_WINDOW_MS, PUBLICATION_PREVIEW_COOKIE, PUBLICATION_PREVIEW_HEADERS, SEO_LIMITS, buildNewsSitemapXml, cdata, createPublicationPreviewHandler, fetchArticleBySlug, fetchArticleCategories, fetchRelatedArticles, generateAllArticleSchemas, generateArticleCategoryMetadata, generateArticleListSchema, generateArticleMetadata, generateArticleSchema, generateArticleSitemap, generateArticleStaticParams, generateAtomFeed, generateAuthorPageMetadata, generateAuthorStaticParams, generateBreadcrumbSchema, generateCategoryStaticParams, generateClusterArticleSchema, generateClusterBreadcrumbSchema, generateClusterItemListSchema, generateClusterLandingSchema, generateClusterPageMetadata, generateFaqSchema, generateHowToSchema, generateNewsSitemap, generatePublicationMetadata, generateRssFeed, getAllArticleSlugs, getAllArticles, getAllAuthorSlugs, getArticle, getArticleCategories, getArticlePreview, getArticleResult, getAuthorBySlug, getAuthorPosts, getClusterNavigation, getPostsByCategory, getPublicationIssue, getPublicationIssues, getRelatedInsights, getTopicCluster, getTopicClusters, recentNewsPosts, requireArticle, sanitizeExcerpt, validateArticleSeo, validateMetaDescription, validateSeoTitle };
+export { ArticleUnavailableError, FEED_DEFAULT_ITEMS, NEWS_SITEMAP_MAX_URLS, NEWS_SITEMAP_WINDOW_MS, PUBLICATION_PREVIEW_COOKIE, PUBLICATION_PREVIEW_HEADERS, SEO_LIMITS, articleBodyHtml, buildNewsSitemapXml, cdata, createPublicationPreviewHandler, fetchArticleBySlug, fetchArticleCategories, fetchRelatedArticles, generateAllArticleSchemas, generateArticleCategoryMetadata, generateArticleListSchema, generateArticleMetadata, generateArticleSchema, generateArticleSitemap, generateArticleStaticParams, generateAtomFeed, generateAuthorPageMetadata, generateAuthorStaticParams, generateBreadcrumbSchema, generateCategoryStaticParams, generateClusterArticleSchema, generateClusterBreadcrumbSchema, generateClusterItemListSchema, generateClusterLandingSchema, generateClusterPageMetadata, generateFaqSchema, generateHowToSchema, generateNewsSitemap, generatePublicationMetadata, generateRssFeed, getAllArticleSlugs, getAllArticles, getAllAuthorSlugs, getArticle, getArticleCategories, getArticlePreview, getArticleResult, getAuthorBySlug, getAuthorPosts, getClusterNavigation, getPostsByCategory, getPublicationIssue, getPublicationIssues, getRelatedInsights, getTopicCluster, getTopicClusters, recentNewsPosts, requireArticle, sanitizeExcerpt, validateArticleSeo, validateMetaDescription, validateSeoTitle };

package/dist/chunk-KIYACQW3.js

@@ -0,0 +1 @@
+

package/dist/{chunk-OFSV5TZY.js → chunk-KLIDCNML.js}

@@ -54,7 +54,7 @@ function useSignal() {
   return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
 }
 var LazySignalCore = dynamic(
-  () => import('./SignalCore-FEFNMNYN.js').then((m) => ({ default: m.SignalCore })),
+  () => import('./SignalCore-UV7K7PT4.js').then((m) => ({ default: m.SignalCore })),
   { ssr: false }
 );
 function SignalBridge({

package/dist/{chunk-7R2STOVD.js → chunk-L2KSHJS2.js}

@@ -1,6 +1,6 @@
 'use client';
-import { countStageViews, countStageQuestions, useFieldControls } from './chunk-NI6ZTP3D.js';
-import { useFormLoadedAt, useFormTracking, submitForm, useRecaptchaWarmup, useForm } from './chunk-HMTPRBYJ.js';
+import { countStageViews, countStageQuestions, useFieldControls } from './chunk-36ZMNBXZ.js';
+import { useFormLoadedAt, useFormTracking, submitForm, useRecaptchaWarmup, useForm } from './chunk-LGWN6KCN.js';
 import { readAgentSubmit, formToolAttributes } from './chunk-Q6E4OPGG.js';
 import { isFieldVisible, validateField, isFieldComplete, isDisplayOnly, unseenControlValues } from './chunk-C2FZBUSS.js';
 import { HoneypotField } from './chunk-DXO6SBMD.js';
@@ -63,7 +63,7 @@ function FormClient({
       return;
     }
     let cancelled = false;
-    const load = resolvedExperience === "stage" ? import('./FormStage-2PLWWYBW.js').then((m) => m.FormStage) : import('./FormSpotlight-H73ZZ66T.js').then((m) => m.FormSpotlight);
+    const load = resolvedExperience === "stage" ? import('./FormStage-I4JGLT57.js').then((m) => m.FormStage) : import('./FormSpotlight-DNBSBRIE.js').then((m) => m.FormSpotlight);
     load.then((Component) => {
       if (!cancelled) setExperience(() => Component);
     }).catch((err) => {

package/dist/{chunk-HMTPRBYJ.js → chunk-LGWN6KCN.js}

@@ -6,7 +6,7 @@ import { normalizeFormConfig, DEFAULT_FORM_SUCCESS_MESSAGE } from './chunk-TYSIA
 import { DEFAULT_HONEYPOT_FIELD } from './chunk-NJCTQH2P.js';
 import { onPageLeave } from './chunk-L2V5PUFN.js';
 import { uuid } from './chunk-GJWI74ZZ.js';
-import { sonorFetch, sonorBeacon } from './chunk-IYCSDFPN.js';
+import { sonorFetch, sonorBeacon } from './chunk-UYOE3HA4.js';
 import { readPublishedApiConfig, getClientApiConfig } from './chunk-W7OPEMGJ.js';
 import { useRef, useCallback, useEffect, useState, useMemo } from 'react';
 

package/dist/{chunk-YNBRVVTX.js → chunk-MJW6YIDJ.js}

@@ -1,5 +1,5 @@
 import { secretsMatch, readCappedBody } from './chunk-XTRZGXB2.js';
-import { SITE_KIT_VERSION } from './chunk-BUE3Z32O.js';
+import { SITE_KIT_VERSION } from './chunk-MNORERMF.js';
 
 // src/llms/revalidate.ts
 function createLlmsRevalidateHandler(secret, options) {

package/dist/{chunk-BUE3Z32O.js → chunk-MNORERMF.js}

@@ -1,4 +1,4 @@
 // src/shared/version.ts
-var SITE_KIT_VERSION = "8.6.0";
+var SITE_KIT_VERSION = "8.7.0";
 
 export { SITE_KIT_VERSION };

package/dist/{chunk-Y35BWW2C.js → chunk-ODOV76VW.js}

@@ -1,5 +1,5 @@
 import { withSiteBody } from './chunk-MJP63SSS.js';
-import { SITE_CACHE_TAGS } from './chunk-6KU7STM3.js';
+import { SITE_CACHE_TAGS } from './chunk-HY7ZEU2C.js';
 import { serverApiFetch, requireServerApiConfig } from './chunk-C7TLGL3R.js';
 import { postRegisterSitemap, resolveSyncSite } from './chunk-DIKNRN34.js';
 import { cache } from 'react';

package/dist/{chunk-6NXFA7HE.js → chunk-OHLCE4GC.js}

@@ -1,7 +1,7 @@
 'use client';
 import { locToPath, isMalformedSitemapPath, inferPageType } from './chunk-YVKRYQRG.js';
-import { resolveAnalyticsTarget } from './chunk-DLM4FFNH.js';
-import { sonorFetch } from './chunk-IYCSDFPN.js';
+import { resolveAnalyticsTarget } from './chunk-QTBAKOCZ.js';
+import { sonorFetch } from './chunk-UYOE3HA4.js';
 import { useRef, useEffect } from 'react';
 
 var SYNC_STAMP_KEY = "_sk_sitemap_synced_at";

package/dist/{chunk-QQT2T6JQ.js → chunk-P5PRR2BB.js}

@@ -1,4 +1,4 @@
-import { SITE_KIT_VERSION } from './chunk-BUE3Z32O.js';
+import { SITE_KIT_VERSION } from './chunk-MNORERMF.js';
 
 // src/shared/siteToken.ts
 var SITE_TOKEN_PREFIX = "st1.";

package/dist/{chunk-JJ4JS3LD.js → chunk-PAYCK7FC.js}

@@ -1,5 +1,5 @@
 'use client';
-import { normalizeCampaignSlug } from './chunk-OSYCOC3K.js';
+import { normalizeCampaignSlug } from './chunk-3MJNBOUO.js';
 import { useEffect } from 'react';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 

package/dist/{chunk-DLM4FFNH.js → chunk-QTBAKOCZ.js}

@@ -1,4 +1,4 @@
-import { FRAME_READY_MESSAGE } from './chunk-EKBEOXTH.js';
+import { FRAME_READY_MESSAGE } from './chunk-VEJD5EJ2.js';
 import { readPublishedApiConfig, DEFAULT_SONOR_API_URL } from './chunk-W7OPEMGJ.js';
 
 // src/shared/frame.ts

package/dist/{chunk-L6QTERSH.js → chunk-RHT7OZNF.js}

@@ -1,4 +1,4 @@
-import { sonorFetch } from './chunk-IYCSDFPN.js';
+import { sonorFetch } from './chunk-UYOE3HA4.js';
 import { readPublishedApiConfig } from './chunk-W7OPEMGJ.js';
 
 // src/forms/formsApi.ts

package/dist/{chunk-YJH6WE76.js → chunk-RWWSOYJO.js}

@@ -1,12 +1,12 @@
 'use client';
 import { SITE_EDIT_PARAM } from './chunk-6G43IRWR.js';
-import { publishSiteCredential } from './chunk-VA6IJ55K.js';
-import { FleetHeartbeat } from './chunk-U34O6I7W.js';
+import { publishSiteCredential } from './chunk-JWCCY72G.js';
+import { FleetHeartbeat } from './chunk-5WHBYQJ4.js';
 import { useDeferredActivation } from './chunk-YC7ELZS3.js';
 import { resolveSiteHost } from './chunk-FESKKJAS.js';
 import { getOrCreateVisitorId, getOrCreateSessionId } from './chunk-IPQKQEWI.js';
-import { announceFrameReady, isPrivatePreview, isCrossOriginFrame } from './chunk-DLM4FFNH.js';
-import { SignalBridge } from './chunk-OFSV5TZY.js';
+import { announceFrameReady, isPrivatePreview, isCrossOriginFrame } from './chunk-QTBAKOCZ.js';
+import { SignalBridge } from './chunk-KLIDCNML.js';
 import React, { useState, useRef, useCallback, useEffect, Suspense } from 'react';
 import dynamic from 'next/dynamic';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
@@ -33,23 +33,23 @@ function startEditBridge() {
   };
 }
 var LazyAnalyticsProvider = dynamic(
-  () => import('./AnalyticsProvider-GVJYL6XY.js').then((m) => ({ default: m.AnalyticsProvider })),
+  () => import('./AnalyticsProvider-3UIQMIRW.js').then((m) => ({ default: m.AnalyticsProvider })),
   { ssr: false }
 );
 var LazySiteChat = dynamic(
-  () => import('./SiteChat-3MKYL2XM.js').then((m) => ({ default: m.SiteChat })),
+  () => import('./SiteChat-6UWE545R.js').then((m) => ({ default: m.SiteChat })),
   { ssr: false }
 );
 var LazySitePopups = dynamic(
-  () => import('./SitePopups-C44YTQ3Q.js').then((m) => ({ default: m.SitePopups })),
+  () => import('./SitePopups-XHWU7GNF.js').then((m) => ({ default: m.SitePopups })),
   { ssr: false }
 );
 var LazySiteDesignReporter = dynamic(
-  () => import('./SiteDesignReporter-AJDIBNHI.js').then((m) => ({ default: m.SiteDesignReporter })),
+  () => import('./SiteDesignReporter-ZSU76DZJ.js').then((m) => ({ default: m.SiteDesignReporter })),
   { ssr: false }
 );
 var LazySitemapSync = dynamic(
-  () => import('./SitemapSync-UJA6JVPW.js').then((m) => ({ default: m.SitemapSync })),
+  () => import('./SitemapSync-ELWV6W7Y.js').then((m) => ({ default: m.SitemapSync })),
   { ssr: false }
 );
 function SiteKitClientProviders({

package/dist/{chunk-JSW42BHL.js → chunk-T6TWPKBL.js}

@@ -1,7 +1,7 @@
 import { trackedFreshFetch } from './chunk-UAYAJPEP.js';
 import { isNextControlFlow } from './chunk-C7TLGL3R.js';
 import { monotonicMs } from './chunk-MH2DSGC6.js';
-import { SITE_KIT_VERSION } from './chunk-BUE3Z32O.js';
+import { SITE_KIT_VERSION } from './chunk-MNORERMF.js';
 import 'server-only';
 
 var MINT_PATH = "/api/public/site-token";

package/dist/{chunk-FTSEP7Q3.js → chunk-U4OQJQK6.js}

@@ -2,8 +2,8 @@
 import { DEFAULT_WIDGET_Z_INDEX } from './chunk-27FISYK4.js';
 import { readAnalyticsIdentity } from './chunk-5ROTTMBL.js';
 import { getOrCreateVisitorId } from './chunk-IPQKQEWI.js';
-import { resolveAnalyticsTarget } from './chunk-DLM4FFNH.js';
-import { sonorFetch } from './chunk-IYCSDFPN.js';
+import { resolveAnalyticsTarget } from './chunk-QTBAKOCZ.js';
+import { sonorFetch } from './chunk-UYOE3HA4.js';
 import { useState, useEffect, useCallback, useRef } from 'react';
 import ReactDOM from 'react-dom';
 import dynamic from 'next/dynamic';
@@ -161,7 +161,7 @@ function activatePopup(active, id, popups) {
   return [...active, id];
 }
 var LazyBlocksPopup = dynamic(
-  () => import('./BlocksPopup-AJ3CKVQG.js').then((m) => ({ default: m.BlocksPopup })),
+  () => import('./BlocksPopup-DFE32GPX.js').then((m) => ({ default: m.BlocksPopup })),
   { ssr: false }
 );
 function SitePopups(props) {

package/dist/{chunk-IYCSDFPN.js → chunk-UYOE3HA4.js}

@@ -1,5 +1,5 @@
-import { isTokenMode, getFreshCredential, isSiteToken, refreshSiteToken, currentCredential, credentialBreakerId } from './chunk-QQT2T6JQ.js';
-import { SITE_KIT_VERSION } from './chunk-BUE3Z32O.js';
+import { isTokenMode, getFreshCredential, isSiteToken, refreshSiteToken, currentCredential, credentialBreakerId } from './chunk-P5PRR2BB.js';
+import { SITE_KIT_VERSION } from './chunk-MNORERMF.js';
 
 // src/shared/fetchWithRetry.ts
 function backoffDelay(attempt, response) {

package/dist/chunk-VEJD5EJ2.js

@@ -0,0 +1,344 @@
+// src/contracts/portfolio.ts
+var FRAME_READY_MESSAGE = "sonor:frame-ready";
+function isFrameReadyMessage(data) {
+  return !!data && typeof data === "object" && data.type === FRAME_READY_MESSAGE && data.v === 1;
+}
+var PORTFOLIO_CONTRACT_VERSION = 1;
+var CASE_STUDY_STAGES = ["problem", "build", "proof", "outcome"];
+var CASE_STUDY_STAGE_COPY = {
+  problem: { name: "The problem", question: "What did the client come in with, and what was in the way?" },
+  build: { name: "The build", question: "What did we plan and make, and out of what?" },
+  proof: { name: "The proof", question: "How does the finished build hold up when measured?" },
+  outcome: { name: "The outcome", question: "What is the work doing for the client now?" }
+};
+var STAGE_NAME_MAX_CHARS = 24;
+function stageNamesProblems(names) {
+  if (names === void 0 || names === null) return [];
+  if (typeof names !== "object" || Array.isArray(names)) return ["stageNames must be an object"];
+  const problems = [];
+  for (const [stage, name] of Object.entries(names)) {
+    if (!CASE_STUDY_STAGES.includes(stage)) problems.push(`stageNames.${stage} is not a stage`);
+    else if (name === void 0 || name === null) continue;
+    else if (typeof name !== "string") problems.push(`stageNames.${stage} must be text`);
+    else if (name.trim().length > STAGE_NAME_MAX_CHARS)
+      problems.push(`stageNames.${stage} is over ${STAGE_NAME_MAX_CHARS} characters`);
+  }
+  return problems;
+}
+function stageName(names, stage) {
+  const own = names?.[stage]?.trim();
+  return own || CASE_STUDY_STAGE_COPY[stage].name;
+}
+var PORTFOLIO_SECTION_TYPES = [
+  "portfolioHero",
+  // problem
+  "portfolioChallenges",
+  "portfolioBeforeAfter",
+  // build
+  "portfolioStrategy",
+  "portfolioSiteArchitecture",
+  "portfolioDesignSystem",
+  "portfolioFeatureSpotlight",
+  "portfolioGallery",
+  "portfolioVideo",
+  "portfolioTechStack",
+  // proof
+  "portfolioPerformance",
+  "portfolioSpeedComparison",
+  // outcome
+  "portfolioResults",
+  "portfolioMetricsTimeline",
+  "portfolioConversionFunnel",
+  "portfolioServices",
+  "portfolioTeam",
+  "portfolioTestimonial",
+  "portfolioDetails",
+  // outside the story
+  "portfolioSeo",
+  "portfolioCTA"
+];
+function isPortfolioSectionType(value) {
+  return typeof value === "string" && PORTFOLIO_SECTION_TYPES.includes(value);
+}
+var SECTION_STAGE = {
+  portfolioHero: null,
+  portfolioChallenges: "problem",
+  portfolioBeforeAfter: "problem",
+  portfolioStrategy: "build",
+  portfolioSiteArchitecture: "build",
+  portfolioDesignSystem: "build",
+  portfolioFeatureSpotlight: "build",
+  portfolioGallery: "build",
+  portfolioVideo: "build",
+  portfolioTechStack: "build",
+  portfolioPerformance: "proof",
+  portfolioSpeedComparison: "proof",
+  portfolioResults: "outcome",
+  portfolioMetricsTimeline: "outcome",
+  portfolioConversionFunnel: "outcome",
+  portfolioServices: "outcome",
+  portfolioTeam: "outcome",
+  portfolioTestimonial: "outcome",
+  portfolioDetails: "outcome",
+  portfolioSeo: null,
+  portfolioCTA: null
+};
+function sectionStage(type) {
+  return isPortfolioSectionType(type) ? SECTION_STAGE[type] : null;
+}
+var STAGE_CORE_SECTION = {
+  problem: "portfolioChallenges",
+  build: "portfolioStrategy",
+  proof: "portfolioPerformance",
+  outcome: "portfolioResults"
+};
+var PORTFOLIO_SECTION_ORDER = Object.fromEntries(
+  PORTFOLIO_SECTION_TYPES.map((type, i) => [type, i])
+);
+var UNKNOWN_SECTION_ORDER = PORTFOLIO_SECTION_TYPES.length;
+function sectionOrder(type) {
+  return isPortfolioSectionType(type) ? PORTFOLIO_SECTION_ORDER[type] : UNKNOWN_SECTION_ORDER;
+}
+function stageOrder(type) {
+  if (type === "portfolioHero") return -1;
+  const stage = sectionStage(type);
+  return stage ? CASE_STUDY_STAGES.indexOf(stage) : CASE_STUDY_STAGES.length;
+}
+function orderSections(sections, options = {}) {
+  const list = [...sections ?? []];
+  const byStage = list.map((section, index) => ({ section, index }));
+  byStage.sort((a, b) => {
+    const stage = stageOrder(a.section.sectionType) - stageOrder(b.section.sectionType);
+    if (stage !== 0) return stage;
+    if (options.sectionsOrdered) return a.index - b.index;
+    const order = sectionOrder(a.section.sectionType) - sectionOrder(b.section.sectionType);
+    return order !== 0 ? order : a.index - b.index;
+  });
+  return byStage.map((s) => s.section);
+}
+function groupSectionsByStage(sections, options = {}) {
+  const ordered = orderSections(sections, options);
+  const groups = [];
+  for (const stage of CASE_STUDY_STAGES) {
+    const own = ordered.filter((s) => sectionStage(s.sectionType) === stage);
+    if (own.length) groups.push({ stage, index: groups.length + 1, sections: own });
+  }
+  return groups;
+}
+var STAGE_MISSING_COPY = {
+  problem: {
+    empty: "Nothing says what the client came in with. Add the challenges.",
+    noCore: "The problem is pictured but not stated. Add the challenges."
+  },
+  build: {
+    empty: "Nothing says what was planned or built. Add the strategy.",
+    noCore: "The build is shown but the plan behind it is missing. Add the strategy."
+  },
+  proof: {
+    empty: "Nothing measures the finished build. Add a performance measurement.",
+    noCore: "The old site is compared but the finished build has no measurement of its own. Add a performance measurement."
+  },
+  outcome: {
+    empty: "Nothing says what the work is doing for the client. Add the results.",
+    noCore: "The outcome has supporting sections but no results. Add the results."
+  }
+};
+function caseStudyStageStatus(sections) {
+  const ordered = orderSections(sections);
+  return CASE_STUDY_STAGES.map((stage) => {
+    const present = ordered.map((s) => s.sectionType).filter((t) => isPortfolioSectionType(t) && SECTION_STAGE[t] === stage);
+    const complete = present.includes(STAGE_CORE_SECTION[stage]);
+    const copy = STAGE_MISSING_COPY[stage];
+    return {
+      stage,
+      present,
+      complete,
+      missing: complete ? null : present.length ? copy.noCore : copy.empty
+    };
+  });
+}
+var NARRATIVE_MAX_CHARS = 320;
+function narrativeProblems(narrative) {
+  if (narrative === void 0 || narrative === null) return [];
+  if (typeof narrative !== "object") return ["narrative must be an object"];
+  const problems = [];
+  const n = narrative;
+  if (typeof n.thesis !== "string" || !n.thesis.trim()) problems.push("narrative.thesis is required");
+  else if (n.thesis.length > NARRATIVE_MAX_CHARS) problems.push(`narrative.thesis is over ${NARRATIVE_MAX_CHARS} characters`);
+  if (n.stages === void 0 || n.stages === null) return problems;
+  if (typeof n.stages !== "object") return [...problems, "narrative.stages must be an object"];
+  for (const [stage, lede] of Object.entries(n.stages)) {
+    if (!CASE_STUDY_STAGES.includes(stage)) {
+      problems.push(`narrative.stages.${stage} is not a stage (${CASE_STUDY_STAGES.join(", ")})`);
+      continue;
+    }
+    if (lede === void 0 || lede === null) continue;
+    if (typeof lede !== "string") problems.push(`narrative.stages.${stage} must be text`);
+    else if (lede.length > NARRATIVE_MAX_CHARS) problems.push(`narrative.stages.${stage} is over ${NARRATIVE_MAX_CHARS} characters`);
+  }
+  return problems;
+}
+var CASE_STUDY_NARRATIVE_JSON_SCHEMA = {
+  $schema: "http://json-schema.org/draft-07/schema#",
+  $id: "https://sonor.io/schemas/case-study-narrative.v1.json",
+  title: "CaseStudyNarrative",
+  description: "The thesis of a case study and the lede that opens each of its four stages.",
+  type: "object",
+  required: ["thesis"],
+  properties: {
+    thesis: { type: "string", minLength: 1, maxLength: NARRATIVE_MAX_CHARS },
+    stages: {
+      type: "object",
+      properties: Object.fromEntries(
+        CASE_STUDY_STAGES.map((stage) => [stage, { type: "string", maxLength: NARRATIVE_MAX_CHARS }])
+      ),
+      additionalProperties: false
+    }
+  },
+  additionalProperties: false
+};
+function challengeId(position) {
+  return `c${position}`;
+}
+function caseStudyFlowProblems(input) {
+  const challenges = input.challenges ?? [];
+  const ids = challenges.map((c) => typeof c.id === "string" && c.id.trim() ? c.id.trim() : null);
+  if (!ids.some(Boolean)) return [];
+  const problems = [];
+  const known = new Set(ids.filter((id) => !!id));
+  if (known.size !== ids.filter(Boolean).length) problems.push("two challenges share an id");
+  ids.forEach((id, i) => {
+    if (!id) problems.push(`challenge ${i + 1} has no id while the others do`);
+  });
+  const resolved = /* @__PURE__ */ new Set();
+  const proven = /* @__PURE__ */ new Set();
+  for (const phase of input.phases ?? []) {
+    for (const ref of phase.resolves ?? []) {
+      if (!known.has(ref)) problems.push(`a strategy phase resolves "${ref}", which is not a challenge`);
+      else resolved.add(ref);
+    }
+  }
+  for (const result of input.results ?? []) {
+    for (const ref of result.proves ?? []) {
+      if (!known.has(ref)) problems.push(`a result proves "${ref}", which is not a challenge`);
+      else proven.add(ref);
+    }
+  }
+  const nameOf = (id) => {
+    const c = challenges.find((x) => x.id === id);
+    return c?.title?.trim() ? `"${c.title.trim()}"` : id;
+  };
+  for (const id of known) {
+    if (!resolved.has(id)) problems.push(`no strategy phase resolves challenge ${nameOf(id)}`);
+    if (!proven.has(id)) problems.push(`no result proves challenge ${nameOf(id)}`);
+  }
+  return problems;
+}
+var LIGHTHOUSE_RE = /lighthouse/i;
+function isLighthouseKpi(kpi) {
+  return LIGHTHOUSE_RE.test(kpi.label || "");
+}
+function curateHeroKpis(kpis) {
+  const business = kpis.filter((k) => !isLighthouseKpi(k));
+  const lighthouse = kpis.filter(isLighthouseKpi);
+  if (lighthouse.length <= 1) return kpis;
+  const allPerfect = lighthouse.length >= 4 && lighthouse.every((k) => k.value === 100);
+  const summary = allPerfect ? {
+    ...lighthouse[0],
+    label: "Lighthouse, all 4 categories",
+    description: "Perfect scores across performance, SEO, accessibility, and best practices."
+  } : lighthouse.find((k) => /performance/i.test(k.label)) ?? lighthouse[0];
+  return [...business, summary];
+}
+var PORTFOLIO_KPI_JSON_SCHEMA = {
+  $schema: "http://json-schema.org/draft-07/schema#",
+  $id: "https://sonor.io/schemas/portfolio-kpi.v1.json",
+  title: "KpiLike",
+  description: "The subset of a portfolio KPI tile the Lighthouse-collapse policy reads.",
+  type: "object",
+  required: ["label", "value"],
+  properties: {
+    label: { type: "string" },
+    value: { type: "number" },
+    description: { type: "string" },
+    source: { enum: ["measured", "reported", "estimated"] },
+    reportedBy: {
+      type: "object",
+      required: ["name", "organization", "date"],
+      properties: {
+        name: { type: "string", minLength: 1 },
+        role: { type: "string" },
+        organization: { type: "string", minLength: 1 },
+        date: { type: "string", pattern: "^\\d{4}-\\d{2}-\\d{2}$" }
+      }
+    }
+  },
+  // A reported number is only valid with someone named behind it.
+  if: { properties: { source: { const: "reported" } }, required: ["source"] },
+  then: { required: ["reportedBy"] },
+  additionalProperties: true
+};
+var METRIC_SOURCES = ["measured", "reported", "estimated"];
+var ISO_DAY_RE = /^\d{4}-\d{2}-\d{2}$/;
+var MONTHS = [
+  "January",
+  "February",
+  "March",
+  "April",
+  "May",
+  "June",
+  "July",
+  "August",
+  "September",
+  "October",
+  "November",
+  "December"
+];
+function isMetricSource(value) {
+  return typeof value === "string" && METRIC_SOURCES.includes(value);
+}
+function metricSourceProblem(metric) {
+  if (metric.source === void 0 || metric.source === null) return null;
+  if (!isMetricSource(metric.source)) return `source must be one of ${METRIC_SOURCES.join(", ")}`;
+  if (metric.source !== "reported") return null;
+  const by = metric.reportedBy;
+  if (!by || typeof by !== "object") {
+    return "a reported number needs reportedBy: who reported it, where they work, and when";
+  }
+  if (typeof by.name !== "string" || !by.name.trim()) return "reportedBy.name is required";
+  if (typeof by.organization !== "string" || !by.organization.trim()) {
+    return "reportedBy.organization is required";
+  }
+  if (typeof by.date !== "string" || !ISO_DAY_RE.test(by.date) || Number.isNaN(Date.parse(by.date))) {
+    return "reportedBy.date must be a real day, YYYY-MM-DD";
+  }
+  if (by.role !== void 0 && typeof by.role !== "string") return "reportedBy.role must be text";
+  return null;
+}
+function isHeadlineMetric(metric) {
+  if (metric.source === "measured") return true;
+  return metric.source === "reported" && metricSourceProblem(metric) === null;
+}
+function metricSourceLabel(source) {
+  if (source === "measured") return "Measured";
+  if (source === "reported") return "Client-reported";
+  if (source === "estimated") return "Estimated";
+  return null;
+}
+function formatAttribution(by) {
+  const [year, month, day] = by.date.split("-").map(Number);
+  const when = MONTHS[month - 1] ? `${MONTHS[month - 1]} ${day}, ${year}` : by.date;
+  return [`Reported by ${by.name.trim()}`, by.role?.trim(), by.organization.trim(), when].filter(Boolean).join(", ");
+}
+function shortAttribution(by) {
+  return `per ${by.organization.trim()}`;
+}
+function carryReportedMetrics(previous, next, keyOf) {
+  const norm = (metric) => String(keyOf(metric) ?? "").trim().toLowerCase();
+  const reported = (previous ?? []).filter((m) => m?.source === "reported");
+  const taken = new Set(reported.map(norm));
+  const generated = (next ?? []).filter((m) => m && m.source !== "reported" && !taken.has(norm(m)));
+  return [...reported, ...generated];
+}
+
+export { CASE_STUDY_NARRATIVE_JSON_SCHEMA, CASE_STUDY_STAGES, CASE_STUDY_STAGE_COPY, FRAME_READY_MESSAGE, METRIC_SOURCES, NARRATIVE_MAX_CHARS, PORTFOLIO_CONTRACT_VERSION, PORTFOLIO_KPI_JSON_SCHEMA, PORTFOLIO_SECTION_ORDER, PORTFOLIO_SECTION_TYPES, SECTION_STAGE, STAGE_CORE_SECTION, STAGE_NAME_MAX_CHARS, carryReportedMetrics, caseStudyFlowProblems, caseStudyStageStatus, challengeId, curateHeroKpis, formatAttribution, groupSectionsByStage, isFrameReadyMessage, isHeadlineMetric, isLighthouseKpi, isMetricSource, isPortfolioSectionType, metricSourceLabel, metricSourceProblem, narrativeProblems, orderSections, sectionStage, shortAttribution, stageName, stageNamesProblems };