@sonordev/site-kit 8.0.1 → 8.2.0

package/dist/mcp/sonor.js

@@ -1,9 +1,9 @@
 import { fetchReviews, fetchReviewStats } from '../chunk-NFRJTOTB.js';
 import { toolErrorResult } from '../chunk-FYAB6CXS.js';
-import { fetchBookingTypes, fetchAvailability } from '../chunk-YGXWG54S.js';
+import { fetchBookingTypes, fetchAvailability } from '../chunk-XWIRU6UT.js';
 import { getLLMsData, getServices, getFAQItems, getPageSummaries } from '../chunk-JIH32RH2.js';
-import { getFormConfig } from '../chunk-VQQV7FOX.js';
-import '../chunk-GMXY2OOY.js';
+import { getFormConfig } from '../chunk-BQZPHICL.js';
+import '../chunk-SMYX3AAO.js';
 import '../chunk-C2FZBUSS.js';
 import '../chunk-YC7ELZS3.js';
 import '../chunk-LNSF6BJC.js';
@@ -12,7 +12,8 @@ import '../chunk-TYAVHRWH.js';
 import '../chunk-5SQK3D53.js';
 import '../chunk-HW7B43E5.js';
 import '../chunk-NJCTQH2P.js';
-import { getAllArticles, getArticle } from '../chunk-XPTJRVL2.js';
+import { getAllArticles, getArticle } from '../chunk-FQUGGPBM.js';
+import '../chunk-HUBMKTPW.js';
 import '../chunk-Y3INC4QJ.js';
 import '../chunk-QXMIKDOL.js';
 import '../chunk-WMVK77ND.js';
@@ -25,9 +26,9 @@ import '../chunk-MH2DSGC6.js';
 import { resolveSiteHost } from '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
 import '../chunk-3G7YABRA.js';
-import '../chunk-55JLUMAC.js';
-import '../chunk-IY6G67EF.js';
-import { SITE_KIT_VERSION } from '../chunk-S5G3A7OZ.js';
+import '../chunk-727R7C5R.js';
+import '../chunk-3EU6S5YC.js';
+import { SITE_KIT_VERSION } from '../chunk-Q72M5KBS.js';
 import '../chunk-PKBMQBKP.js';
 import 'server-only';
 import { after } from 'next/server.js';
