@sonordev/site-kit 8.5.2 → 8.7.0

package/dist/sitemap/index.js

@@ -1,11 +1,13 @@
-export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-IXA7ZB6U.js';
-import '../chunk-URZTBPZO.js';
-import '../chunk-XA7Q2VQA.js';
+export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-3MLWIBHX.js';
+import '../chunk-XZFOQ2V4.js';
+import '../chunk-EK7P62DT.js';
 import '../chunk-Z22QVHT4.js';
-import '../chunk-5D7ZISUP.js';
+import '../chunk-7DYMM6SS.js';
+import '../chunk-IBHBEUZV.js';
 import '../chunk-4K735O3J.js';
 import '../chunk-UAYAJPEP.js';
-import '../chunk-NZ4RXN3G.js';
+import '../chunk-XAZC2TUD.js';
+import '../chunk-ISRBSTB7.js';
 import '../chunk-MJP63SSS.js';
 import '../chunk-ZEGVKVD5.js';
 import '../chunk-YVKRYQRG.js';

package/dist/slots/index.js

@@ -1,7 +1,7 @@
-export { ManagedLink, ManagedList, ManagedRichText, ManagedSlot, SLOTS_CACHE_TAG, createSlotsRevalidateHandler, ManagedSlot_default as default, getSlot, renderSlotRichText, resolveSlots } from '../chunk-3RDJKIYO.js';
+export { ManagedLink, ManagedList, ManagedRichText, ManagedSlot, SLOTS_CACHE_TAG, createSlotsRevalidateHandler, ManagedSlot_default as default, getSlot, renderSlotRichText, resolveSlots } from '../chunk-2WDWQI7K.js';
 export { SLOTS_CONTRACT_VERSION, signSlotContent, slotSigningPayload, verifySlotContent } from '../chunk-VCJYLYJV.js';
 export { SLOT_CONTENT_MAX_LENGTH, SLOT_CONTENT_TYPES, SLOT_ID_PATTERN, SLOT_LIST_MAX_ITEMS, isSafeSlotHref, isValidSlotId, normalizeSlotValue, parseSlotRichText } from '../chunk-LPH5FANE.js';
-import '../chunk-6KU7STM3.js';
+import '../chunk-HY7ZEU2C.js';
 import '../chunk-C7TLGL3R.js';
 import '../chunk-MH2DSGC6.js';
 import '../chunk-PKBMQBKP.js';

package/dist/sync/index.js

@@ -1,9 +1,9 @@
-export { BookingWidget } from '../chunk-I4LMZNBN.js';
-export { createBooking, createSlotHold, detectTimezone, fetchAvailability, fetchAvailableDates, fetchBookingTypeDetails, fetchBookingTypes, formatDate, formatDuration, formatTime, prepareMeeting, releaseSlotHold } from '../chunk-5BRHTBPO.js';
+export { BookingWidget } from '../chunk-YYPYLYZM.js';
+export { createBooking, createSlotHold, detectTimezone, fetchAvailability, fetchAvailableDates, fetchBookingTypeDetails, fetchBookingTypes, formatDate, formatDuration, formatTime, prepareMeeting, releaseSlotHold } from '../chunk-DJIGFX33.js';
 import '../chunk-5ROTTMBL.js';
 import '../chunk-5TM3WPCI.js';
-import '../chunk-GDQKDL3E.js';
-import '../chunk-OEA7U4HJ.js';
+import '../chunk-UYOE3HA4.js';
+import '../chunk-P5PRR2BB.js';
 import '../chunk-W7OPEMGJ.js';
-import '../chunk-CFSIGEUW.js';
+import '../chunk-MNORERMF.js';
 import '../chunk-PKBMQBKP.js';

package/dist/website/contract.js

