@sonordev/site-kit 8.0.0 → 8.1.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-IJQ767JS.js';
+import { fetchBookingTypes, fetchAvailability } from '../chunk-2JEUDTL6.js';
 import { getLLMsData, getServices, getFAQItems, getPageSummaries } from '../chunk-JIH32RH2.js';
-import { getFormConfig } from '../chunk-6QFINXLH.js';
-import '../chunk-PIX7FAMX.js';
+import { getFormConfig } from '../chunk-O4DETQJI.js';
+import '../chunk-JT52KYHQ.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-4Z3DI2EL.js';
+import '../chunk-2UO4HPGE.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-56VDS2RP.js';
-import '../chunk-ZLFGXKLG.js';
-import { SITE_KIT_VERSION } from '../chunk-5S2XDG5O.js';
+import '../chunk-WPOFTCKL.js';
+import '../chunk-F2VYN3QL.js';
+import { SITE_KIT_VERSION } from '../chunk-NWVB75ER.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-7YEEOIWI.js';
+import { createSeoRevalidationHandler } from '../chunk-V56RZH7J.js';
 import '../chunk-XTRZGXB2.js';
 export { SITE_CACHE_TAGS, SITE_REVALIDATE_PATH, isSiteRevalidatePong } from '../chunk-6KU7STM3.js';
-import '../chunk-5S2XDG5O.js';
+import '../chunk-NWVB75ER.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-56VDS2RP.js';
-import '../chunk-ZLFGXKLG.js';
-import '../chunk-5S2XDG5O.js';
+export { sonorFetch } from '../chunk-WPOFTCKL.js';
+import '../chunk-F2VYN3QL.js';
+import '../chunk-NWVB75ER.js';
 import '../chunk-PKBMQBKP.js';

package/dist/seo/client.js

@@ -1,10 +1,10 @@
 'use client';
-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/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-K22OLAPC.js';
+export { SitemapSync } from '../chunk-IAYGTQJD.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-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 { 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-AIDIEVPZ.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-7YEEOIWI.js';
+export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-V56RZH7J.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-GC2QWXJ3.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-5S2XDG5O.js';
+import '../chunk-NWVB75ER.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-OS2WBSLM.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-255NCCPB.js';
+import '../chunk-GC2QWXJ3.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-BQ2CXKTQ.js';
+export { resolveClientCredential } from '../chunk-47VB5INH.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-5S2XDG5O.js';
+import '../chunk-NWVB75ER.js';
 import '../chunk-PKBMQBKP.js';

package/dist/shared/import-specifiers.d.ts

@@ -1,20 +1,28 @@
 /**
  * The module specifiers a piece of code imports, and what an isomorphic entry
- * may not import: the one definition behind both the source-level boundary
- * checks (./boundary-graph.ts) and the built-chunk check
- * (scripts/kit-post-build.ts), which had each grown their own copy.
+ * may not import: the one definition behind the source-level boundary checks
+ * (./boundary-graph.ts), the built-chunk check (scripts/kit-post-build.ts),
+ * the doctor's import graph (./source-graph.ts) and sonor-setup's codemod,
+ * which had each grown their own copy.
  *
- * Test and build infrastructure: nothing ships from here (tsconfig.build.json
- * leaves it out of the declarations, and no entry reaches it).
+ * No site-kit entry reaches it. sonor-setup bundles it.
  *
- * Callers strip comments (and type-only imports, where erased imports don't
- * count) first; a comment that names an import is not an import.
+ * `importSpecifiers` reads code. A caller either strips comments first (and
+ * type-only imports, where erased imports don't count), or hands it
+ * `codeOnly(source, { syntax: codeSyntaxOf(file) })`, which also blanks the
+ * text of strings and of JSX elements, so an import written out inside a code
+ * sample isn't read as one.
  */
+export interface ImportSpecifierOptions {
+    /** Read `require()` calls too. */
+    require?: boolean;
+}
 /**
  * Every specifier `code` imports, in the order they appear, without a query or
- * hash a bundler would strip (`./server?raw` is `./server`).
+ * hash a bundler would strip (`./server?raw` is `./server`). With
+ * `{ require: true }`, the modules it requires as well.
  */
-export declare function importSpecifiers(code: string): string[];
+export declare function importSpecifiers(code: string, options?: ImportSpecifierOptions): string[];
 /**
  * A specifier an isomorphic entry's graph must not import: React, Next or
  * `server-only` (hooks, a client reference, or a hard error on the other
@@ -24,3 +32,43 @@ export declare function importSpecifiers(code: string): string[];
  * counts.
  */
 export declare function isNotIsomorphicSpecifier(spec: string): boolean;
