@sonordev/site-kit 7.1.1 → 7.2.0

package/src/seo/README.md

@@ -143,6 +143,8 @@ It renders one `application/ld+json` script (an `@graph` when there's more than
 - a `BreadcrumbList` built from the path, when there isn't one already and the project has a site URL (skipped on `/`)
 - a speakable `WebPage` or `Article` node, when `speakable`, `pageName` and `pageUrl` are all set
 
+Everything Sonor supplies (its schema rows, `managed_schema` and the entity graph) loses any template placeholder first. A node whose values are a template's unfilled slots is dropped: a URL on a reserved example domain (`example.com`), a name like "Example" or "Your Business Name", a placeholder phone such as `+1-000-000-0000`, a slot like `[Resident Name]` or `{plan.name}`, or an object that's only a note about what goes there. Its real siblings and parents stay, so an `FAQPage` keeps its questions when only its publisher was a placeholder, and the `BreadcrumbList` fallback still applies when a placeholder breadcrumb is dropped. Your `additionalSchemas` are never touched. The rule is `@sonordev/contracts/schema-placeholders`.
+
 | Prop | Default | Notes |
 |------|---------|-------|
 | `path` | | Required. |
@@ -157,7 +159,7 @@ It's wrapped in `Suspense`, so the fetch never holds up the rest of the page. Th
 
 ### `<LLMSchema path>`
 
-Renders the page's `managed_llm_schema` as a `WebPage` JSON-LD script marked `data-llm-optimized="true"`, linked to the site's `WebSite` node when the project has a site URL. It renders nothing when the page has no LLM schema.
+Renders the page's `managed_llm_schema` as a `WebPage` JSON-LD script marked `data-llm-optimized="true"`, linked to the site's `WebSite` node when the project has a site URL. It renders nothing when the page has no LLM schema, or when that schema is a template placeholder (see `<ManagedSchema>`).
 
 ### Schema helpers
 
@@ -268,7 +270,7 @@ The SEO module keeps a few lower-level helpers:
 
 It skips itself when an `app/sitemap` route exists, and it only adds or updates pages unless you pass `--full-replace`.
 
-On a multi-site project, each page is tagged with the host it belongs to. The CLI takes it from `NEXT_PUBLIC_SITE_URL` (it loads `.env` and `.env.local`), or from `--site ohiopowerstudies.com`. It used to send no host at all, so a microsite's pages synced as unattributed.
+On a multi-site project, each page is tagged with the host it belongs to. The CLI takes it from `NEXT_PUBLIC_SITE_URL` (it loads `.env` and `.env.local`), or from `--site ohio.example.com`. It used to send no host at all, so a microsite's pages synced as unattributed.
 
 From code, `registerLocalSitemap({ entries?, autoDiscover?, mode?, site? })` on `@sonordev/site-kit/seo/server` does the same and is additive by default.
 

package/src/slots/README.md

@@ -10,7 +10,7 @@ import { ManagedSlot, ManagedRichText, ManagedLink, ManagedList } from '@sonorde
 
 <h1 className="hero-title">
   <ManagedSlot id="home-hero-headline" page="/">
-    New homes in Cincinnati and Northern Kentucky
+    New homes in Springfield and beyond
   </ManagedSlot>
 </h1>
 ```

package/src/sync/README.md

@@ -59,6 +59,16 @@ Expired meeting details and time reservations show a recovery action. Guests can
 
 Navigation is disabled while a reservation or booking request is running. Stale responses cannot reopen a previous step, and holds created after the widget is removed are released.
 
+## Accessibility
+
+Screen readers and AI agent browsers (which act on elements by their accessible names) can book without guessing:
+
+- **Days** are buttons named with the full date, year included: "Wednesday, October 7, 2026". The picked day is pressed (`aria-pressed="true"`), and days that can't be booked are disabled.
+- **Times** are buttons named with the time and the date, "10:30 AM, Wednesday, October 7, 2026", in the booking's time zone. They still show just the time. The picked time is pressed.
+- **Confirm**, the button that reserves the picked time, is named "Confirm 10:30 AM, Wednesday, October 7, 2026".
+
+Every name contains what its button shows (a time's and Confirm's start with it), so voice control can still target a button by its visible text (WCAG 2.5.3). None of this changes what the widget sends.
+
 ## API Functions
 
 ```ts

package/src/website/README.md

@@ -0,0 +1,133 @@
+# Popups and banners — `@sonordev/site-kit/website/popups`
+
+The popups, banners and toasts you publish in Sonor (Website → Popups &
+Banners), shown on your site where and when you set them, in the site's own
+design.
+
+## Usage
+
+`SiteKitLayout` mounts it for you, after the page goes idle:
+
+```tsx
+<SiteKitLayout>{children}</SiteKitLayout>                  // popups on (default)
+<SiteKitLayout popups={false}>{children}</SiteKitLayout>   // no popups
+```
+
+On a site without `SiteKitLayout`, mount `SitePopups` the same way:
+
+```tsx
+'use client'
+import { SitePopups } from '@sonordev/site-kit/website/popups'
+
+export function Popups() {
+  return <SitePopups />
+}
+```
+
+A project with nothing published costs one request and draws nothing. The
+renderer downloads only when a popup is about to open.
+
+## Props
+
+```ts
+interface SitePopupsProps {
+  apiUrl?: string          // Default: from SiteKitLayout, else https://api.sonor.io
+  apiKey?: string          // Default: from SiteKitLayout
+  zIndex?: number          // The layer popups, banners and toasts sit on. Default: 9999
+  allowInFrame?: boolean   // Show inside a cross-origin frame. Default: false
+  allowLocalhost?: boolean // Show on localhost. Default: false
+  debug?: boolean
+}
+```
+
+Through `SiteKitLayout`, `zIndex` comes from `chat={{ zIndex }}`, so the chat
+launcher and popups share one layer.
+
+## What shows
+
+Each popup is a set of blocks (heading, formatted text, image, button,
+divider) drawn in your site's design: its colors, fonts, radius and buttons.
+`SiteKitLayout` measures the design from the home page at idle and reports it
+to Sonor, so the popup builder previews popups the way they'll look. Its
+`design` prop declares any part of it yourself
+(`design={{ primary: 'var(--brand)', fontHeading: 'Fraunces, serif' }}`).
+
+| Placement | What it is |
+|-----------|------------|
+| Popup | Centred over a dimmed page. One at a time: a second waits until the first closes |
+| Banner | A bar along the top or bottom edge |
+| Toast | A small card in a corner (slide-in) |
+
+## Targeting and triggers
+
+All set in Sonor, no code changes:
+
+- **Pages**: include and exclude paths, with `*` for a prefix (`/services/*`)
+- **Devices**: desktop, mobile, tablet
+- **Schedule**: start and end dates
+- **Trigger**: immediately, after a delay, at a scroll depth, or on exit intent
+- **Frequency**: once, once per session, or every N days. Closing a popup and
+  pressing its button both count as seen.
+
+A popup targeted at one page leaves when the visitor navigates away from it.
+
+### Popups wait for forms
+
+A popup or toast that opens on its own first checks whether the visitor is in
+the middle of a form, and waits while they are. Mid-form means:
+
+- focus is in a form field, or in a card field embedded in a form;
+- a form has a field they've filled in and haven't sent yet;
+- a site-kit form is sending.
+
+It opens a moment after focus leaves the form, or once the form has been sent
+and cleared. It never gives up: while the visitor stays mid-form, it keeps
+waiting. Banners show at once, since they don't take focus or hide the page.
+
+Why it matters: a modal popup takes focus and hides the rest of the page from
+assistive technology while it's open. Opening one mid-form throws a person out
+of the field they're typing in, and an AI agent browser filling the form for
+someone (agents act on the accessibility tree) loses every field it was about
+to fill.
+
+## Accessibility
+
+Popups, toasts and banners are built so people and agent browsers can find
+them and their controls by name:
+
+- **A popup** is a modal dialog (`role="dialog"`, `aria-modal="true"`) named
+  by its heading. It takes focus when it opens, keeps Tab inside, closes on
+  Escape or a click outside it, and puts focus back where it was.
+- **A toast** is a named, non-modal dialog, and **a banner** is a named
+  region. Both close on Escape and leave focus where it is.
+- **Close buttons are named "Close"**, whatever they show.
+
+## Tracking
+
+Each popup's impression (once half of it is on screen) and button presses are
+counted in Sonor, against the same visitor ID (`_sk_vid`) analytics uses.
+
+## Drawing one popup yourself
+
+`PopupBlocks` is the renderer `SitePopups` uses, for drawing one popup from
+its blocks (a preview, a custom placement):
+
+```tsx
+import { PopupBlocks } from '@sonordev/site-kit/website/popups'
+
+<PopupBlocks
+  blocks={[{ type: 'heading', text: 'Spring cleanups are booking' }]}
+  placement="popup"
+  onClose={() => setOpen(false)}
+/>
+```
+
+`inline` renders it in place, without the overlay or focus handling.
+
+## Engage (retired)
+
+Engage was retired in Sonor, and its popups with it. Popups made in Engage
+Studio (a `design_json` without blocks) aren't drawn by site-kit 7.2 or later;
+make them again in Website → Popups & Banners. `@sonordev/site-kit/engage`
+still builds through 7.x: its `EngageWidget` draws `SitePopups` and the
+website chat.

package/dist/ChatWidget-JMFBXJ75.js

@@ -1,15 +0,0 @@
-export { ChatWidget, EchoChat, isChatEnabled } from './chunk-V4HUSHZO.js';
-import './chunk-JE4A5S4F.js';
-import './chunk-NDF4A5JM.js';
-import './chunk-6T6CQVNL.js';
-import './chunk-NEKEH4CK.js';
-import './chunk-AQSNPZY4.js';
-import './chunk-5SQK3D53.js';
-import './chunk-NJCTQH2P.js';
-import './chunk-S22FSH7C.js';
-import './chunk-L2V5PUFN.js';
-import './chunk-GJWI74ZZ.js';
-import './chunk-PXZ7LAOY.js';
-import './chunk-OUNRFXDC.js';
-import './chunk-6OL23QYD.js';
-import './chunk-PKBMQBKP.js';

package/dist/EngageWidget-A3QKZ3SU.js

@@ -1,11 +0,0 @@
-export { EngageWidget } from './chunk-B73QPZPH.js';
-import './chunk-NDF4A5JM.js';
-import './chunk-6T6CQVNL.js';
-import './chunk-24QZEO3Q.js';
-import './chunk-GJWI74ZZ.js';
-import './chunk-43OCZ3JA.js';
-import './chunk-EKBEOXTH.js';
-import './chunk-PXZ7LAOY.js';
-import './chunk-OUNRFXDC.js';
-import './chunk-6OL23QYD.js';
-import './chunk-PKBMQBKP.js';

package/dist/ManagedForm-2GSSDJPP.js

@@ -1,14 +0,0 @@
-export { ManagedForm } from './chunk-EQBZ24VH.js';
-import './chunk-JC7KXNNM.js';
-import './chunk-DXO6SBMD.js';
-import './chunk-QPEEKFCA.js';
-import './chunk-NEKEH4CK.js';
-import './chunk-AQSNPZY4.js';
-import './chunk-5SQK3D53.js';
-import './chunk-NJCTQH2P.js';
-import './chunk-L2V5PUFN.js';
-import './chunk-GJWI74ZZ.js';
-import './chunk-PXZ7LAOY.js';
-import './chunk-OUNRFXDC.js';
-import './chunk-6OL23QYD.js';
-import './chunk-PKBMQBKP.js';

package/dist/SitemapSync-4U654SEA.js

@@ -1,8 +0,0 @@
-export { SitemapSync } from './chunk-KOPVJQ2P.js';
-import './chunk-YVKRYQRG.js';
-import './chunk-43OCZ3JA.js';
-import './chunk-EKBEOXTH.js';
-import './chunk-PXZ7LAOY.js';
-import './chunk-OUNRFXDC.js';
-import './chunk-6OL23QYD.js';
-import './chunk-PKBMQBKP.js';