@@ -1,3 +1,4 @@
-export { DESIGN_TOKENS_VERSION, POPUP_BLOCK_LIMITS, POPUP_BLOCK_TYPES, designTokenCssVars, designTokensHash, isSafePopupUrl, mixHex, normalizeDesignTokens, normalizePopupBlocks, popupBlocksText, popupHtmlText, readableOn, sanitizePopupHtml, toHexColor } from '../chunk-IHG36STL.js';
+import '../chunk-XLAHRN4B.js';
+export { DESIGN_TOKENS_VERSION, POPUP_BLOCK_LIMITS, POPUP_BLOCK_TYPES, designTokenCssVars, designTokensHash, isSafePopupUrl, mixHex, normalizeDesignTokens, normalizePopupBlocks, popupBlocksText, popupHtmlText, readableOn, sanitizePopupHtml, toHexColor } from '../chunk-XHYE24HU.js';
 import '../chunk-S22FSH7C.js';
 import '../chunk-PKBMQBKP.js';

package/dist/website/images.js

@@ -1,6 +1,6 @@
-export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-Q4Y3WIHE.js';
+export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-HWQPCZOX.js';
 export { ManagedFavicon, getManagedFaviconUrl } from '../chunk-GW7GSBO7.js';
-import '../chunk-GDQKDL3E.js';
-import '../chunk-OEA7U4HJ.js';
-import '../chunk-CFSIGEUW.js';
+import '../chunk-UYOE3HA4.js';
+import '../chunk-P5PRR2BB.js';
+import '../chunk-MNORERMF.js';
 import '../chunk-PKBMQBKP.js';

package/dist/website/index.js

@@ -1,14 +1,15 @@
 'use client';
-export { SiteDesignReporter } from '../chunk-A7RZQI6H.js';
-export { SITE_DESIGN_PATH, cleanFontStack, colorToHex, getSiteDesignTokens, measureSiteDesign, readDeclaredDesign, sendSiteDesign } from '../chunk-7HRYSLY2.js';
-export { DEFAULT_POPUP_TOKENS, PopupBlocks } from '../chunk-BF7TZYC3.js';
-import '../chunk-IHG36STL.js';
+export { SiteDesignReporter } from '../chunk-XC2TWYDV.js';
+export { SITE_DESIGN_PATH, cleanFontStack, colorToHex, getSiteDesignTokens, measureSiteDesign, readDeclaredDesign, sendSiteDesign } from '../chunk-IXZBOOAD.js';
+export { DEFAULT_POPUP_TOKENS, PopupBlocks } from '../chunk-52KO4LKD.js';
+import '../chunk-XLAHRN4B.js';
+import '../chunk-XHYE24HU.js';
 import '../chunk-YC7ELZS3.js';
 import '../chunk-S22FSH7C.js';
-import '../chunk-DLM4FFNH.js';
-import '../chunk-EKBEOXTH.js';
-import '../chunk-GDQKDL3E.js';
-import '../chunk-OEA7U4HJ.js';
+import '../chunk-QTBAKOCZ.js';
+import '../chunk-VEJD5EJ2.js';
+import '../chunk-UYOE3HA4.js';
+import '../chunk-P5PRR2BB.js';
 import '../chunk-W7OPEMGJ.js';
-import '../chunk-CFSIGEUW.js';
+import '../chunk-MNORERMF.js';
 import '../chunk-PKBMQBKP.js';

package/dist/website/landing/server.js

@@ -1,3 +1,20 @@
-import '../../chunk-7ZWO5HDQ.js';
-export { landingPageMetadata, normalizeCampaignSlug } from '../../chunk-OSYCOC3K.js';
+export { FunnelPageContent, ManagedFunnelPage, getPublishedFunnelPage, managedFunnelMetadata } from '../../chunk-FXR5PJDL.js';
+import '../../chunk-PAYCK7FC.js';
+export { normalizeCampaignSlug } from '../../chunk-3MJNBOUO.js';
+export { landingPageMetadata } from '../../chunk-JESLPEST.js';
+import '../../chunk-XHYE24HU.js';
+import '../../chunk-DPYGC7WE.js';
+import '../../chunk-G5FD7UXK.js';
+import '../../chunk-C2FZBUSS.js';
+import '../../chunk-YC7ELZS3.js';
+import '../../chunk-VPZJ7ZTL.js';
+import '../../chunk-DXO6SBMD.js';
+import '../../chunk-CVADNHJ4.js';
+import '../../chunk-TYSIAWC3.js';
+import '../../chunk-HW7B43E5.js';
+import '../../chunk-NJCTQH2P.js';
+import '../../chunk-C7TLGL3R.js';
+import '../../chunk-MH2DSGC6.js';
+import '../../chunk-S22FSH7C.js';
+import '../../chunk-A4CC4ZG3.js';
 import '../../chunk-PKBMQBKP.js';

