@sonordev/site-kit 8.0.0 → 8.1.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @sonordev/site-kit Changelog
 
+## 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.
+- **Moving a commerce site to 8? Use sonor-setup 7.3.1 or later.** Its codemod writes the `pnpm-workspace.yaml` line it adds as valid YAML, and it adds `@sonordev/commerce-kit` only to a project whose code imports commerce, not to one that merely mentions it in a code sample or a redirect table. [docs/MIGRATING-TO-8.md](docs/MIGRATING-TO-8.md) says so too.
+
 ## 8.0.0
 
 Two things leave site-kit in this release. Commerce (products, services, events and checkout) and the new memberships module move into their own package, [`@sonordev/commerce-kit`](https://sonor.dev/commerce-kit), which versions and releases on its own. And the entries for the modules Sonor retired, Engage and the Sanity CMS, are removed, as the 7.0, 7.1 and 7.2 notes said they'd be. A site that uses neither changes nothing: update site-kit and rebuild.

package/agent-manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "package": "@sonordev/site-kit",
-  "version": "8.0.0",
+  "version": "8.1.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-LYFDQRRJ.js → AnalyticsProvider-UWTCE5UO.js}

@@ -1,4 +1,4 @@
-export { AnalyticsProvider, useAnalytics, useAnalyticsOptional, useTrackEvent } from './chunk-J65N34YM.js';
+export { AnalyticsProvider, useAnalytics, useAnalyticsOptional, useTrackEvent } from './chunk-TAO6BVA2.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-56VDS2RP.js';
-import './chunk-ZLFGXKLG.js';
-import './chunk-5S2XDG5O.js';
+import './chunk-WPOFTCKL.js';
+import './chunk-F2VYN3QL.js';
+import './chunk-NWVB75ER.js';
 import './chunk-PKBMQBKP.js';

package/dist/{ArticleViewTracker-HG7IIRJY.js → ArticleViewTracker-MYD6SGNH.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-56VDS2RP.js';
-import './chunk-ZLFGXKLG.js';
-import './chunk-5S2XDG5O.js';
+import { sonorFetch } from './chunk-WPOFTCKL.js';
+import './chunk-F2VYN3QL.js';
+import './chunk-NWVB75ER.js';
 import './chunk-PKBMQBKP.js';
 import { useEffect } from 'react';
 

package/dist/{BlocksPopup-GFX3GZIK.js → BlocksPopup-OY5G3EFH.js}

@@ -1,14 +1,14 @@
 'use client';
-import { getSiteDesignTokens } from './chunk-KRBBH64S.js';
+import { getSiteDesignTokens } from './chunk-DSNCU2E3.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-56VDS2RP.js';
-import './chunk-ZLFGXKLG.js';
-import './chunk-5S2XDG5O.js';
+import './chunk-WPOFTCKL.js';
+import './chunk-F2VYN3QL.js';
+import './chunk-NWVB75ER.js';
 import './chunk-PKBMQBKP.js';
 import { useState } from 'react';
 import { jsx } from 'react/jsx-runtime';

package/dist/{ChatWidget-DVS7MLBN.js → ChatWidget-BTR5VERC.js}

@@ -1,8 +1,8 @@
-export { ChatWidget, EchoChat, isChatEnabled } from './chunk-GNSXOTIK.js';
+export { ChatWidget, EchoChat, isChatEnabled } from './chunk-CSTC6HZO.js';
 import './chunk-6T6CQVNL.js';
 import './chunk-JE4A5S4F.js';
 import './chunk-27FISYK4.js';
-import './chunk-UUWUAMUC.js';
+import './chunk-S6IGQYHW.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-56VDS2RP.js';
-import './chunk-ZLFGXKLG.js';
-import './chunk-5S2XDG5O.js';
+import './chunk-WPOFTCKL.js';
+import './chunk-F2VYN3QL.js';
+import './chunk-NWVB75ER.js';
 import './chunk-PKBMQBKP.js';

package/dist/{FileField-DVN7NUBI.js → FileField-DEHVYXAO.js}

@@ -1,8 +1,8 @@
 'use client';
 import { getClientApiConfig } from './chunk-3G7YABRA.js';
-import { sonorFetch } from './chunk-56VDS2RP.js';
-import './chunk-ZLFGXKLG.js';
-import './chunk-5S2XDG5O.js';
+import { sonorFetch } from './chunk-WPOFTCKL.js';
+import './chunk-F2VYN3QL.js';
+import './chunk-NWVB75ER.js';
 import './chunk-PKBMQBKP.js';
 import React from 'react';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';

package/dist/{FormSpotlight-W4SXKKO6.js → FormSpotlight-VGC4CZL4.js}

@@ -1,6 +1,6 @@
 'use client';
 import { StageStyles, SummaryTick } from './chunk-3YKQLC7J.js';
-import { stageFirstName, useFieldControls, stageViews, stageEstimate, AUTO_ADVANCE_TYPES } from './chunk-SBPAXWLF.js';
+import { stageFirstName, useFieldControls, stageViews, stageEstimate, AUTO_ADVANCE_TYPES } from './chunk-XUCU3LX4.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-JTEE5MZD.js → FormStage-CJUSCSAL.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-SBPAXWLF.js';
+import { useFieldControls, stageViews, stageFirstName, stageEstimate, formatAnswer, AUTO_ADVANCE_TYPES } from './chunk-XUCU3LX4.js';
 import { readAgentSubmit, formToolAttributes } from './chunk-Q6E4OPGG.js';
 import { isEmptyValue, unseenControlValues } from './chunk-C2FZBUSS.js';
 import { FormField } from './chunk-TYAVHRWH.js';

package/dist/{ManagedForm-ZAUHIHGP.js → ManagedForm-JCI2KPMO.js}

@@ -1,6 +1,6 @@
-export { ManagedForm } from './chunk-LKH44GI3.js';
-import './chunk-SBPAXWLF.js';
-import './chunk-UUWUAMUC.js';
+export { ManagedForm } from './chunk-5L467Z5Q.js';
+import './chunk-XUCU3LX4.js';
+import './chunk-S6IGQYHW.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-56VDS2RP.js';
-import './chunk-ZLFGXKLG.js';
-import './chunk-5S2XDG5O.js';
+import './chunk-WPOFTCKL.js';
+import './chunk-F2VYN3QL.js';
+import './chunk-NWVB75ER.js';
 import './chunk-PKBMQBKP.js';

package/dist/{ManagedNewsletterForm-DQIB5Z4Y.js → ManagedNewsletterForm-DTE4KKXV.js}

@@ -1,4 +1,4 @@
-import { useForm } from './chunk-UUWUAMUC.js';
+import { useForm } from './chunk-S6IGQYHW.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-56VDS2RP.js';
-import './chunk-ZLFGXKLG.js';
-import './chunk-5S2XDG5O.js';
+import './chunk-WPOFTCKL.js';
+import './chunk-F2VYN3QL.js';
+import './chunk-NWVB75ER.js';
 import './chunk-PKBMQBKP.js';
 import { jsx } from 'react/jsx-runtime';
 

package/dist/{SignalCore-W5PYYMGX.js → SignalCore-LGCBQDEH.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-56VDS2RP.js';
-import { getFreshCredential, isSiteToken } from './chunk-ZLFGXKLG.js';
-import './chunk-5S2XDG5O.js';
+import { sonorFetch } from './chunk-WPOFTCKL.js';
+import { getFreshCredential, isSiteToken } from './chunk-F2VYN3QL.js';
+import './chunk-NWVB75ER.js';
 import './chunk-PKBMQBKP.js';
 import { useState, useRef, useEffect, useCallback } from 'react';
 

package/dist/{SiteChat-MY2GATWC.js → SiteChat-6SF7PVUT.js}

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

package/dist/{SiteDesignReporter-ICZWEGCY.js → SiteDesignReporter-VISQZ5NQ.js}

@@ -1,12 +1,12 @@
-export { SiteDesignReporter } from './chunk-ZHNQFNO3.js';
-import './chunk-KRBBH64S.js';
+export { SiteDesignReporter } from './chunk-G2HCCWZQ.js';
+import './chunk-DSNCU2E3.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-56VDS2RP.js';
-import './chunk-ZLFGXKLG.js';
-import './chunk-5S2XDG5O.js';
+import './chunk-WPOFTCKL.js';
+import './chunk-F2VYN3QL.js';
+import './chunk-NWVB75ER.js';
 import './chunk-PKBMQBKP.js';

package/dist/{SitePopups-TGULLAER.js → SitePopups-T6YPHAVY.js}

@@ -1,4 +1,4 @@
-export { SitePopups } from './chunk-S7SSYGUJ.js';
+export { SitePopups } from './chunk-LLW5HKEE.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-56VDS2RP.js';
-import './chunk-ZLFGXKLG.js';
-import './chunk-5S2XDG5O.js';
+import './chunk-WPOFTCKL.js';
+import './chunk-F2VYN3QL.js';
+import './chunk-NWVB75ER.js';
 import './chunk-PKBMQBKP.js';

package/dist/{SitemapSync-AN2OBJE6.js → SitemapSync-VKMVRPZL.js}

@@ -1,9 +1,9 @@
-export { SitemapSync } from './chunk-K22OLAPC.js';
+export { SitemapSync } from './chunk-IAYGTQJD.js';
 import './chunk-YVKRYQRG.js';
 import './chunk-CAH4Y4PY.js';
 import './chunk-EKBEOXTH.js';
 import './chunk-3G7YABRA.js';
-import './chunk-56VDS2RP.js';
-import './chunk-ZLFGXKLG.js';
-import './chunk-5S2XDG5O.js';
+import './chunk-WPOFTCKL.js';
+import './chunk-F2VYN3QL.js';
+import './chunk-NWVB75ER.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-OGK7OL3T.js';
-import '../chunk-IJQ767JS.js';
+export { BookingWidget, BookingWidget_default as default } from '../chunk-55GHBRCN.js';
+import '../chunk-2JEUDTL6.js';
 import '../chunk-3G7YABRA.js';
-import '../chunk-56VDS2RP.js';
-import '../chunk-ZLFGXKLG.js';
-import '../chunk-5S2XDG5O.js';
+import '../chunk-WPOFTCKL.js';
+import '../chunk-F2VYN3QL.js';
+import '../chunk-NWVB75ER.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-56VDS2RP.js';
-import '../chunk-ZLFGXKLG.js';
-import '../chunk-5S2XDG5O.js';
+import { sonorFetch } from '../chunk-WPOFTCKL.js';
+import '../chunk-F2VYN3QL.js';
+import '../chunk-NWVB75ER.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-J65N34YM.js';
+export { AnalyticsProvider, WebVitals, useAnalytics, useAnalyticsOptional, useTrackEvent } from '../chunk-TAO6BVA2.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-56VDS2RP.js';
-import '../chunk-ZLFGXKLG.js';
-import '../chunk-5S2XDG5O.js';
+import '../chunk-WPOFTCKL.js';
+import '../chunk-F2VYN3QL.js';
+import '../chunk-NWVB75ER.js';
 import '../chunk-PKBMQBKP.js';
 import { useCallback, useEffect } from 'react';
 

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

@@ -1,3 +1,4 @@
+import { articlePhotoCss } from './chunk-2UO4HPGE.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-DQIB5Z4Y.js'));
+var ManagedNewsletterForm = React.lazy(() => import('../ManagedNewsletterForm-DTE4KKXV.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-4Z3DI2EL.js';
+import { insertArticlePhotos } from '../chunk-2UO4HPGE.js';
+export { articlePhotoCss, insertArticlePhotos } from '../chunk-2UO4HPGE.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-GGZOQG5X.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-HG7IIRJY.js');
+  const { ArticleViewTracker } = await import('../ArticleViewTracker-MYD6SGNH.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-GGZOQG5X.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-4Z3DI2EL.js';
+export { articlePhotoCss, insertArticlePhotos } from '../chunk-2UO4HPGE.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,20 @@
  * @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;
+    };
+}
 export interface Article {
     id: string;
     project_id: string;
@@ -23,6 +37,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-GNSXOTIK.js';
-export { SiteChat } from '../chunk-PD7K54EQ.js';
+export { ChatWidget, DEFAULT_LAUNCHER_OFFSET_BOTTOM, EchoChat, chatLauncherStyles, isChatEnabled } from '../chunk-CSTC6HZO.js';
+export { SiteChat } from '../chunk-A3EU6HB5.js';
 import '../chunk-6T6CQVNL.js';
 import '../chunk-JE4A5S4F.js';
 import '../chunk-27FISYK4.js';
-import '../chunk-UUWUAMUC.js';
+import '../chunk-S6IGQYHW.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-56VDS2RP.js';
-import '../chunk-ZLFGXKLG.js';
-import '../chunk-5S2XDG5O.js';
+import '../chunk-WPOFTCKL.js';
+import '../chunk-F2VYN3QL.js';
+import '../chunk-NWVB75ER.js';
 import '../chunk-PKBMQBKP.js';
 
 // src/chat/echo-config.ts

package/dist/{chunk-OE3NXEOF.js → chunk-255NCCPB.js}

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

package/dist/{chunk-IJQ767JS.js → chunk-2JEUDTL6.js}

@@ -1,5 +1,5 @@
 import { getClientApiConfig } from './chunk-3G7YABRA.js';
-import { sonorFetch } from './chunk-56VDS2RP.js';
+import { sonorFetch } from './chunk-WPOFTCKL.js';
 
 // src/sync/api.ts
 function getApiConfig() {

package/dist/chunk-2UO4HPGE.js

@@ -0,0 +1,109 @@
+// src/articles/article-photos.ts
+var voidElements = /* @__PURE__ */ new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "param", "source", "track", "wbr"]);
+var rawElements = /* @__PURE__ */ new Set(["pre", "code", "script", "style", "textarea", "xmp", "template"]);
+var excludedAncestors = /* @__PURE__ */ new Set(["figure", "table", "ul", "ol", "blockquote", "aside", "nav", "header", "footer"]);
+var tags = () => /<!--[\s\S]*?(?:-->|$)|<\/?[a-z][\w:-]*(?=[\s/>])(?:[^"'<>]|"[^"]*"|'[^']*')*>/gi;
+var escape = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+function headingText(value) {
+  const entities = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'", nbsp: " ", rsquo: "\u2019", lsquo: "\u2018", ldquo: "\u201C", rdquo: "\u201D", ndash: "\u2013", mdash: "\u2014" };
+  return value.replace(/<!--[\s\S]*?-->/g, "").replace(tags(), "").replace(/&(#x[\da-f]+|#\d+|[a-z]+);/gi, (full, entity) => {
+    if (!entity.startsWith("#")) return entities[entity.toLowerCase()] ?? full;
+    const number = entity[1].toLowerCase() === "x" ? parseInt(entity.slice(2), 16) : parseInt(entity.slice(1), 10);
+    return number > 0 && number <= 1114111 ? String.fromCodePoint(number) : full;
+  }).replace(/\s+/g, " ").trim();
+}
+function photoUrl(value) {
+  if (typeof value !== "string" || value.length > 2e3 || /[\s\\]/.test(value)) return null;
+  try {
+    const url = new URL(value);
+    if (url.protocol !== "https:" || url.username || url.password || /\/Blog\/(Cards|Carousel)\//i.test(decodeURIComponent(url.pathname))) return null;
+    return url.href;
+  } catch {
+    return null;
+  }
+}
+function figure(photo, index) {
+  const url = photoUrl(photo.url);
+  if (!url || typeof photo.alt !== "string" || !photo.alt.trim() || photo.alt.length > 300) return null;
+  if (![photo.width, photo.height].every((n) => Number.isInteger(n) && n > 0 && n <= 2400)) return null;
+  const caption = typeof photo.caption === "string" && photo.caption.trim() ? `<figcaption>${escape(photo.caption.slice(0, 300))}</figcaption>` : "";
+  return `<figure class="sk-article-photo" data-sk-editorial-photo="${index}"><img src="${escape(url)}" alt="${escape(photo.alt)}" width="${photo.width}" height="${photo.height}" loading="lazy" decoding="async" style="display:block;max-width:100%;height:auto" />${caption}</figure>`;
+}
+function insertArticlePhotos(html, photos) {
+  if (!html || !Array.isArray(photos) || !photos.length) return html;
+  const pattern = tags();
+  const stack = [];
+  const headings = [];
+  const paragraphs = [];
+  const existing = /* @__PURE__ */ new Set();
+  const existingSlots = /* @__PURE__ */ new Set();
+  let token;
+  while (token = pattern.exec(html)) {
+    const tag = token[0];
+    if (tag.startsWith("<!--")) continue;
+    const name = /^<\/?([\w:-]+)/.exec(tag)[1].toLowerCase();
+    if (tag.startsWith("</")) {
+      const at = stack.map((frame2) => frame2.name).lastIndexOf(name);
+      if (at < 0) continue;
+      const frame = stack[at];
+      if (frame.eligible) {
+        if (/^h[1-6]$/.test(name)) headings.push({ text: headingText(html.slice(frame.inner, token.index)), start: frame.start, end: pattern.lastIndex, level: Number(name[1]) });
+        if (name === "p" && headingText(html.slice(frame.inner, token.index))) paragraphs.push({ start: frame.start, end: pattern.lastIndex });
+      }
+      stack.length = at;
+      continue;
+    }
+    if (rawElements.has(name)) {
+      const closing = new RegExp(`</${name}\\s*>`, "gi");
+      closing.lastIndex = pattern.lastIndex;
+      if (!closing.exec(html)) break;
+      pattern.lastIndex = closing.lastIndex;
+      continue;
+    }
+    const attrs = tag.replace(/^<[\w:-]+/, "").replace(/\/?>$/, "");
+    for (const match of attrs.matchAll(/([^\s=/>]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'=<>`]+)))?/g)) {
+      const key = match[1].toLowerCase(), value = match[2] ?? match[3] ?? match[4] ?? "";
+      if (name === "img" && key === "src") existing.add(headingText(value));
+      if (name === "figure" && key === "data-sk-editorial-photo" && /^\d+$/.test(value)) existingSlots.add(Number(value));
+    }
+    if (voidElements.has(name) || /\/\s*>$/.test(tag)) continue;
+    stack.push({ name, start: token.index, inner: pattern.lastIndex, eligible: !stack.some((frame) => excludedAncestors.has(frame.name)) });
+  }
+  const additions = /* @__PURE__ */ new Map();
+  photos.slice(0, 8).forEach((photo, index) => {
+    if (!photo || existingSlots.has(index)) return;
+    const rendered = figure(photo, index);
+    const url = photoUrl(photo.url);
+    if (!rendered || !url || existing.has(url)) return;
+    let paragraph;
+    if (photo.placement?.kind === "after_intro") {
+      const firstSection = headings.find((heading) => heading.level > 1);
+      paragraph = paragraphs.find((p) => !firstSection || p.start < firstSection.start);
+    } else if (photo.placement?.kind === "after_heading" && typeof photo.placement.heading === "string") {
+      const expectedHeading = headingText(photo.placement.heading);
+      const matches = headings.filter((heading2) => heading2.text === expectedHeading);
+      if (matches.length !== 1) return;
+      const heading = matches[0];
+      const next = headings.find((item) => item.start > heading.start);
+      paragraph = paragraphs.find((p) => p.start >= heading.end && (!next || p.end < next.start));
+    }
+    if (!paragraph) return;
+    const images = additions.get(paragraph.end) || [];
+    images.push(rendered);
+    additions.set(paragraph.end, images);
+    existing.add(url);
+  });
+  let result = html;
+  for (const [offset, images] of [...additions].sort(([a], [b]) => b - a)) result = result.slice(0, offset) + images.join("") + result.slice(offset);
+  return result;
+}
+var articlePhotoCss = (
+  /* css */
+  `
+.sk-article-photo { margin: 2em 0; max-width: 100%; }
+.sk-article-photo img { display: block; width: 100%; max-width: 100%; height: auto; border-radius: var(--sk-radius, 0.75rem); }
+.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; }
+`
+);
+
+export { articlePhotoCss, insertArticlePhotos };

package/dist/{chunk-BQ2CXKTQ.js → chunk-47VB5INH.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-5S2XDG5O.js';
+import { SITE_KIT_VERSION } from './chunk-NWVB75ER.js';
 import 'server-only';
 
 var MINT_PATH = "/api/public/site-token";