@sonordev/site-kit 8.2.0 → 8.4.0

package/dist/website/index.js

@@ -1,14 +1,14 @@
 'use client';
-export { SiteDesignReporter } from '../chunk-H4R2GPAB.js';
-export { SITE_DESIGN_PATH, cleanFontStack, colorToHex, getSiteDesignTokens, measureSiteDesign, readDeclaredDesign, sendSiteDesign } from '../chunk-WBC5B3JD.js';
+export { SiteDesignReporter } from '../chunk-PEI6DRSK.js';
+export { SITE_DESIGN_PATH, cleanFontStack, colorToHex, getSiteDesignTokens, measureSiteDesign, readDeclaredDesign, sendSiteDesign } from '../chunk-DKKYZLKR.js';
 export { DEFAULT_POPUP_TOKENS, PopupBlocks } from '../chunk-BF7TZYC3.js';
 import '../chunk-IHG36STL.js';
 import '../chunk-YC7ELZS3.js';
 import '../chunk-S22FSH7C.js';
-import '../chunk-CAH4Y4PY.js';
+import '../chunk-DLM4FFNH.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-3G7YABRA.js';
-import '../chunk-727R7C5R.js';
-import '../chunk-3EU6S5YC.js';
-import '../chunk-Q72M5KBS.js';
+import '../chunk-3VSFOD2Z.js';
+import '../chunk-RBNHRZGD.js';
+import '../chunk-W7OPEMGJ.js';
+import '../chunk-5S7YTOCB.js';
 import '../chunk-PKBMQBKP.js';

package/dist/website/popups.js

@@ -1,5 +1,5 @@
 'use client';
-export { SitePopups } from '../chunk-JBEUZJS3.js';
+export { SitePopups } from '../chunk-ITY4UZEJ.js';
 import '../chunk-27FISYK4.js';
 export { DEFAULT_POPUP_TOKENS, PopupBlocks } from '../chunk-BF7TZYC3.js';
 import '../chunk-IHG36STL.js';
@@ -8,10 +8,10 @@ import '../chunk-S22FSH7C.js';
 import '../chunk-ZKADJNR2.js';
 import '../chunk-5TM3WPCI.js';
 import '../chunk-GJWI74ZZ.js';
-import '../chunk-CAH4Y4PY.js';
+import '../chunk-DLM4FFNH.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-3G7YABRA.js';
-import '../chunk-727R7C5R.js';
-import '../chunk-3EU6S5YC.js';
-import '../chunk-Q72M5KBS.js';
+import '../chunk-3VSFOD2Z.js';
+import '../chunk-RBNHRZGD.js';
+import '../chunk-W7OPEMGJ.js';
+import '../chunk-5S7YTOCB.js';
 import '../chunk-PKBMQBKP.js';

package/dist/{writeLLMsTxt-DGKLYXIW.js → writeLLMsTxt-N4Y4YC2H.js}

@@ -1,12 +1,12 @@
-export { writeLLMsTxtToPublic } from './chunk-WACWV5EP.js';
-import './chunk-JIH32RH2.js';
-import './chunk-L5UOHS6E.js';
-import './chunk-WMVK77ND.js';
+export { writeLLMsTxtToPublic } from './chunk-CE7VPAEH.js';
+import './chunk-XA7Q2VQA.js';
+import './chunk-5D7ZISUP.js';
+import './chunk-4K735O3J.js';
 import './chunk-UAYAJPEP.js';
 import './chunk-NZ4RXN3G.js';
 import './chunk-MJP63SSS.js';
 import './chunk-YVKRYQRG.js';
 import './chunk-FESKKJAS.js';
 import './chunk-A4CC4ZG3.js';
-import './chunk-3G7YABRA.js';
+import './chunk-W7OPEMGJ.js';
 import './chunk-PKBMQBKP.js';

package/docs/MIGRATING-TO-PRESS-KIT.md