package/dist/website/landing.js

@@ -1,3 +1,5 @@
-export { LandingPage } from '../chunk-JJ4JS3LD.js';
-export { landingPageMetadata, normalizeCampaignSlug } from '../chunk-OSYCOC3K.js';
+import '../chunk-BTHEQDN4.js';
+export { LandingPage } from '../chunk-PAYCK7FC.js';
+export { normalizeCampaignSlug } from '../chunk-3MJNBOUO.js';
+export { landingPageMetadata } from '../chunk-JESLPEST.js';
 import '../chunk-PKBMQBKP.js';

package/dist/website/popups.js

@@ -1,17 +1,18 @@
 'use client';
-export { SitePopups } from '../chunk-24NM64IV.js';
+export { SitePopups } from '../chunk-U4OQJQK6.js';
 import '../chunk-27FISYK4.js';
-export { DEFAULT_POPUP_TOKENS, PopupBlocks } from '../chunk-BF7TZYC3.js';
-import '../chunk-IHG36STL.js';
+export { DEFAULT_POPUP_TOKENS, PopupBlocks } from '../chunk-52KO4LKD.js';
+import '../chunk-XLAHRN4B.js';
+import '../chunk-XHYE24HU.js';
 import '../chunk-5ROTTMBL.js';
 import '../chunk-S22FSH7C.js';
 import '../chunk-IPQKQEWI.js';
 import '../chunk-GJWI74ZZ.js';
 import '../chunk-5TM3WPCI.js';
-import '../chunk-DLM4FFNH.js';
-import '../chunk-EKBEOXTH.js';
-import '../chunk-GDQKDL3E.js';
-import '../chunk-OEA7U4HJ.js';
+import '../chunk-QTBAKOCZ.js';
+import '../chunk-VEJD5EJ2.js';
+import '../chunk-UYOE3HA4.js';
+import '../chunk-P5PRR2BB.js';
 import '../chunk-W7OPEMGJ.js';
-import '../chunk-CFSIGEUW.js';
+import '../chunk-MNORERMF.js';
 import '../chunk-PKBMQBKP.js';

package/dist/website/slots.js

@@ -1,7 +1,7 @@
-export { ManagedLink, ManagedList, ManagedRichText, ManagedSlot, SLOTS_CACHE_TAG, createSlotsRevalidateHandler, ManagedSlot_default as default, getSlot, renderSlotRichText, resolveSlots } from '../chunk-3RDJKIYO.js';
+export { ManagedLink, ManagedList, ManagedRichText, ManagedSlot, SLOTS_CACHE_TAG, createSlotsRevalidateHandler, ManagedSlot_default as default, getSlot, renderSlotRichText, resolveSlots } from '../chunk-2WDWQI7K.js';
 export { SLOTS_CONTRACT_VERSION, signSlotContent, slotSigningPayload, verifySlotContent } from '../chunk-VCJYLYJV.js';
 export { SLOT_CONTENT_MAX_LENGTH, SLOT_CONTENT_TYPES, SLOT_ID_PATTERN, SLOT_LIST_MAX_ITEMS, isSafeSlotHref, isValidSlotId, normalizeSlotValue, parseSlotRichText } from '../chunk-LPH5FANE.js';
-import '../chunk-6KU7STM3.js';
+import '../chunk-HY7ZEU2C.js';
 import '../chunk-C7TLGL3R.js';
 import '../chunk-MH2DSGC6.js';
 import '../chunk-PKBMQBKP.js';

package/dist/{writeLLMsTxt-BAK5XMRR.js → writeLLMsTxt-QN2HIVT4.js}

