@sonordev/site-kit 8.0.1 → 8.2.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @sonordev/site-kit Changelog
 
+## 8.2.0
+
+- Article photo placement uses the same pure contract as Sonor's editor and preview: exact section anchors, missing prose diagnostics, duplicate detection, and independent website placement.
+- A saved heading ID keeps its image attached when that heading's wording changes; stale anchors are skipped rather than guessed.
+
+
+## 8.1.0
+
+- **Supporting article photos.** The default `Article` server component places approved photo snapshots after the introduction or the opening paragraph of an exact section heading. Figures include descriptions, optional credit captions, intrinsic dimensions, and lazy loading. Missing or ambiguous headings are skipped; existing inline images aren't duplicated. Older articles render unchanged.
+- **Custom publications and feeds.** `insertArticlePhotos`, `articlePhotoCss`, and `ArticleEditorialPhoto` are exported from the article entries. Custom renderers can apply the same placement contract to their HTML. RSS and Atom include the approved photos; the public `get_article` MCP tool exposes their descriptions and placements without private planning data.
+- **Sonor owns the photo plan.** The authenticated app and MCP save source selection, image briefs, focal points, and readiness. Sites consume only `editorial_photos` from the public article response. This release doesn't add public write tools.
+
 ## 8.0.1
 
 - **`server-only` is a dependency.** The entries that run only on the server (`@sonordev/site-kit/server`, `/seo/server`, `/forms/server` and the others that import the `server-only` marker) didn't list it. A Next build never noticed, because Next supplies its own copy, but a Node script or a test that imported one of those entries from a pnpm install failed with `ERR_MODULE_NOT_FOUND`. site-kit now depends on `server-only` ^0.0.1, so the import resolves anywhere. Inside a build Next still uses its own copy, so nothing changes for a site. Outside Next, load a server entry under the `react-server` condition (`node --conditions=react-server`), the way a server component loads it; without that condition, `server-only` stops the import on purpose.