@@ -0,0 +1,83 @@
+# Moving articles to Press Kit
+
+`@sonordev/press-kit` owns Sonor's article and publication rendering, including
+Broadcast artwork and supporting photos. Site Kit continues to provide the
+site's layout, shared transport, SEO, analytics, forms, revalidation and MCP.
+Press Kit 1 requires Site Kit 8.3 or newer. There's still one `SONOR_API_KEY` in
+`.env.local`, and no new provider or project ID.
+
+Site Kit 8.x keeps its existing article imports as compatibility shims built
+from the same source. This is a package migration; it doesn't publish articles,
+schedule broadcasts, change URLs or change the project's visual rules.
+
+## Migrate an existing publication
+
+```bash
+npx sonor-setup@latest codemod --only press-kit --json
+npx sonor-setup@latest codemod --only press-kit --write --json
+pnpm install
+pnpm build
+npx sonor-setup verify --json
+```
+
+Use sonor-setup 7.4 or newer. `press-kit` selects only the article migration,
+using the same engine as the full codemod. The first command previews the diff. The second
+changes imports, adds Press Kit and raises the Site Kit floor to 8.3, preserving
+the existing range style. Commerce imports and dependencies remain unchanged. Use `--only site-kit-8`
+to migrate both article and commerce packages. Review
+reported manual follow-ups, especially dependency overrides and non-registry
+ranges. Use the site's package manager for install and build.
+
+| Use | Preferred import |
+|---|---|
+| Client components such as `TableOfContents`, `NewsletterWidget`, `ArticleViewTracker` | `@sonordev/press-kit/articles` |
+| Data, static params, metadata, feeds, sitemaps and photo placement helpers | `@sonordev/press-kit/articles/server` |
+| RSC components such as `Article`, `ArticleList`, `PublicationLayout` | `@sonordev/press-kit/articles/server-ui` |
+| Article types only | `@sonordev/press-kit` |
+
+Keep `SiteKitLayout` from `@sonordev/site-kit/layout`. Preserve the publication's
+existing routing object and `basePath`; replacing a package name doesn't mean
+renaming `/theforge`, `/news` or `/insights`.
+
+```tsx
+import { Article } from '@sonordev/press-kit/articles/server-ui'
+
+export default async function Story({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params
+  return <Article slug={slug} basePath="/news" />
+}
+```
+
+## Keep site MCP and live updates aligned
+
+New MCP scaffolds use Press Kit automatically. For an existing server, pass the
+same public readers the website uses; existing server files aren't overwritten
+by the CLI unless `--force` is passed.
+
+```ts
+import { sonorMcpServer } from '@sonordev/site-kit/mcp/sonor'
+import { getAllArticles, getArticle } from '@sonordev/press-kit/articles/server'
+
+export const mcpServer = sonorMcpServer({
+  businessName: 'Your business',
+  articles: { path: '/news', readMany: getAllArticles, readOne: getArticle },
+})
+```
+
+Both readers receive the configured sub-site. `list_articles` and `get_article`
+keep their existing names, public data and approved supporting photo descriptions.
+They don't expose private briefs or source file IDs. Sites without articles use
+`articles: false` (CLI: `--no-articles`) and don't need Press Kit.
+
+Keep the revalidation route in Site Kit:
+
+```ts
+import { createRevalidateRoute } from '@sonordev/site-kit/revalidate'
+export const POST = createRevalidateRoute({ publicationBasePath: '/news' })
+```
+
+The scaffold and doctor recognize either package's article imports, including
+local reader barrels. Check an article with supporting photos, the publication
+index, its feeds and site MCP locally before deploying. Photo assignments,
+descriptions, crops, stage rules and save/publish actions stay in Sonor; moving
+the website package doesn't add a second editorial workflow.

package/docs.json

@@ -2,65 +2,181 @@
   "$comment": "What sonor.dev renders for this package, in nav order. sonor.dev reads this file from the published tarball (latest on npm), so a release IS the docs deploy: add a page here and ship it in package.json `files`. scripts/verify-docs.cjs fails the publish if a listed file is missing from the pack.",
   "schemaVersion": 1,
   "title": "site-kit",