@@ -1,9 +1,11 @@
-export { writeLLMsTxtToPublic } from './chunk-URZTBPZO.js';
-import './chunk-XA7Q2VQA.js';
-import './chunk-5D7ZISUP.js';
+export { writeLLMsTxtToPublic } from './chunk-XZFOQ2V4.js';
+import './chunk-EK7P62DT.js';
+import './chunk-7DYMM6SS.js';
+import './chunk-IBHBEUZV.js';
 import './chunk-4K735O3J.js';
 import './chunk-UAYAJPEP.js';
-import './chunk-NZ4RXN3G.js';
+import './chunk-XAZC2TUD.js';
+import './chunk-ISRBSTB7.js';
 import './chunk-MJP63SSS.js';
 import './chunk-YVKRYQRG.js';
 import './chunk-FESKKJAS.js';

package/docs.json

@@ -76,6 +76,11 @@
           "slug": "og",
           "title": "OG cards",
           "file": "src/og/README.md"
+        },
+        {
+          "slug": "landing",
+          "title": "Managed landing pages",
+          "file": "src/landing/README.md"
         }
       ]
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonordev/site-kit",
-  "version": "8.5.2",
+  "version": "8.7.0",
   "type": "module",
   "packageManager": "pnpm@11.5.3",
   "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.",

package/src/analytics/README.md