+/**
+ * What `codeOnly` reads a file as. `js` is TypeScript or JavaScript with no
+ * JSX: in a `.ts` file `<T>(x: T) => x` is a generic, not an element. `jsx`
+ * also blanks the text of each JSX element, as it does a string's (`.tsx`,
+ * `.jsx`, `.js`). `mdx` reads only an MDX file's import and export blocks.
+ */
+export type CodeSyntax = 'js' | 'jsx' | 'mdx';
+export interface CodeOnlyOptions {
+    /** What the source is written in (`js` when not given). Pick it with `codeSyntaxOf`. */
+    syntax?: CodeSyntax;
+}
+/** The syntax `codeOnly` reads a file in, from its name. The one map from an extension to it. */
+export declare function codeSyntaxOf(filePath: string): CodeSyntax;
+/**
+ * `source` as a specifier reader should see it: comments blanked, and the text
+ * of every string, template and regular expression literal that can't be a
+ * module specifier blanked too. A blanked character becomes a space and line
+ * breaks stay, so a position in the result is the same position in `source`
+ * (a caller can match the result and edit `source` there).
+ *
+ * A specifier is one token, with no space, quote or backslash in it (and, in a
+ * template, no `${}`), so `'@sonordev/x'` in `import a from '@sonordev/x'`
+ * stays as written. A string that holds code as text, such as a code sample on
+ * a docs page (`` `import { A } from '@sonordev/x'` ``) or a JSX prop, reads
+ * as blank, and the import written out inside it isn't one.
+ *
+ * With `{ syntax: 'jsx' }` the text of a JSX element is blanked too, as a
+ * string's is: `<code>import A from '@sonordev/x'</code>` and a sentence that
+ * names a path import nothing, while code in the element's braces is read. A
+ * `<` is taken for an element only where a comparison can't stand (after
+ * `(`, `=`, `return`, `=>`...), and one that turns out not to be (a generic
+ * such as `<T,>(x: T) => x`, or a tag that never closes) is read again as
+ * code. With `{ syntax: 'mdx' }` only the import and export blocks are read.
+ *
+ * A lexer, not a parser. It tells a regular expression from a division by the
+ * code before the slash, ends a string at the end of its line, and reads a
+ * backtick that is never closed as a stray character. A file it can't fully
+ * follow (a syntax error) costs it a line, not the rest of the file.
+ */
+export declare function codeOnly(source: string, options?: CodeOnlyOptions): string;

package/dist/shared/source-graph.d.ts

@@ -51,7 +51,10 @@ export interface SourceGraphOptions {
     /** Stop after this many files in total. Default 300. */
     maxFiles?: number;
 }