@@ -225,7 +226,7 @@ function getArticleTool(ctx, basePath) {
   return {
     name: "get_article",
     title: "Read an article",
-    description: "One article in full, by the slug list_articles returned. Cite it by its URL.",
+    description: "One article in full, with approved supporting photo descriptions and section placements, by the slug list_articles returned. Cite it by its URL. Photo captions describe context; they do not verify claims beyond the article.",
     inputSchema: {
       type: "object",
       properties: { slug: { type: "string", description: "The article slug from list_articles." } },
@@ -247,7 +248,8 @@ function getArticleTool(ctx, basePath) {
         published_at: post.published_at,
         content: content.slice(0, ARTICLE_CONTENT_MAX),
         truncated: content.length > ARTICLE_CONTENT_MAX,
-        faq: post.faq_items
+        faq: post.faq_items,
+        editorial_photos: post.editorial_photos?.slice(0, 8).map(({ url, alt, caption, width, height, placement }) => ({ url, alt, caption, width, height, placement }))
       };
     }
   };

package/dist/revalidate/index.js

@@ -1,7 +1,7 @@
-import { createSeoRevalidationHandler } from '../chunk-DWNS6ZJM.js';
+import { createSeoRevalidationHandler } from '../chunk-X7VKRHFF.js';
 import '../chunk-XTRZGXB2.js';
 export { SITE_CACHE_TAGS, SITE_REVALIDATE_PATH, isSiteRevalidatePong } from '../chunk-6KU7STM3.js';
-import '../chunk-S5G3A7OZ.js';
+import '../chunk-Q72M5KBS.js';
 import '../chunk-PKBMQBKP.js';
 
 // src/revalidate/index.ts

package/dist/runtime/index.js

@@ -1,7 +1,7 @@
 export { readAnalyticsIdentity } from '../chunk-5ROTTMBL.js';
 import '../chunk-5TM3WPCI.js';
 export { DEFAULT_SONOR_API_URL, getClientApiConfig, readPublishedApiConfig } from '../chunk-3G7YABRA.js';
-export { sonorFetch } from '../chunk-55JLUMAC.js';
-import '../chunk-IY6G67EF.js';
-import '../chunk-S5G3A7OZ.js';
+export { sonorFetch } from '../chunk-727R7C5R.js';
+import '../chunk-3EU6S5YC.js';
+import '../chunk-Q72M5KBS.js';
 import '../chunk-PKBMQBKP.js';

package/dist/seo/client.js

@@ -1,10 +1,10 @@
 'use client';
-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/seo/index.js

@@ -2,7 +2,7 @@ export { ManagedNoScripts, ManagedScripts } from '../chunk-MVLMXC44.js';
 import { pickManagedLlmSchemaForJsonLd } from '../chunk-NZ4RXN3G.js';
 import { safeJsonLd } from '../chunk-4KZ6W3ZH.js';
 import { withoutSchemaPlaceholders } from '../chunk-VWWITFWM.js';
-export { SitemapSync } from '../chunk-FIGIJK5F.js';
+export { SitemapSync } from '../chunk-WK3N3Y7V.js';
 import { getManagedMetadata, mergeAlternates } from '../chunk-URJN75ZG.js';
 export { generateSitemap, getABVariant, getManagedMetadata, getManagedMetadataWithAB, getRedirect, getRobotsDirective, isIndexable } from '../chunk-URJN75ZG.js';
 import { getSchemaMarkups, getSEOPageData, getEntityEnhancedSchema, getFAQData, getInternalLinks, pruneSchemaTypes } from '../chunk-Y35BWW2C.js';
@@ -19,9 +19,9 @@ import '../chunk-A4CC4ZG3.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 { Suspense } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';

package/dist/seo/llms.js

@@ -1,10 +1,10 @@
-export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-M62U7TJF.js';
+export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-575L73NT.js';
 export { buildAiDiscoveryHeaders, wantsLlmsDiscoveryLink } from '../chunk-PO2TRJPY.js';
 export { AI_RETRIEVAL_CRAWLERS, AI_TRAINING_CRAWLERS, buildAiCrawlerRules, createRobotsTxtHandler } from '../chunk-QLTDFUJ7.js';
-export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-DWNS6ZJM.js';
+export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-X7VKRHFF.js';
 export { AEOBlock, AEOCitedContent, AEOClaim, AEOComparison, AEODefinition, AEOEntity, AEOProvenanceList, AEOStep, AEOSteps, AEOSummary, DEFAULT_SPEAKABLE_SELECTORS, SpeakableSchema, createSpeakableSchema, getSpeakableSelectorsForPage } from '../chunk-PSAG45YF.js';
 import '../chunk-XTRZGXB2.js';
-export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-TZ5RTANX.js';
+export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-WACWV5EP.js';
 export { getBusinessInfo, getFAQItems, getLLMsData, getOptimizedLLMsTxt, getPageSummaries, getServices } from '../chunk-JIH32RH2.js';
 import '../chunk-L5UOHS6E.js';
 import '../chunk-WMVK77ND.js';
@@ -16,5 +16,5 @@ import '../chunk-YVKRYQRG.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
 import '../chunk-3G7YABRA.js';
-import '../chunk-S5G3A7OZ.js';
+import '../chunk-Q72M5KBS.js';
 import '../chunk-PKBMQBKP.js';

package/dist/seo/register-sitemap-cli.js

@@ -458,7 +458,7 @@ async function registerLocalSitemap(options) {
   }
   if (options.writeLlms && result.success) {
     try {
-      const { writeLLMsTxtToPublic } = await import('../writeLLMsTxt-UZGN6IBU.js');
+      const { writeLLMsTxtToPublic } = await import('../writeLLMsTxt-DGKLYXIW.js');
       const written = await writeLLMsTxtToPublic({
         // Resolved here too: the sync's own `site` is scoped to the branch that
         // posts, and this runs on the skip path as well.

package/dist/seo/sitemap.js

@@ -1,5 +1,5 @@
-export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-OE3NXEOF.js';
-import '../chunk-TZ5RTANX.js';
+export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-57K4GW3D.js';
+import '../chunk-WACWV5EP.js';
 import '../chunk-JIH32RH2.js';
 import '../chunk-Z22QVHT4.js';
 import '../chunk-L5UOHS6E.js';

package/dist/server/index.js

@@ -1,7 +1,7 @@
-export { resolveClientCredential } from '../chunk-H3SDOSVU.js';
+export { resolveClientCredential } from '../chunk-ZM2FNWIQ.js';
 import '../chunk-UAYAJPEP.js';
 export { SITE_CACHE_TAGS } from '../chunk-6KU7STM3.js';
 export { isNextControlFlow, requireServerApiConfig, resolveApiOrigin, resolveServerApiConfig, serverApiFetch } from '../chunk-C7TLGL3R.js';
 import '../chunk-MH2DSGC6.js';
-import '../chunk-S5G3A7OZ.js';
+import '../chunk-Q72M5KBS.js';
 import '../chunk-PKBMQBKP.js';

package/dist/shared/version.d.ts

@@ -7,4 +7,4 @@
  * it matches package.json at publish time, and version.test.ts asserts it in
  * dev, so it can't silently drift.
  */
-export declare const SITE_KIT_VERSION = "8.0.1";
+export declare const SITE_KIT_VERSION = "8.2.0";

package/dist/signal/index.js

@@ -1,6 +1,6 @@
 'use client';
-import { useSignalExperiment, useSignalEvent } from '../chunk-Z4MK4VOG.js';
-export { SignalBridge, useSignal, useSignalConfig, useSignalEvent, useSignalExperiment, useSignalOutcome } from '../chunk-Z4MK4VOG.js';
+import { useSignalExperiment, useSignalEvent } from '../chunk-WYZ4OUON.js';
+export { SignalBridge, useSignal, useSignalConfig, useSignalEvent, useSignalExperiment, useSignalOutcome } from '../chunk-WYZ4OUON.js';
 import '../chunk-PKBMQBKP.js';
 import React, { useEffect } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';

package/dist/sitemap/index.js

@@ -1,5 +1,5 @@
-export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-OE3NXEOF.js';
-import '../chunk-TZ5RTANX.js';
+export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-57K4GW3D.js';
+import '../chunk-WACWV5EP.js';
 import '../chunk-JIH32RH2.js';
 import '../chunk-Z22QVHT4.js';
 import '../chunk-L5UOHS6E.js';

package/dist/sync/index.js

@@ -1,7 +1,7 @@
-export { BookingWidget } from '../chunk-Z6PVFZRI.js';
-export { createBooking, createSlotHold, detectTimezone, fetchAvailability, fetchAvailableDates, fetchBookingTypeDetails, fetchBookingTypes, formatDate, formatDuration, formatTime, prepareMeeting, releaseSlotHold } from '../chunk-YGXWG54S.js';
+export { BookingWidget } from '../chunk-66G47P5C.js';
+export { createBooking, createSlotHold, detectTimezone, fetchAvailability, fetchAvailableDates, fetchBookingTypeDetails, fetchBookingTypes, formatDate, formatDuration, formatTime, prepareMeeting, releaseSlotHold } from '../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/website/images.js

@@ -1,6 +1,6 @@
-export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-6BXUSAOJ.js';
+export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-7FSB2EXS.js';
 export { ManagedFavicon, getManagedFaviconUrl } from '../chunk-GW7GSBO7.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/website/index.js

@@ -1,6 +1,6 @@
 'use client';
-export { SiteDesignReporter } from '../chunk-CAF53GKN.js';
-export { SITE_DESIGN_PATH, cleanFontStack, colorToHex, getSiteDesignTokens, measureSiteDesign, readDeclaredDesign, sendSiteDesign } from '../chunk-J6N5DCGW.js';
+export { SiteDesignReporter } from '../chunk-H4R2GPAB.js';
+export { SITE_DESIGN_PATH, cleanFontStack, colorToHex, getSiteDesignTokens, measureSiteDesign, readDeclaredDesign, sendSiteDesign } from '../chunk-WBC5B3JD.js';
 export { DEFAULT_POPUP_TOKENS, PopupBlocks } from '../chunk-BF7TZYC3.js';
 import '../chunk-IHG36STL.js';
 import '../chunk-YC7ELZS3.js';
@@ -8,7 +8,7 @@ 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/website/popups.js

@@ -1,5 +1,5 @@
 'use client';
-export { SitePopups } from '../chunk-NKFRW2VB.js';
+export { SitePopups } from '../chunk-JBEUZJS3.js';
 import '../chunk-27FISYK4.js';
 export { DEFAULT_POPUP_TOKENS, PopupBlocks } from '../chunk-BF7TZYC3.js';
 import '../chunk-IHG36STL.js';
@@ -11,7 +11,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/{writeLLMsTxt-UZGN6IBU.js → writeLLMsTxt-DGKLYXIW.js}

@@ -1,4 +1,4 @@
-export { writeLLMsTxtToPublic } from './chunk-TZ5RTANX.js';
+export { writeLLMsTxtToPublic } from './chunk-WACWV5EP.js';
 import './chunk-JIH32RH2.js';
 import './chunk-L5UOHS6E.js';
 import './chunk-WMVK77ND.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonordev/site-kit",
-  "version": "8.0.1",
+  "version": "8.2.0",
   "type": "module",
   "packageManager": "pnpm@11.5.3",
   "description": "The Sonor modules a Next.js site needs, from one package and one API key: SEO, analytics, forms, articles, chat, booking, AI visibility and agent tools. Selling online? Add @sonordev/commerce-kit.",

package/src/articles/README.md

@@ -326,3 +326,36 @@ Components use `.sk-article-*` and `.sk-article-list-*` classes. Import default
 ```
 
 Or use `unstyled` prop + `children` render prop for complete control.
+
+## Supporting photos (8.1)
+
+Sonor's article photo plan can attach up to eight supporting images to exact
+places in the article. The public response includes `editorial_photos`, an
+optional array of approved snapshots with `url`, `alt`, optional `caption`,
+`width`, `height`, and `placement`. Placement is `{ kind: 'after_intro' }` or
+`{ kind: 'after_heading', heading: 'Exact section heading' }`. Photo briefs,
+file ownership and private source notes stay in the authenticated API.
+
+The default `Article` renderer and the RSS/Atom generators apply these
+placements automatically. Custom publications use the same pure helper after
+converting Markdown to HTML and before rendering their content:
+
+```tsx
+import { insertArticlePhotos, articlePhotoCss } from '@sonordev/site-kit/articles/server-ui'
+
+const html = insertArticlePhotos(articleHtml, post.editorial_photos)
+// Render articlePhotoCss once and use html with your existing trusted-content policy.
+```
+
+The helper inserts a semantic figure after the introduction's first prose
+paragraph or a section's first prose paragraph. It preserves the surrounding
+HTML and includes intrinsic dimensions, descriptions, captions and lazy loading.
+It skips missing or duplicate headings, code examples, tables, existing figures,
+lists, and callouts. An image already in the body isn't inserted again. It
+doesn't sanitize the original article HTML; retain your existing content policy.
+Articles without this field render as before. Custom styles can target
+`.sk-article-photo` and `.sk-article-photo figcaption` or use `articlePhotoCss`.
+
+Agents managing photos use the authenticated Sonor article media tools. The
+site's public `get_article` MCP tool only reads the approved photo descriptions
+and placements; it can't attach photos or read planning briefs.