-  "summary": "One package, one env var, the Sonor modules a Next.js site needs: SEO, analytics, forms, articles, booking, chat, AI visibility, agent tools and motion. Commerce and memberships live in commerce-kit.",
+  "summary": "One API key for Sonor site infrastructure: SEO, analytics, forms, booking, chat, AI visibility, agent tools and motion. Publications live in Press Kit; commerce and memberships live in Commerce Kit.",
   "groups": [
     {
       "title": "Start here",
       "pages": [
-        { "slug": "", "title": "Overview", "file": "README.md" },
-        { "slug": "migrating-to-7", "title": "Migrating to 7", "file": "docs/MIGRATING-TO-7.md" },
-        { "slug": "migrating-to-8", "title": "Migrating to 8", "file": "docs/MIGRATING-TO-8.md" },
-        { "slug": "agents", "title": "For coding agents", "file": "AGENTS.md" }
+        {
+          "slug": "",
+          "title": "Overview",
+          "file": "README.md"
+        },
+        {
+          "slug": "migrating-to-7",
+          "title": "Migrating to 7",
+          "file": "docs/MIGRATING-TO-7.md"
+        },
+        {
+          "slug": "migrating-to-8",
+          "title": "Migrating to 8",
+          "file": "docs/MIGRATING-TO-8.md"
+        },
+        {
+          "slug": "migrating-to-press-kit",
+          "title": "Moving publications to Press Kit",
+          "file": "docs/MIGRATING-TO-PRESS-KIT.md"
+        },
+        {
+          "slug": "agents",
+          "title": "For coding agents",
+          "file": "AGENTS.md"
+        }
       ]
     },
     {
       "title": "Core",
       "pages": [
-        { "slug": "layout", "title": "Layout", "file": "src/layout/README.md" },
-        { "slug": "live-updates", "title": "Live updates", "file": "src/revalidate/README.md" },
-        { "slug": "seo", "title": "SEO", "file": "src/seo/README.md" },
-        { "slug": "analytics", "title": "Analytics", "file": "src/analytics/README.md" },
-        { "slug": "sitemap", "title": "Sitemap", "file": "src/sitemap/README.md" },
-        { "slug": "proxy", "title": "Proxy", "file": "src/proxy/README.md" },
-        { "slug": "redirects", "title": "Redirects", "file": "src/redirects/README.md" },
-        { "slug": "og", "title": "OG cards", "file": "src/og/README.md" }
+        {
+          "slug": "layout",
+          "title": "Layout",
+          "file": "src/layout/README.md"
+        },
+        {
+          "slug": "live-updates",
+          "title": "Live updates",
+          "file": "src/revalidate/README.md"
+        },
+        {
+          "slug": "seo",
+          "title": "SEO",
+          "file": "src/seo/README.md"
+        },
+        {
+          "slug": "analytics",
+          "title": "Analytics",
+          "file": "src/analytics/README.md"
+        },
+        {
+          "slug": "sitemap",
+          "title": "Sitemap",
+          "file": "src/sitemap/README.md"
+        },
+        {
+          "slug": "proxy",
+          "title": "Proxy",
+          "file": "src/proxy/README.md"
+        },
+        {
+          "slug": "redirects",
+          "title": "Redirects",
+          "file": "src/redirects/README.md"
+        },
+        {
+          "slug": "og",
+          "title": "OG cards",
+          "file": "src/og/README.md"
+        }
       ]
     },
     {
       "title": "Content",
       "pages": [
-        { "slug": "copy", "title": "Managed copy", "file": "src/slots/README.md" },
-        { "slug": "articles", "title": "Articles", "file": "src/articles/README.md" },
-        { "slug": "images", "title": "Images", "file": "src/images/README.md" },
-        { "slug": "reputation", "title": "Reputation", "file": "src/reputation/README.md" }
+        {
+          "slug": "copy",
+          "title": "Managed copy",
+          "file": "src/slots/README.md"
+        },
+        {
+          "slug": "articles",
+          "title": "Articles",
+          "file": "src/articles/README.md"
+        },
+        {
+          "slug": "images",
+          "title": "Images",
+          "file": "src/images/README.md"
+        },
+        {
+          "slug": "reputation",
+          "title": "Reputation",
+          "file": "src/reputation/README.md"
+        }
       ]
     },
     {
       "title": "Engagement",
       "pages": [
-        { "slug": "forms", "title": "Forms", "file": "src/forms/README.md" },
-        { "slug": "chat", "title": "Website chat", "file": "src/chat/README.md" },
-        { "slug": "popups", "title": "Popups and banners", "file": "src/website/README.md" },
-        { "slug": "cta-bar", "title": "CTA bar", "file": "src/cta-bar/README.md" },
-        { "slug": "booking", "title": "Booking", "file": "src/sync/README.md" },
-        { "slug": "signal", "title": "Signal (A/B)", "file": "src/signal/README.md" }
+        {
+          "slug": "forms",
+          "title": "Forms",
+          "file": "src/forms/README.md"
+        },
+        {
+          "slug": "chat",
+          "title": "Website chat",
+          "file": "src/chat/README.md"
+        },
+        {
+          "slug": "popups",
+          "title": "Popups and banners",
+          "file": "src/website/README.md"
+        },
+        {
+          "slug": "cta-bar",
+          "title": "CTA bar",
+          "file": "src/cta-bar/README.md"
+        },
+        {
+          "slug": "booking",
+          "title": "Booking",
+          "file": "src/sync/README.md"
+        },
+        {
+          "slug": "signal",
+          "title": "Signal (A/B)",
+          "file": "src/signal/README.md"
+        }
       ]
     },
     {
       "title": "AI visibility",
       "pages": [
-        { "slug": "llms", "title": "llms.txt and AEO", "file": "src/llms/README.md" },
-        { "slug": "mcp", "title": "MCP and agent tools", "file": "src/mcp/README.md" }
+        {
+          "slug": "llms",
+          "title": "llms.txt and AEO",
+          "file": "src/llms/README.md"
+        },
+        {
+          "slug": "mcp",
+          "title": "MCP and agent tools",
+          "file": "src/mcp/README.md"
+        }
       ]
     },
     {
       "title": "More",
       "pages": [
-        { "slug": "motion", "title": "Motion", "file": "src/motion/README.md" },
-        { "slug": "runtime", "title": "Building a kit", "file": "src/runtime/README.md" },
-        { "slug": "admin-auth", "title": "Sign in with Sonor", "file": "src/admin-auth/README.md" }
+        {
+          "slug": "motion",
+          "title": "Motion",
+          "file": "src/motion/README.md"
+        },
+        {
+          "slug": "runtime",
+          "title": "Building a kit",
+          "file": "src/runtime/README.md"
+        },
+        {
+          "slug": "admin-auth",
+          "title": "Sign in with Sonor",
+          "file": "src/admin-auth/README.md"
+        }
       ]
     }
   ],