package/agent-manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "package": "@sonordev/site-kit",
-  "version": "8.0.1",
+  "version": "8.2.0",
   "description": "Machine-readable manifest for coding agents integrating a site with Sonor. See AGENTS.md (shipped) and docs/SITE-KIT-AGENT-NATIVE.md.",
   "env": {
     "required": [

package/dist/{AnalyticsProvider-EGCZ2MVM.js → AnalyticsProvider-6TAA3XYB.js}

@@ -1,4 +1,4 @@
-export { AnalyticsProvider, useAnalytics, useAnalyticsOptional, useTrackEvent } from './chunk-OCKGB734.js';
+export { AnalyticsProvider, useAnalytics, useAnalyticsOptional, useTrackEvent } from './chunk-EBILJHUF.js';
 import './chunk-LCDVPAMR.js';
 import './chunk-ZKADJNR2.js';
 import './chunk-L2V5PUFN.js';
@@ -7,7 +7,7 @@ import './chunk-GJWI74ZZ.js';
 import './chunk-CAH4Y4PY.js';
 import './chunk-EKBEOXTH.js';
 import './chunk-3G7YABRA.js';
-import './chunk-55JLUMAC.js';
-import './chunk-IY6G67EF.js';
-import './chunk-S5G3A7OZ.js';
+import './chunk-727R7C5R.js';
+import './chunk-3EU6S5YC.js';
+import './chunk-Q72M5KBS.js';
 import './chunk-PKBMQBKP.js';

package/dist/{ArticleViewTracker-ATNVMT45.js → ArticleViewTracker-H4N7YCLC.js}

@@ -4,9 +4,9 @@ import { withSiteBody } from './chunk-MJP63SSS.js';
 import './chunk-FESKKJAS.js';
 import './chunk-A4CC4ZG3.js';
 import { readPublishedApiConfig } from './chunk-3G7YABRA.js';
-import { sonorFetch } from './chunk-55JLUMAC.js';
-import './chunk-IY6G67EF.js';
-import './chunk-S5G3A7OZ.js';
+import { sonorFetch } from './chunk-727R7C5R.js';
+import './chunk-3EU6S5YC.js';
+import './chunk-Q72M5KBS.js';
 import './chunk-PKBMQBKP.js';
 import { useEffect } from 'react';
 

package/dist/{BlocksPopup-F636XNO4.js → BlocksPopup-FJT5YQD3.js}

@@ -1,14 +1,14 @@
 'use client';
-import { getSiteDesignTokens } from './chunk-J6N5DCGW.js';
+import { getSiteDesignTokens } from './chunk-WBC5B3JD.js';
 import { DEFAULT_POPUP_TOKENS, PopupBlocks } from './chunk-BF7TZYC3.js';
 import { normalizePopupBlocks, toHexColor, readableOn } from './chunk-IHG36STL.js';
 import './chunk-S22FSH7C.js';
 import './chunk-CAH4Y4PY.js';
 import './chunk-EKBEOXTH.js';
 import './chunk-3G7YABRA.js';
-import './chunk-55JLUMAC.js';
-import './chunk-IY6G67EF.js';
-import './chunk-S5G3A7OZ.js';
+import './chunk-727R7C5R.js';
+import './chunk-3EU6S5YC.js';
+import './chunk-Q72M5KBS.js';
 import './chunk-PKBMQBKP.js';
 import { useState } from 'react';
 import { jsx } from 'react/jsx-runtime';

package/dist/{ChatWidget-EQTLKPJX.js → ChatWidget-THQHHTAA.js}

@@ -1,8 +1,8 @@
-export { ChatWidget, EchoChat, isChatEnabled } from './chunk-B7QRRLTU.js';
+export { ChatWidget, EchoChat, isChatEnabled } from './chunk-FVXFLVXF.js';
 import './chunk-6T6CQVNL.js';
 import './chunk-JE4A5S4F.js';
 import './chunk-27FISYK4.js';
-import './chunk-3222QBUS.js';
+import './chunk-YBAFUM3Z.js';
 import './chunk-Q6E4OPGG.js';
 import './chunk-5ROTTMBL.js';
 import './chunk-C2FZBUSS.js';
@@ -14,7 +14,7 @@ import './chunk-L2V5PUFN.js';
 import './chunk-5TM3WPCI.js';
 import './chunk-GJWI74ZZ.js';
 import './chunk-3G7YABRA.js';
-import './chunk-55JLUMAC.js';
-import './chunk-IY6G67EF.js';
-import './chunk-S5G3A7OZ.js';
+import './chunk-727R7C5R.js';
+import './chunk-3EU6S5YC.js';
+import './chunk-Q72M5KBS.js';
 import './chunk-PKBMQBKP.js';

package/dist/{FileField-BUD2YGN5.js → FileField-OZXXJGUM.js}

@@ -1,8 +1,8 @@
 'use client';
 import { getClientApiConfig } from './chunk-3G7YABRA.js';
-import { sonorFetch } from './chunk-55JLUMAC.js';
-import './chunk-IY6G67EF.js';
-import './chunk-S5G3A7OZ.js';
+import { sonorFetch } from './chunk-727R7C5R.js';
+import './chunk-3EU6S5YC.js';
+import './chunk-Q72M5KBS.js';
 import './chunk-PKBMQBKP.js';
 import React from 'react';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';

package/dist/{FormSpotlight-NGH56TGC.js → FormSpotlight-MLDJS246.js}

@@ -1,6 +1,6 @@
 'use client';
 import { StageStyles, SummaryTick } from './chunk-3YKQLC7J.js';
-import { stageFirstName, useFieldControls, stageViews, stageEstimate, AUTO_ADVANCE_TYPES } from './chunk-JCFQGEG7.js';
+import { stageFirstName, useFieldControls, stageViews, stageEstimate, AUTO_ADVANCE_TYPES } from './chunk-JC2VS2SB.js';
 import { readAgentSubmit, formToolAttributes } from './chunk-Q6E4OPGG.js';
 import { isEmptyValue, unseenControlValues, isDisplayOnly } from './chunk-C2FZBUSS.js';
 import { FormField } from './chunk-TYAVHRWH.js';

package/dist/{FormStage-XZRC54SY.js → FormStage-6RVY7M3R.js}

@@ -1,6 +1,6 @@
 'use client';
 import { StageStyles, SummaryTick } from './chunk-3YKQLC7J.js';
-import { useFieldControls, stageViews, stageFirstName, stageEstimate, formatAnswer, AUTO_ADVANCE_TYPES } from './chunk-JCFQGEG7.js';
+import { useFieldControls, stageViews, stageFirstName, stageEstimate, formatAnswer, AUTO_ADVANCE_TYPES } from './chunk-JC2VS2SB.js';
 import { readAgentSubmit, formToolAttributes } from './chunk-Q6E4OPGG.js';
 import { isEmptyValue, unseenControlValues } from './chunk-C2FZBUSS.js';
 import { FormField } from './chunk-TYAVHRWH.js';

package/dist/{ManagedForm-CQDQ4CUN.js → ManagedForm-3VV54RVH.js}

@@ -1,6 +1,6 @@
-export { ManagedForm } from './chunk-7BSC6HF3.js';
-import './chunk-JCFQGEG7.js';
-import './chunk-3222QBUS.js';
+export { ManagedForm } from './chunk-GWP2VBFH.js';
+import './chunk-JC2VS2SB.js';
+import './chunk-YBAFUM3Z.js';
 import './chunk-Q6E4OPGG.js';
 import './chunk-5ROTTMBL.js';
 import './chunk-C2FZBUSS.js';
@@ -13,7 +13,7 @@ import './chunk-L2V5PUFN.js';
 import './chunk-5TM3WPCI.js';
 import './chunk-GJWI74ZZ.js';
 import './chunk-3G7YABRA.js';
-import './chunk-55JLUMAC.js';
-import './chunk-IY6G67EF.js';
-import './chunk-S5G3A7OZ.js';
+import './chunk-727R7C5R.js';
+import './chunk-3EU6S5YC.js';
+import './chunk-Q72M5KBS.js';
 import './chunk-PKBMQBKP.js';

package/dist/{ManagedNewsletterForm-KCN3BTKA.js → ManagedNewsletterForm-RTJDGMGG.js}

@@ -1,4 +1,4 @@
-import { useForm } from './chunk-3222QBUS.js';
+import { useForm } from './chunk-YBAFUM3Z.js';
 import './chunk-Q6E4OPGG.js';
 import './chunk-5ROTTMBL.js';
 import './chunk-C2FZBUSS.js';
@@ -11,9 +11,9 @@ import './chunk-L2V5PUFN.js';
 import './chunk-5TM3WPCI.js';
 import './chunk-GJWI74ZZ.js';
 import './chunk-3G7YABRA.js';
-import './chunk-55JLUMAC.js';
-import './chunk-IY6G67EF.js';
-import './chunk-S5G3A7OZ.js';
+import './chunk-727R7C5R.js';
+import './chunk-3EU6S5YC.js';
+import './chunk-Q72M5KBS.js';
 import './chunk-PKBMQBKP.js';
 import { jsx } from 'react/jsx-runtime';
 

package/dist/{SignalCore-RDQPM2L2.js → SignalCore-T7ZOCA44.js}

@@ -4,9 +4,9 @@ import { onPageLeave } from './chunk-L2V5PUFN.js';
 import './chunk-5TM3WPCI.js';
 import './chunk-GJWI74ZZ.js';
 import { getClientApiConfig } from './chunk-3G7YABRA.js';
-import { sonorFetch } from './chunk-55JLUMAC.js';
-import { getFreshCredential, isSiteToken } from './chunk-IY6G67EF.js';
-import './chunk-S5G3A7OZ.js';
+import { sonorFetch } from './chunk-727R7C5R.js';
+import { getFreshCredential, isSiteToken } from './chunk-3EU6S5YC.js';
+import './chunk-Q72M5KBS.js';
 import './chunk-PKBMQBKP.js';
 import { useState, useRef, useEffect, useCallback } from 'react';
 

package/dist/{SiteChat-QBDOQ5ZZ.js → SiteChat-JSHPGAE3.js}

@@ -1,4 +1,4 @@
-export { SiteChat } from './chunk-AGJODJ4V.js';
+export { SiteChat } from './chunk-NNEIBXGU.js';
 import './chunk-27FISYK4.js';
 import './chunk-CAH4Y4PY.js';
 import './chunk-EKBEOXTH.js';

package/dist/{SiteDesignReporter-426TUCUF.js → SiteDesignReporter-L2JBAKKK.js}

@@ -1,12 +1,12 @@
-export { SiteDesignReporter } from './chunk-CAF53GKN.js';
-import './chunk-J6N5DCGW.js';
+export { SiteDesignReporter } from './chunk-H4R2GPAB.js';
+import './chunk-WBC5B3JD.js';
 import './chunk-IHG36STL.js';
 import './chunk-YC7ELZS3.js';
 import './chunk-S22FSH7C.js';
 import './chunk-CAH4Y4PY.js';
 import './chunk-EKBEOXTH.js';
 import './chunk-3G7YABRA.js';
-import './chunk-55JLUMAC.js';
-import './chunk-IY6G67EF.js';
-import './chunk-S5G3A7OZ.js';
+import './chunk-727R7C5R.js';
+import './chunk-3EU6S5YC.js';
+import './chunk-Q72M5KBS.js';
 import './chunk-PKBMQBKP.js';

package/dist/{SitePopups-KLUD6XIE.js → SitePopups-K6ADAWFK.js}

@@ -1,4 +1,4 @@
-export { SitePopups } from './chunk-NKFRW2VB.js';
+export { SitePopups } from './chunk-JBEUZJS3.js';
 import './chunk-27FISYK4.js';
 import './chunk-5ROTTMBL.js';
 import './chunk-ZKADJNR2.js';
@@ -7,7 +7,7 @@ import './chunk-GJWI74ZZ.js';
 import './chunk-CAH4Y4PY.js';
 import './chunk-EKBEOXTH.js';
 import './chunk-3G7YABRA.js';
-import './chunk-55JLUMAC.js';
-import './chunk-IY6G67EF.js';
-import './chunk-S5G3A7OZ.js';
+import './chunk-727R7C5R.js';
+import './chunk-3EU6S5YC.js';
+import './chunk-Q72M5KBS.js';
 import './chunk-PKBMQBKP.js';

package/dist/{SitemapSync-QOIMV5GO.js → SitemapSync-VV2YSMIW.js}

@@ -1,9 +1,9 @@
-export { SitemapSync } from './chunk-FIGIJK5F.js';
+export { SitemapSync } from './chunk-WK3N3Y7V.js';
 import './chunk-YVKRYQRG.js';
 import './chunk-CAH4Y4PY.js';
 import './chunk-EKBEOXTH.js';
 import './chunk-3G7YABRA.js';
-import './chunk-55JLUMAC.js';
-import './chunk-IY6G67EF.js';
-import './chunk-S5G3A7OZ.js';
+import './chunk-727R7C5R.js';
+import './chunk-3EU6S5YC.js';
+import './chunk-Q72M5KBS.js';
 import './chunk-PKBMQBKP.js';

package/dist/_client/booking-widget.js

@@ -1,8 +1,8 @@
 'use client';
-export { BookingWidget, BookingWidget_default as default } from '../chunk-Z6PVFZRI.js';
-import '../chunk-YGXWG54S.js';
+export { BookingWidget, BookingWidget_default as default } from '../chunk-66G47P5C.js';
+import '../chunk-XWIRU6UT.js';
 import '../chunk-3G7YABRA.js';
-import '../chunk-55JLUMAC.js';
-import '../chunk-IY6G67EF.js';
-import '../chunk-S5G3A7OZ.js';
+import '../chunk-727R7C5R.js';
+import '../chunk-3EU6S5YC.js';
+import '../chunk-Q72M5KBS.js';
 import '../chunk-PKBMQBKP.js';

package/dist/affiliates/index.js

@@ -1,8 +1,8 @@
 'use client';
 import { getClientApiConfig } from '../chunk-3G7YABRA.js';
-import { sonorFetch } from '../chunk-55JLUMAC.js';
-import '../chunk-IY6G67EF.js';
-import '../chunk-S5G3A7OZ.js';
+import { sonorFetch } from '../chunk-727R7C5R.js';
+import '../chunk-3EU6S5YC.js';
+import '../chunk-Q72M5KBS.js';
 import '../chunk-PKBMQBKP.js';
 import { useState, useEffect } from 'react';
 import { jsx, jsxs } from 'react/jsx-runtime';

package/dist/analytics/index.js

@@ -1,5 +1,5 @@
 'use client';
-export { AnalyticsProvider, WebVitals, useAnalytics, useAnalyticsOptional, useTrackEvent } from '../chunk-OCKGB734.js';
+export { AnalyticsProvider, WebVitals, useAnalytics, useAnalyticsOptional, useTrackEvent } from '../chunk-EBILJHUF.js';
 import { trackConversion } from '../chunk-LCDVPAMR.js';
 export { trackConversion, trackEvent } from '../chunk-LCDVPAMR.js';
 import '../chunk-ZKADJNR2.js';
@@ -9,9 +9,9 @@ import '../chunk-GJWI74ZZ.js';
 export { isCrossOriginFrame, isFramed, isTopFrameSameOrigin } from '../chunk-CAH4Y4PY.js';
 import '../chunk-EKBEOXTH.js';
 import '../chunk-3G7YABRA.js';
-import '../chunk-55JLUMAC.js';
-import '../chunk-IY6G67EF.js';
-import '../chunk-S5G3A7OZ.js';
+import '../chunk-727R7C5R.js';
+import '../chunk-3EU6S5YC.js';
+import '../chunk-Q72M5KBS.js';
 import '../chunk-PKBMQBKP.js';
 import { useCallback, useEffect } from 'react';
 

package/dist/{article-styles-6CM5FUMV.js → article-styles-GFXJJDLE.js}

@@ -1,3 +1,4 @@
+import { articlePhotoCss } from './chunk-HUBMKTPW.js';
 import { articleTableCss } from './chunk-Y3INC4QJ.js';
 import './chunk-PKBMQBKP.js';
 
@@ -6,6 +7,7 @@ var articleCss = (
   /* css */
   `
 ${articleTableCss}
+${articlePhotoCss}
 /* ===== Layout ===== */
 .sk-article {
   --_sk-primary: var(--sk-primary, #2563eb);

package/dist/articles/article-photos.d.ts

@@ -0,0 +1,9 @@
+import type { ArticleEditorialPhoto } from './types';
+/**
+ * Inserts approved public photo snapshots at explicitly authored placements.
+ * Missing/duplicate headings, unmatched sections and photos already in the body
+ * are skipped. Never changes the author's paragraphs, headings or other markup.
+ * This is a layout transform, not a sanitizer for the original article HTML.
+ */
+export declare function insertArticlePhotos(html: string, photos?: ArticleEditorialPhoto[] | null): string;
+export declare const articlePhotoCss = "\n.sk-article-photo { margin: 2em 0; max-width: 100%; }\n.sk-article-photo img { display: block; width: 100%; max-width: 100%; height: auto; border-radius: var(--sk-radius, 0.75rem); }\n.sk-article-photo figcaption { margin-top: 0.65em; color: var(--sk-text-secondary, inherit); font-size: 0.875em; line-height: 1.5; overflow-wrap: anywhere; }\n";

package/dist/articles/index.d.ts

@@ -51,6 +51,7 @@ export { TableOfContents } from './TableOfContents';
 export { ServiceCallout, ServiceCallouts } from './ServiceCallout';
 export type { ServiceCalloutProps } from './ServiceCallout';
 export { ArticleFAQ } from './ArticleFAQ';
+export type { ArticleEditorialPhoto } from './types';
 export type { ArticleFAQProps, FaqItem } from './ArticleFAQ';
 export { ClusterNavigation } from './ClusterNavigation';
 export type { ClusterNavigationProps } from './ClusterNavigation';

package/dist/articles/index.js

@@ -15,7 +15,7 @@ import '../chunk-PKBMQBKP.js';
 import React, { useState, Suspense, useEffect } from 'react';
 import { jsx, jsxs } from 'react/jsx-runtime';
 
-var ManagedNewsletterForm = React.lazy(() => import('../ManagedNewsletterForm-KCN3BTKA.js'));
+var ManagedNewsletterForm = React.lazy(() => import('../ManagedNewsletterForm-RTJDGMGG.js'));
 function NewsletterWidget({
   title = "Subscribe to Our Newsletter",
   description = "Get the latest posts delivered straight to your inbox.",

package/dist/articles/server-core.d.ts

@@ -455,5 +455,7 @@ export { articleCategorySlug, createPublicationRoutes, resolveArticleUrl, resolv
 export type { ArticleRoutePost, PublicationRoutingOptions } from './routes';
 export { resolveArticleArtwork } from './artwork';
 export { wrapArticleTables, articleTableCss } from './article-tables';
+export { insertArticlePhotos, articlePhotoCss } from './article-photos';
+export type { ArticleEditorialPhoto } from './types';
 export { FEED_DEFAULT_ITEMS, NEWS_SITEMAP_MAX_URLS, NEWS_SITEMAP_WINDOW_MS, buildNewsSitemapXml, cdata, recentNewsPosts } from './news-sitemap';
 export type { NewsSitemapOptions, NewsSitemapPost } from './news-sitemap';

package/dist/articles/server-ui.d.ts

@@ -26,3 +26,5 @@ export { articleCategorySlug, createPublicationRoutes, resolveArticleUrl, resolv
 export type { ArticleRoutePost, PublicationRoutingOptions } from './routes';
 export { resolveArticleArtwork } from './artwork';
 export { wrapArticleTables, articleTableCss } from './article-tables';
+export { insertArticlePhotos, articlePhotoCss } from './article-photos';
+export type { ArticleEditorialPhoto } from './types';

package/dist/articles/server-ui.js

@@ -2,7 +2,9 @@ import { readingTimeMinutes, ServiceCallouts, ClusterNavigation, getAuthorSocial
 export { ClusterNavigation } from '../chunk-FV2VD7WM.js';
 import { widgetStyle, widgetTitleStyle } from '../chunk-GYF2ULVO.js';
 import { resolvePublicationSiteUrl, addExternalLinkTargets } from '../chunk-L5UOHS6E.js';
-import { fetchArticleBySlug, fetchRelatedArticles, fetchArticleCategories, getTopicCluster } from '../chunk-XPTJRVL2.js';
+import { fetchArticleBySlug, fetchRelatedArticles, fetchArticleCategories, getTopicCluster } from '../chunk-FQUGGPBM.js';
+import { insertArticlePhotos } from '../chunk-HUBMKTPW.js';
+export { articlePhotoCss, insertArticlePhotos } from '../chunk-HUBMKTPW.js';
 export { articleTableCss, wrapArticleTables } from '../chunk-Y3INC4QJ.js';
 import { resolveArticleArtwork, articleArtworkImageStyle } from '../chunk-QXMIKDOL.js';
 export { resolveArticleArtwork } from '../chunk-QXMIKDOL.js';
@@ -107,7 +109,7 @@ async function Article({
   }
   const [post, { articleCss }, { wrapArticleTables: wrapArticleTables2 }] = await Promise.all([
     fetchArticleBySlug({ apiUrl, apiKey, site }, slug),
-    unstyled ? Promise.resolve({ articleCss: "" }) : import('../article-styles-6CM5FUMV.js'),
+    unstyled ? Promise.resolve({ articleCss: "" }) : import('../article-styles-GFXJJDLE.js'),
     import('../article-tables-AXSZOGNW.js')
   ]);
   if (!post) {
@@ -124,7 +126,7 @@ async function Article({
   const rawContent = post.content_html || post.content || "";
   const content = ensureHtml(rawContent);
   const siteUrlResolved = resolvePublicationSiteUrl(siteUrl);
-  const contentWithExternalTargets = wrapArticleTables2(addExternalLinkTargets(content, siteUrlResolved));
+  const contentWithExternalTargets = wrapArticleTables2(addExternalLinkTargets(insertArticlePhotos(content, post.editorial_photos), siteUrlResolved));
   const artwork = resolveArticleArtwork(post, "article");
   const tableOfContents = showToc ? generateTableOfContents(content) : [];
   const relatedPosts = showRelated ? await fetchRelatedArticles({ apiUrl, apiKey, site }, post.id, relatedCount, { revalidate: 300 }) : [];
@@ -133,7 +135,7 @@ async function Article({
     ...item,
     answer: addExternalLinkTargets(item.answer || "", siteUrlResolved)
   })) ?? faqRaw;
-  const { ArticleViewTracker } = await import('../ArticleViewTracker-ATNVMT45.js');
+  const { ArticleViewTracker } = await import('../ArticleViewTracker-H4N7YCLC.js');
   if (children) {
     return /* @__PURE__ */ jsxs(Fragment, { children: [
       /* @__PURE__ */ jsx(ArticleViewTracker, { slug: post.slug, site }),
@@ -407,7 +409,7 @@ async function ArticleList({
   const [articleData, categories, { articleListCss }] = await Promise.all([
     fetchArticleList({ apiUrl, apiKey, category, tag, author, featured, search, cluster, page, perPage, orderBy, order, site }),
     showCategoryFilter ? fetchArticleCategories({ apiUrl, apiKey, site }) : Promise.resolve([]),
-    unstyled || children ? Promise.resolve({ articleListCss: "" }) : import('../article-styles-6CM5FUMV.js')
+    unstyled || children ? Promise.resolve({ articleListCss: "" }) : import('../article-styles-GFXJJDLE.js')
   ]);
   if (children) {
     return children({ posts: articleData.posts, pagination: articleData.pagination, categories });

package/dist/articles/server.d.ts

@@ -455,5 +455,7 @@ export { articleCategorySlug, createPublicationRoutes, resolveArticleUrl, resolv
 export type { ArticleRoutePost, PublicationRoutingOptions } from './routes';
 export { resolveArticleArtwork } from './artwork';
 export { wrapArticleTables, articleTableCss } from './article-tables';
+export { insertArticlePhotos, articlePhotoCss } from './article-photos';
+export type { ArticleEditorialPhoto } from './types';
 export { FEED_DEFAULT_ITEMS, NEWS_SITEMAP_MAX_URLS, NEWS_SITEMAP_WINDOW_MS, buildNewsSitemapXml, cdata, recentNewsPosts } from './news-sitemap';
 export type { NewsSitemapOptions, NewsSitemapPost } from './news-sitemap';

package/dist/articles/server.js

@@ -1,4 +1,5 @@
-export { FEED_DEFAULT_ITEMS, NEWS_SITEMAP_MAX_URLS, NEWS_SITEMAP_WINDOW_MS, SEO_LIMITS, buildNewsSitemapXml, cdata, 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, getAuthorBySlug, getAuthorPosts, getClusterNavigation, getPostsByCategory, getRelatedInsights, getTopicCluster, getTopicClusters, recentNewsPosts, requireArticle, sanitizeExcerpt, validateArticleSeo, validateMetaDescription, validateSeoTitle } from '../chunk-XPTJRVL2.js';
+export { FEED_DEFAULT_ITEMS, NEWS_SITEMAP_MAX_URLS, NEWS_SITEMAP_WINDOW_MS, SEO_LIMITS, buildNewsSitemapXml, cdata, 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, getAuthorBySlug, getAuthorPosts, getClusterNavigation, getPostsByCategory, getRelatedInsights, getTopicCluster, getTopicClusters, recentNewsPosts, requireArticle, sanitizeExcerpt, validateArticleSeo, validateMetaDescription, validateSeoTitle } from '../chunk-FQUGGPBM.js';
+export { articlePhotoCss, insertArticlePhotos } from '../chunk-HUBMKTPW.js';
 export { articleTableCss, wrapArticleTables } from '../chunk-Y3INC4QJ.js';
 export { authorEntityId, generateArticleAuthorNode, generateAuthorPersonSchema, generateAuthorSchema, resolveArticleArtwork, withArticleAuthorIdentity } from '../chunk-QXMIKDOL.js';
 export { articleCategorySlug, createPublicationRoutes, resolveArticleUrl, resolvePublicationUrl } from '../chunk-WMVK77ND.js';

package/dist/articles/types.d.ts

@@ -2,6 +2,21 @@
  * @sonordev/site-kit/articles - Type definitions
  */
 import type { PublicationRoutingOptions } from './routes';
+/** Public, approved photo snapshot. Planning briefs and private source metadata stay in Sonor. */
+export interface ArticleEditorialPhoto {
+    url: string;
+    alt: string;
+    caption?: string;
+    width: number;
+    height: number;
+    placement: {
+        kind: 'after_intro';
+    } | {
+        kind: 'after_heading';
+        heading: string;
+        headingId?: string;
+    };
+}
 export interface Article {
     id: string;
     project_id: string;
@@ -23,6 +38,8 @@ export interface Article {
     /** Dedicated index frame from Sonor's atmosphere + content-stage renderer. */
     index_image?: string;
     index_image_alt?: string;
+    /** Supporting photos placed deliberately in the article body; optional on older APIs. */
+    editorial_photos?: ArticleEditorialPhoto[];
     /** Author - can be string or object depending on API response */
     author_id?: string;
     author?: ArticleAuthor | string;

package/dist/chat/index.js

@@ -1,10 +1,10 @@
 'use client';
-export { ChatWidget, DEFAULT_LAUNCHER_OFFSET_BOTTOM, EchoChat, chatLauncherStyles, isChatEnabled } from '../chunk-B7QRRLTU.js';
-export { SiteChat } from '../chunk-AGJODJ4V.js';
+export { ChatWidget, DEFAULT_LAUNCHER_OFFSET_BOTTOM, EchoChat, chatLauncherStyles, isChatEnabled } from '../chunk-FVXFLVXF.js';
+export { SiteChat } from '../chunk-NNEIBXGU.js';
 import '../chunk-6T6CQVNL.js';
 import '../chunk-JE4A5S4F.js';
 import '../chunk-27FISYK4.js';
-import '../chunk-3222QBUS.js';
+import '../chunk-YBAFUM3Z.js';
 import '../chunk-Q6E4OPGG.js';
 import '../chunk-5ROTTMBL.js';
 import '../chunk-C2FZBUSS.js';
@@ -18,9 +18,9 @@ import '../chunk-GJWI74ZZ.js';
 import '../chunk-CAH4Y4PY.js';
 import '../chunk-EKBEOXTH.js';
 import '../chunk-3G7YABRA.js';
-import '../chunk-55JLUMAC.js';
-import '../chunk-IY6G67EF.js';
-import '../chunk-S5G3A7OZ.js';
+import '../chunk-727R7C5R.js';
+import '../chunk-3EU6S5YC.js';
+import '../chunk-Q72M5KBS.js';
 import '../chunk-PKBMQBKP.js';
 
 // src/chat/echo-config.ts

package/dist/{chunk-IY6G67EF.js → chunk-3EU6S5YC.js}

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

package/dist/{chunk-M62U7TJF.js → chunk-575L73NT.js}

@@ -1,4 +1,4 @@
-import { generateLLMsTxt, generateLLMsFullTxt, appendAgentAccessSection } from './chunk-TZ5RTANX.js';
+import { generateLLMsTxt, generateLLMsFullTxt, appendAgentAccessSection } from './chunk-WACWV5EP.js';
 import { createHash } from 'crypto';
 import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';

package/dist/{chunk-OE3NXEOF.js → chunk-57K4GW3D.js}

@@ -1,4 +1,4 @@
-import { writeLLMsTxtToPublic } from './chunk-TZ5RTANX.js';
+import { writeLLMsTxtToPublic } from './chunk-WACWV5EP.js';
 import { getSiteConfig } from './chunk-Z22QVHT4.js';
 import { buildFetch } from './chunk-UAYAJPEP.js';
 import { findAppDirForDiscovery } from './chunk-ZEGVKVD5.js';

package/dist/{chunk-6KUCA5HG.js → chunk-5ZCY36TY.js}

@@ -1,5 +1,5 @@
 import { resolveSiteHost } from './chunk-FESKKJAS.js';
-import { configureSiteCredential, currentCredential } from './chunk-IY6G67EF.js';
+import { configureSiteCredential, currentCredential } from './chunk-3EU6S5YC.js';
 
 // src/shared/publishCredential.ts
 function publishSiteCredential({

package/dist/{chunk-Z6PVFZRI.js → chunk-66G47P5C.js}

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

package/dist/{chunk-55JLUMAC.js → chunk-727R7C5R.js}

@@ -1,5 +1,5 @@
-import { isTokenMode, getFreshCredential, isSiteToken, refreshSiteToken, currentCredential, credentialBreakerId } from './chunk-IY6G67EF.js';
-import { SITE_KIT_VERSION } from './chunk-S5G3A7OZ.js';
+import { isTokenMode, getFreshCredential, isSiteToken, refreshSiteToken, currentCredential, credentialBreakerId } from './chunk-3EU6S5YC.js';
+import { SITE_KIT_VERSION } from './chunk-Q72M5KBS.js';
 
 // src/shared/fetchWithRetry.ts
 function backoffDelay(attempt, response) {

package/dist/{chunk-6BXUSAOJ.js → chunk-7FSB2EXS.js}

@@ -1,5 +1,5 @@
 'use client';
-import { sonorFetch } from './chunk-55JLUMAC.js';
+import { sonorFetch } from './chunk-727R7C5R.js';
 import { useState, useCallback, useEffect } from 'react';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
 

package/dist/{chunk-VQQV7FOX.js → chunk-BQZPHICL.js}

@@ -1,4 +1,4 @@
-import { FormEnhancer } from './chunk-GMXY2OOY.js';
+import { FormEnhancer } from './chunk-SMYX3AAO.js';
 import { StaticForm } from './chunk-LNSF6BJC.js';
 import { serverApiFetch } from './chunk-C7TLGL3R.js';
 import { jsx } from 'react/jsx-runtime';

package/dist/{chunk-OCKGB734.js → chunk-EBILJHUF.js}

@@ -3,7 +3,7 @@ import { registerAnalyticsDispatcher } from './chunk-LCDVPAMR.js';
 import { getOrCreateVisitorId, getOrCreateSessionId } from './chunk-ZKADJNR2.js';
 import { onPageLeave } from './chunk-L2V5PUFN.js';
 import { resolveAnalyticsTarget } from './chunk-CAH4Y4PY.js';
-import { sonorFetch, sonorBeacon } from './chunk-55JLUMAC.js';
+import { sonorFetch, sonorBeacon } from './chunk-727R7C5R.js';
 import { createContext, useRef, useEffect, useState, useMemo, useCallback, useContext } from 'react';
 import { usePathname } from 'next/navigation';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/{chunk-XPTJRVL2.js → chunk-FQUGGPBM.js}

@@ -1,3 +1,4 @@
+import { insertArticlePhotos } from './chunk-HUBMKTPW.js';
 import { generateArticleAuthorNode, resolveArticleArtwork, withArticleAuthorIdentity } from './chunk-QXMIKDOL.js';
 import { resolveArticleUrl, createPublicationRoutes, resolvePublicationUrl, articleCategorySlug } from './chunk-WMVK77ND.js';
 import { withoutSchemaPlaceholders } from './chunk-VWWITFWM.js';
@@ -599,7 +600,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 = post.content_html || post.content || "";
+    const fullContent = insertArticlePhotos(post.content_html || post.content || "", post.editorial_photos);
     const description2 = sanitizeExcerpt(post.excerpt, 300) || stripHtml(fullContent).substring(0, 300) + "...";
     rss += `    <item>
       <title>${escapeXml(post.title)}</title>
@@ -662,7 +663,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 = post.content_html || post.content || "";
+    const fullContent = insertArticlePhotos(post.content_html || post.content || "", post.editorial_photos);
     atom += `  <entry>
     <title>${escapeXml(post.title)}</title>
     <link href="${escapeXml(postUrl)}"/>

package/dist/{chunk-B7QRRLTU.js → chunk-FVXFLVXF.js}

@@ -2,10 +2,10 @@
 import { VISUAL_VIEWPORT_GAP_PROPERTY } from './chunk-6T6CQVNL.js';
 import { GlassStyles } from './chunk-JE4A5S4F.js';
 import { DEFAULT_WIDGET_Z_INDEX } from './chunk-27FISYK4.js';
-import { useForm } from './chunk-3222QBUS.js';
+import { useForm } from './chunk-YBAFUM3Z.js';
 import { parseColor, relativeLuminance, DARK_LUMINANCE, contrastRatio } from './chunk-S22FSH7C.js';
 import { readPublishedApiConfig } from './chunk-3G7YABRA.js';
-import { sonorFetch } from './chunk-55JLUMAC.js';
+import { sonorFetch } from './chunk-727R7C5R.js';
 import { useState, useEffect, useRef, useLayoutEffect, useCallback, Fragment as Fragment$1 } from 'react';
 import { lexer } from 'marked';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';