@@ -168,7 +168,7 @@ interface AnalyticsConfig {
 - **Page views**: on every route change (path, URL, title, referrer, UTM params, device/browser/OS)
 - **Web Vitals**: LCP, CLS, TTFB, INP, FCP with good/needs-improvement/poor ratings
 - **Contact clicks**: `tel:` and `mailto:` links tracked as conversions, once `<ContactTracking />` is mounted (it isn't by default)
-- **DOM metadata**: full snapshot per page view (meta tags, H1, word count, links, content, FAQs)
+- **DOM metadata**: full snapshot per page view (meta tags, H1, word count, links, content, FAQs). The content text keeps the page's elements apart (a space after every block element and line break) and leaves out menus, form fields, buttons and dialogs, so a heading never runs into the paragraph after it
 
 ## Embedded pages report nothing (`analytics.allowInFrame`)
 

package/src/forms/README.md

@@ -313,6 +313,28 @@ tag, and add `autocompleteFor` to your controls for the autofill tokens.
 form can send a managed form, so `enhance={false}` only ever produced a form
 that silently went nowhere.
 
+## Private documents (8.6.0+)
+
+A managed `file` field with `validation.private_attachments: true` uses the
+private document control. Set `validation.max_files` from one to four. It
+accepts PDF, JPEG, PNG and WebP, up to 10 MB per file, with drag and drop,
+upload status, removal and retry. A required field stays unanswered until
+every selected file has uploaded successfully.
+
+This requires the Sonor API private attachment migration and endpoints plus
+the Sonor app's authorized document download controls. It never falls back
+to the public media upload endpoint. The server-rendered file control stays
+disabled until enhancement, so it can't accidentally use a public upload.
+Keep the private flag in `ServerForm`'s `initialConfig`; if configuration is
+unavailable, render a contact fallback instead of fetching an unmarked field.
+
+Uploads return signed, expiring grants. Submissions store private document
+references, and the Sonor app obtains short-lived download URLs only after
+checking access to the submission. Do not display those references as links.
+
+Date and file controls load on demand. They also finish loading when React
+Strict Mode restarts their effects during development.
+
 ## Styles
 
 ```tsx

package/src/landing/README.md

@@ -0,0 +1,64 @@
+# Managed landing pages
+
+Use the server entry for an opt-in managed landing route. The same bounded layout supports a newsletter signup, a requested guide or an inquiry. Page text renders on the server and follows the site's existing layout. Managed forms handle browser submission.
+
+First check your site's route inventory for `/f` collisions. Install this adapter only when the prefix is available, then verify the deployed route before enabling managed publication in Sonor. Existing-page funnels work independently of this adapter.
+
+```tsx
+// app/f/[slug]/page.tsx
+import { notFound } from 'next/navigation'
+import {
+  getPublishedFunnelPage,
+  managedFunnelMetadata,
+  ManagedFunnelPage,
+} from '@sonordev/site-kit/website/landing/server'
+
+const options = { site: 'example.com' } // Your registered site host.
+type PageProps = { params: Promise<{ slug: string }> }
+
+export async function generateMetadata({ params }: PageProps) {
+  const { slug } = await params
+  const page = await getPublishedFunnelPage(slug, options)
+  return page ? managedFunnelMetadata(page) : { robots: { index: false } }
+}
+
+export default async function Page({ params }: PageProps) {
+  const { slug } = await params
+  const page = await getPublishedFunnelPage(slug, options)
+  if (!page) notFound()
+  return <ManagedFunnelPage page={page} />
+}
+```
+
+Keep `SiteKitLayout` in your root layout and use its deferred analytics sibling. The adapter doesn't require analytics to submit a form. It reads the server credential through the existing server transport and requires an explicit registered site. Responses from another host or path are refused.
+
+Published-page reads use `no-store` in this version so an outdated or removed publication isn't served from the fetch cache. Keep the route dynamic and avoid wrapping this reader in a persistent cache. `managedFunnelMetadata` defaults to noindex, nofollow. Keep these campaign routes out of your sitemap.
+
+Use the normal revalidation route:
+
+```ts
+// app/api/seo-revalidate/route.ts
+export { POST } from '@sonordev/site-kit/revalidate'
+```
+
+Sonor can invalidate the exact published path and `SITE_CACHE_TAGS.funnels`. That refresh is distinct from installing and verifying the route.
+
+Private previews use the exact owner-authorized dashboard DTO. Pausing follow-ups retains the published landing page and independent form confirmations. `FunnelPageContent` from the server entry accepts `preview` and displays an inert form placeholder with a noindex and reporting-suppression marker. `ManagedFunnelPage preview` also skips form fetching. Serve private preview responses with `Cache-Control: no-store`; these components don't authorize requests or set HTTP headers. No public draft-token route is included.
+
+Content is limited to text paragraphs and bullet lists. Logos use resolved, validated asset URLs, colors and fonts use the shared brand contract, and the renderer accepts no stored HTML, scripts or CSS. If a full logo is missing, the verified display name appears. Theme variants, square marks and publisher attribution retain their separate roles.
+
+For developer-authored paid pages, the existing `LandingPage` component remains available from `@sonordev/site-kit/website/landing`. Import `landingPageMetadata` from the server entry. Campaign normalization now comes from the shared contracts package.
+
+## Record the installation
+
+An authorized repository owner completes this checklist once per site:
+
+1. Inventory the whole `/f` prefix, including routes, rewrites and dynamic route collisions.
+2. Install the adapter above and verify server-rendered content, form behavior, exact host binding, private preview isolation and mobile/desktop layouts for that source revision.
+3. Record the inventory digest, source revision, supported adapter version and named verification through the existing owner-authorized project settings path.
+
+The installation record lives at `projects.settings.managed_funnel_pages[normalizedOwnedHost]`. It contains `schemaVersion: 1`, `enabled`, `prefix: '/f'`, `adapterVersion`, `routeInventoryDigest`, `sourceRevision`, `verifiedAt`, `verifiedBy` and `provenance: 'owner_installation_attestation'`. The server attributes the actor and provenance. Use the adapter version supported by your Sonor installation. Each record belongs to one registered host.
+
+A draft or a browser report can't assert that the route is installed. This record describes an operator's installation check. Report a verified deployment and current live reachability separately when you've observed them. Publishing a funnel doesn't install the adapter.
+
+Disable the record before removing the adapter. For route, host or adapter changes, invalidate the old record, repeat the checks and replace its revision and digest. Sonor snapshots this installation evidence during preview and rechecks it at launch and public resolution. Existing-page funnels remain available when managed-page installation is missing.

package/src/llms/README.md

@@ -42,6 +42,7 @@ The GEO system uses a shared contract (`@sonordev/site-kit/llms/contract`) consu
 - **`LLM_GEO_CONTRACT_VERSION`** (currently `1`) — increment on breaking payload changes
 - **`LLMS_PUBLIC_SUMMARY_MAX_LENGTH`** (`400`) — max chars for page link notes
 - **Sanitizers** — `sanitizeLlmsPublicSummary()`, `sanitizeLlmsDisclaimerLine()`, `sanitizePrimaryLanguageTag()`, `pickManagedLlmSchemaForJsonLd()`
+- **Page notes, titles and order** — `pickLlmsPageDescription()`, `llmsPageListNote()`, `llmsPageTitle()`, `isLlmsListablePage()`, `selectLlmsPages()`, `groupLlmsPages()`, `cleanScrapedPageText()`, `stripContactDetails()`. The Sonor API and site-kit's local generator both build page lines through these, so a page reads the same wherever the file is built (see [What a page line says](#what-a-page-line-says)).
 
 See `LLM_GEO_CONTRACT.md` for the full spec.
 
@@ -337,8 +338,8 @@ export async function POST(request: Request) {
 ### How `generateLLMsTxt()` Works
 
 1. Fetches all data via `getLLMsData()` → `GET /api/public/llms/data`
-2. Optionally merges with local data (`getLocalData` callback) when Sonor returns empty
-3. Builds markdown sections in order: **Header → About → Services → Portfolio → Contact → FAQ → Pages → Optional → Full Context Link → Knowledge Graph → Topic Clusters → Custom Sections**
+2. Optionally merges with local data (`getLocalData` callback) when Sonor returns nothing, leaves services, FAQs or pages empty, or leaves the business's name, description, phone or address empty. The merge is field by field: a field Sonor fills wins, and a field Sonor leaves empty never deletes the value the site supplied
+3. Builds markdown sections in order: **Header → About → Contact → Services → Site Pages → Portfolio → FAQ → Full Context Link → Knowledge Graph → Topic Clusters → Custom Sections → Agent access → Optional**. The business and the contact block come first because they are short and answer the commonest question; the page index comes before the FAQ; `## Optional` is last because the spec lets a short-context reader stop there
 4. Portfolio, Entity, and Topic Cluster sections are fetched **in parallel** via `Promise.allSettled()`
 5. Returns `{ markdown, metadata }` where metadata includes `sections`, `attempted_sections`, and `failed_sections`
 
@@ -356,9 +357,27 @@ export async function POST(request: Request) {
 
 Business description...
 
+## Contact Information
+
+- **Phone:** 555-0100
+- **Email:** info@example.com
+- **Address:** 123 Main St, Springfield, OH 45501
+- **Hours:** Mon-Fri 8am-5pm
+
 ## Services
 
-- [Service Name](/services/slug): Brief description
+- [Service Name](https://example.com/services/slug): Brief description
+
+## Site Pages
+
+### Key pages
+
+- [Home](https://example.com/): Public-safe summary of the page content
+- [About](https://example.com/about): Learn about our team and mission
+
+### Services
+
+- [Furnace repair](https://example.com/services/furnace-repair): Same-day furnace repair in Springfield
 
 ## Portfolio & Case Studies
 
@@ -366,27 +385,12 @@ Business description...
 
 Description of the project.
 
-## Contact Information
-
-- **Phone:** 555-1234
-- **Email:** info@example.com
-- **Address:** 123 Main St, City, State
-
 ## Frequently Asked Questions
 
 ### How do you work?
 
 We follow a proven process...
 
-## Site Pages
-
-- [Home](https://example.com/): Public-safe summary of the page content
-- [About](https://example.com/about): Learn about our team and mission
-
-## Optional
-
-- [Privacy Policy](https://example.com/privacy): How we collect and use your information
-
 ## Full context
 
 - [llms-full.txt](https://example.com/llms-full.txt): Expanded index for large-context systems.
@@ -408,6 +412,10 @@ Service page: https://example.com/services/family-law
 Pillar: [Complete Guide to Family Law](/article/family-law-guide)
 - [How to File for Divorce](/article/filing-divorce) (Mar 15, 2026)
 - [Child Custody Laws](/article/custody-laws) (Mar 10, 2026)
+
+## Optional
+
+- [Privacy Policy](https://example.com/privacy): How we collect and use your information
 ```
 
 ### Configuration Options
@@ -433,7 +441,7 @@ generateLLMsTxt({
   // Spec features
   linkToFullLlms: true,                       // Append "Full context" section
   optionalPagePaths: ['/privacy', '/terms'],   // Moved from Site Pages to ## Optional
-  pageListNotesFromPublicSummaryOnly: false,   // Strict mode: no description fallback
+  pageListNotesFromPublicSummaryOnly: false,   // Strict mode: a note only from llms_public_summary
 
   // Overrides (take precedence over Sonor settings)
   headerPrimaryLanguage: 'en',
@@ -447,6 +455,30 @@ generateLLMsTxt({
 })
 ```
 
+### What a page line says
+
+Every `- [Title](url): note` line is built by the same rules, in `@sonordev/contracts/llms`, wherever the file is generated.
+
+**The note**, best source first (`pickLlmsPageDescription`):
+
+1. the page's `llms_public_summary`, written for this file. A phone number or an email address in it is taken out along with the "call" or "email us at" in front of it, and the rest is used. (A summary used to be thrown away whole, and the page fell back to its scrape.) A lead-in such as "This page covers" is dropped, so the note starts at what the page is about;
+2. the curated meta description (`managed_meta_description`);
+3. the meta description the page serves;
+4. the page's schema description;
+5. last, the page's scraped text, cleaned (`cleanScrapedPageText`): the whitespace between elements put back, form labels, menu items, cookie banners and button text dropped, contact details removed.
+
+Every note is cut at a sentence end or a word boundary, 500 characters at the most, and never mid-word. A note that only repeats the page's title, or whose text is an error page, is skipped. `pageListNotesFromPublicSummaryOnly` still limits notes to source 1.
+
+**The title** is the curated title, else the title the page serves, else its h1, each without its `| Brand` tail; the home page is the business name; a page with none of these is named from the last segment of its path ("Accounting" for `/features/accounting`). It is never the raw path.
+
+**Which pages are listed.** A page the last visit saw answer with an error, a page that asks search engines to leave it out (`noindex`), and a utility page (a cart, a thank-you page, a login) are left out, and each path is listed once.
+
+**Order and groups** (`groupLlmsPages`). The home page first, then the top-level pages by value (what the site does, where, the proof, who, the cost, contact), then one `###` group per section of the site (`/services/*` is "Services"), the biggest unlisted sections last, and the legal pages at the very end. A site of 12 pages or fewer is one list. When `maxPages` is smaller than the site, `selectLlmsPages` keeps every section represented, most valuable first, and the shorter list is always a subset of `llms-full.txt`.
+
+**Contact block.** Phone, email, one-line address and hours. A field with nothing in it is not printed, and a contact with nothing at all leaves the whole section out.
+
+**The first line** under the name is the tagline, else the first sentence of the description (not the text up to its first full stop, which cuts "Smith & Sons, Inc. is..." at "Inc").
+
 ### Optional pages
 
 `optionalPagePaths` demotes pages to `## Optional`, the section llmstxt.org lets a
@@ -465,7 +497,7 @@ const { markdown, metadata } = await generateLLMsTxt({})
 
 metadata.generated_at      // ISO timestamp
 metadata.project_id        // From API key
-metadata.sections          // ['header', 'about', 'services', 'faq', 'pages', ...]
+metadata.sections          // ['header', 'about', 'contact', 'services', 'pages', 'faq', ...]
 metadata.attempted_sections // ['portfolio', 'knowledge-graph', 'topic-clusters']
 metadata.failed_sections   // ['knowledge-graph'] — if entity API was unavailable
 ```

package/dist/FileField-F7BG4XAZ.js

@@ -1,83 +0,0 @@
-'use client';
-import { sonorFetch } from './chunk-GDQKDL3E.js';
-import './chunk-OEA7U4HJ.js';
-import { getClientApiConfig } from './chunk-W7OPEMGJ.js';
-import './chunk-CFSIGEUW.js';
-import './chunk-PKBMQBKP.js';
-import React from 'react';
-import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
-
-function FileField({
-  field,
-  inputId,
-  classPrefix,
-  baseInputStyle,
-  onChange
-}) {
-  const [status, setStatus] = React.useState("idle");
-  const [fileName, setFileName] = React.useState("");
-  const handleFile = async (e) => {
-    const file = e.target.files?.[0];
-    if (!file) return;
-    setFileName(file.name);
-    setStatus("uploading");
-    onChange("");
-    try {
-      const url = await uploadFormFile(file);
-      onChange(url);
-      setStatus("idle");
-    } catch (err) {
-      console.error("[Forms] File upload failed:", err);
-      onChange("");
-      setStatus("error");
-    }
-  };
-  return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsx(
-      "input",
-      {
-        id: inputId,
-        className: `${classPrefix}__input ${classPrefix}__input--file`,
-        type: "file",
-        name: field.slug,
-        required: field.is_required,
-        disabled: status === "uploading",
-        onChange: handleFile,
-        style: baseInputStyle
-      }
-    ),
-    status === "uploading" && /* @__PURE__ */ jsxs("p", { style: { color: "var(--sk-text-tertiary, #6b7280)", fontSize: 14, marginTop: 4 }, children: [
-      "Uploading ",
-      fileName,
-      "\u2026"
-    ] }),
-    status === "error" && /* @__PURE__ */ jsx("p", { role: "alert", style: { color: "var(--sk-error, #dc2626)", fontSize: 14, marginTop: 4 }, children: "Upload failed. Please choose the file again." })
-  ] });
-}
-async function uploadFormFile(file) {
-  const { apiUrl, apiKey } = getClientApiConfig();
-  if (!apiKey) {
-    throw new Error("API key is required to upload files.");
-  }
-  const body = new FormData();
-  body.append("file", file);
-  const response = await sonorFetch(
-    `${apiUrl}/api/public/forms/upload`,
-    {
-      method: "POST",
-      headers: { Authorization: `Bearer ${apiKey}` },
-      body
-    },
-    { retries: 1, timeoutMs: 6e4 }
-  );
-  if (!response.ok) {
-    throw new Error(`Upload failed (${response.status})`);
-  }
-  const data = await response.json().catch(() => null);
-  if (!data?.url) {
-    throw new Error("Upload did not return a URL.");
-  }
-  return data.url;
-}
-
-export { FileField };

package/dist/SiteChat-P4CRBRJZ.js

@@ -1,6 +0,0 @@
-export { SiteChat } from './chunk-ANVHRT35.js';
-import './chunk-27FISYK4.js';
-import './chunk-DLM4FFNH.js';
-import './chunk-EKBEOXTH.js';
-import './chunk-W7OPEMGJ.js';
-import './chunk-PKBMQBKP.js';

package/dist/SiteDesignReporter-QDVP4WMK.js

@@ -1,12 +0,0 @@
-export { SiteDesignReporter } from './chunk-A7RZQI6H.js';
-import './chunk-7HRYSLY2.js';
-import './chunk-IHG36STL.js';
-import './chunk-YC7ELZS3.js';
-import './chunk-S22FSH7C.js';
-import './chunk-DLM4FFNH.js';
-import './chunk-EKBEOXTH.js';
-import './chunk-GDQKDL3E.js';
-import './chunk-OEA7U4HJ.js';
-import './chunk-W7OPEMGJ.js';
-import './chunk-CFSIGEUW.js';
-import './chunk-PKBMQBKP.js';

package/dist/SitemapSync-5FBRDGHG.js

@@ -1,9 +0,0 @@
-export { SitemapSync } from './chunk-EQHGPB3J.js';
-import './chunk-YVKRYQRG.js';
-import './chunk-DLM4FFNH.js';
-import './chunk-EKBEOXTH.js';
-import './chunk-GDQKDL3E.js';
-import './chunk-OEA7U4HJ.js';
-import './chunk-W7OPEMGJ.js';
-import './chunk-CFSIGEUW.js';
-import './chunk-PKBMQBKP.js';

package/dist/article-tables-6XHVULPU.js

@@ -1,2 +0,0 @@
-export { articleTableCss, wrapArticleTables } from './chunk-E4PTMORJ.js';
-import './chunk-PKBMQBKP.js';