-/** Every module specifier a file imports, exports from, or requires. */
+/**
+ * Every module specifier a file imports, exports from, or requires, once each.
+ * Read with ./import-specifiers, the one specifier reader in this repo.
+ */
 export declare function importSpecifiers(source: string): string[];
 /**
  * Read `entries` (absolute paths) and the local modules they import, entries

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.0";
+export declare const SITE_KIT_VERSION = "8.1.0";

package/dist/signal/index.js

@@ -1,6 +1,6 @@
 'use client';
-import { useSignalExperiment, useSignalEvent } from '../chunk-6ZXJ3SXR.js';
-export { SignalBridge, useSignal, useSignalConfig, useSignalEvent, useSignalExperiment, useSignalOutcome } from '../chunk-6ZXJ3SXR.js';
+import { useSignalExperiment, useSignalEvent } from '../chunk-DZV3KPVF.js';
+export { SignalBridge, useSignal, useSignalConfig, useSignalEvent, useSignalExperiment, useSignalOutcome } from '../chunk-DZV3KPVF.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-255NCCPB.js';
+import '../chunk-GC2QWXJ3.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-OGK7OL3T.js';
-export { createBooking, createSlotHold, detectTimezone, fetchAvailability, fetchAvailableDates, fetchBookingTypeDetails, fetchBookingTypes, formatDate, formatDuration, formatTime, prepareMeeting, releaseSlotHold } from '../chunk-IJQ767JS.js';
+export { BookingWidget } from '../chunk-55GHBRCN.js';
+export { createBooking, createSlotHold, detectTimezone, fetchAvailability, fetchAvailableDates, fetchBookingTypeDetails, fetchBookingTypes, formatDate, formatDuration, formatTime, prepareMeeting, releaseSlotHold } from '../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/website/images.js

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

@@ -1,6 +1,6 @@
 'use client';
-export { SiteDesignReporter } from '../chunk-ZHNQFNO3.js';
-export { SITE_DESIGN_PATH, cleanFontStack, colorToHex, getSiteDesignTokens, measureSiteDesign, readDeclaredDesign, sendSiteDesign } from '../chunk-KRBBH64S.js';
+export { SiteDesignReporter } from '../chunk-G2HCCWZQ.js';
+export { SITE_DESIGN_PATH, cleanFontStack, colorToHex, getSiteDesignTokens, measureSiteDesign, readDeclaredDesign, sendSiteDesign } from '../chunk-DSNCU2E3.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-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/website/popups.js

@@ -1,5 +1,5 @@
 'use client';
-export { SitePopups } from '../chunk-S7SSYGUJ.js';
+export { SitePopups } from '../chunk-LLW5HKEE.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-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/{writeLLMsTxt-UZGN6IBU.js → writeLLMsTxt-OS2WBSLM.js}

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

package/docs/MIGRATING-TO-8.md

@@ -52,7 +52,7 @@ It prints what it would change and writes nothing. When the diff looks right, ap
 npx sonor-setup codemod --only site-kit-8 --write
 ```
 
-The codemod needs sonor-setup 7.3.0 or later, and `npx` fetches the latest. It reads source files anywhere in the project (`pages/`, `hooks/` and `scripts/` count, not just `app/` and `src/`), but not `node_modules`, build output or `public/`. It rewrites your imports (the table below). When your code imports commerce, it also adds `@sonordev/commerce-kit` to package.json and raises site-kit's range to `^8.0.0`, and if `pnpm-workspace.yaml` lists site-kit under `minimumReleaseAgeExclude` it adds commerce-kit there too. Anything it can't rewrite safely it flags, with the fix, so you can finish those by hand: a `require()` of an old path (commerce-kit is ESM only, so that call needs an `import`), an import of a [removed](#what-was-removed) entry, or a `sonorMcpServer` whose `offerings` has no reader (see [The MCP change](#the-mcp-change)). Run it in the app's folder: in a monorepo, once per app that imports commerce, because it stops at a workspace root.
+The codemod needs sonor-setup 7.3.1 or later, and `npx` fetches the latest. It reads source files anywhere in the project (`pages/`, `hooks/` and `scripts/` count, not just `app/` and `src/`), but not `node_modules`, build output or `public/`. It rewrites your imports (the table below), and goes by imports only: a path that appears in a comment or inside a string, such as a code sample or a redirect table, is left as it is. When your code imports commerce, it also adds `@sonordev/commerce-kit` to package.json and raises site-kit's range to `^8.0.0`, and if `pnpm-workspace.yaml` lists site-kit under `minimumReleaseAgeExclude` it adds commerce-kit there too. Anything it can't rewrite safely it flags, with the fix, so you can finish those by hand: a `require()` of an old path (commerce-kit is ESM only, so that call needs an `import`), an import of a [removed](#what-was-removed) entry, or a `sonorMcpServer` whose `offerings` has no reader (see [The MCP change](#the-mcp-change)). Run it in the app's folder: in a monorepo, once per app that imports commerce, because it stops at a workspace root.
 
 `--check` is the gate: it exits 1 while a file needs rewriting and while a manual follow-up remains, so exit 0 means there's nothing left for you to do.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonordev/site-kit",
-  "version": "8.0.0",
+  "version": "8.1.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.",
@@ -372,7 +372,7 @@
     "typecheck": "tsc --noEmit",
     "typecheck:setup": "tsc --noEmit -p packages/sonor-setup/tsconfig.json",
     "version": "node scripts/sync-version.cjs && node scripts/gen-agent-manifest.cjs && git add src/shared/version.ts agent-manifest.json",
-    "prepublishOnly": "vitest run && tsc --noEmit -p packages/commerce-kit/tsconfig.json && rm -rf dist && NODE_OPTIONS=--max-old-space-size=8192 tsup && pnpm build:types && node scripts/gen-agent-manifest.cjs && node scripts/verify-dts.cjs && node scripts/verify-no-local-paths.cjs dist agent-manifest.json && node scripts/prepublish-integration.cjs && node scripts/audit-as-consumer.cjs && node scripts/verify-docs.cjs",
+    "prepublishOnly": "vitest run && tsc --noEmit -p packages/commerce-kit/tsconfig.json && rm -rf dist && NODE_OPTIONS=--max-old-space-size=8192 tsup && pnpm build:types && node scripts/gen-agent-manifest.cjs && node scripts/verify-dts.cjs && node scripts/verify-no-local-paths.cjs dist agent-manifest.json && node scripts/prepublish-integration.cjs && node scripts/audit-as-consumer.cjs && node scripts/verify-server-entries.cjs . && node scripts/verify-docs.cjs",
     "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly --noEmit false && node scripts/alias-dts.cjs",
     "verify:docs": "node scripts/verify-docs.cjs",
     "build:commerce": "node scripts/check-kit-build-order.cjs && NODE_OPTIONS=--max-old-space-size=8192 tsup --config packages/commerce-kit/tsup.config.ts && tsc -p packages/commerce-kit/tsconfig.build.json && node packages/commerce-kit/scripts/verify-dist.cjs && node packages/commerce-kit/scripts/verify-against-site-kit.cjs",
@@ -411,6 +411,7 @@
   "dependencies": {
     "engine.io-client": "^6.6.6",
     "marked": "^18.0.9",
+    "server-only": "^0.0.1",
     "socket.io-client": "^4.8.3",
     "socket.io-parser": "^4.2.7"
   },
@@ -442,7 +443,8 @@
     "tsup": "^8.5.1",
     "typescript": "^7.0.2",
     "vitest": "^4.1.10",
-    "web-vitals": "^6.1.0"
+    "web-vitals": "^6.1.0",
+    "yaml": "^2.9.1"
   },
   "keywords": [
     "sonor",

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.