-  "changelog": { "file": "CHANGELOG.md", "since": "7.0.0" }
+  "changelog": {
+    "file": "CHANGELOG.md",
+    "since": "7.0.0"
+  }
 }

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@sonordev/site-kit",
-  "version": "8.2.0",
+  "version": "8.4.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.",
+  "description": "Sonor's Next.js foundation: SEO, analytics, forms, chat, booking, AI visibility and agent tools. Add @sonordev/press-kit for publications or @sonordev/commerce-kit for selling. Legacy article imports remain compatible in 8.x.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -340,6 +340,10 @@
     "./landing/server": {
       "types": "./dist/landing/server.d.ts",
       "default": "./dist/landing/server.js"
+    },
+    "./shared": {
+      "types": "./dist/shared/index.d.ts",
+      "default": "./dist/shared/index.js"
     }
   },
   "files": [
@@ -352,7 +356,8 @@
     "CHANGELOG.md",
     "docs/MIGRATING-TO-7.md",
     "docs/MIGRATING-TO-8.md",
-    "src/*/README.md"
+    "src/*/README.md",
+    "docs/MIGRATING-TO-PRESS-KIT.md"
   ],
   "scripts": {
     "build": "NODE_OPTIONS=--max-old-space-size=8192 tsup && pnpm build:types && node scripts/gen-agent-manifest.cjs",
@@ -373,12 +378,16 @@
     "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-server-entries.cjs . && node scripts/verify-docs.cjs",
-    "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly --noEmit false && node scripts/alias-dts.cjs",
+    "build:types": "rm -rf .types-build && tsc -p tsconfig.build.json --emitDeclarationOnly --noEmit false && node scripts/relocate-compat-types.cjs && 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",
     "test:commerce": "vitest run packages/commerce-kit && tsc --noEmit -p packages/commerce-kit/tsconfig.json",
     "typecheck:commerce": "tsc --noEmit -p packages/commerce-kit/tsconfig.json",
-    "verify:docs:commerce": "node scripts/verify-docs.cjs packages/commerce-kit"
+    "verify:docs:commerce": "node scripts/verify-docs.cjs packages/commerce-kit",
+    "build:press": "node scripts/check-kit-build-order.cjs press && NODE_OPTIONS=--max-old-space-size=8192 tsup --config packages/press-kit/tsup.config.ts && tsc -p packages/press-kit/tsconfig.build.json && node packages/press-kit/scripts/verify-dist.cjs",
+    "test:press": "vitest run packages/press-kit && tsc --noEmit -p packages/press-kit/tsconfig.json",
+    "typecheck:press": "tsc --noEmit -p packages/press-kit/tsconfig.json",
+    "verify:docs:press": "node scripts/verify-docs.cjs packages/press-kit"
   },
   "peerDependencies": {
     "@vis.gl/react-google-maps": ">=1.0.0",
@@ -420,6 +429,7 @@
     "@babel/parser": "^8.0.4",
     "@babel/traverse": "^8.0.4",
     "@babel/types": "^8.0.4",
+    "@sonordev/contracts": "^2.7.0",
     "@types/babel__generator": "^7.27.0",
     "@types/babel__traverse": "^7.28.0",
     "@types/inquirer": "^9.0.10",